Account Management

Retrieve account details, team information, API keys, and usage statistics for your organization using the account management API.

Introduction

The accountManagement task provides programmatic access to your organization's account information, including team members, API keys, balance, and usage statistics. This is useful for building internal dashboards or monitoring tools that integrate with your Runware account.

Currently, only the getDetails operation is available. Additional operations for managing settings, team members, and API keys will be added in future updates.

Request

The Runware API always accepts an array of objects as input, where each object represents a specific task to be performed. The structure of the object varies depending on the type of the task. For this section, we will focus on the parameters related to the account management task.

The following JSON snippet shows the basic structure of a request object.

import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const result = await client.accountManagement({
  operation: 'getDetails'
})

import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        result = await client.account_management({
            "operation": "getDetails"
        })


asyncio.run(main())

curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "accountManagement",
      "taskUUID": "f4dd3dfe-955f-49d5-a785-7e3b633d6e7a",
      "operation": "getDetails"
    }
  ]'

runware account details

{
  "taskType": "accountManagement",
  "taskUUID": "f4dd3dfe-955f-49d5-a785-7e3b633d6e7a",
  "operation": "getDetails"
}

taskType stringrequiredvalue: accountManagement: Identifier for the type of task being performed

taskUUID stringrequiredUUID v4: UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

operation stringrequired: The specific account management operation to perform.
Allowed values1 value

Response

Results will be delivered in the format below.

{
  "data": [
    {
      "taskType": "accountManagement",
      "taskUUID": "f4dd3dfe-955f-49d5-a785-7e3b633d6e7a",
      "operation": "getDetails",
      "organizationUUID": "a6379343-9ff2-46a0-996b-e4a7b3057c88",
      "organizationName": "Acme Corporation",
      "AIRSource": "acme",
      "balance": 2450.75,
      "team": [
        {
          "name": "John Smith",
          "email": "john.smith@acme.com",
          "roles": [
            "Owner"
          ],
          "joinedAt": "2024-01-15T10:30:00Z"
        },
        {
          "name": "Emily Johnson",
          "email": "emily.johnson@acme.com",
          "roles": [
            "Admin"
          ],
          "joinedAt": "2024-03-22T14:20:00Z"
        },
        {
          "name": "Michael Chen",
          "email": "michael.chen@acme.com",
          "roles": [
            "Developer"
          ],
          "joinedAt": "2024-05-10T09:15:00Z"
        }
      ],
      "apiKeys": [
        {
          "name": "Production API Key",
          "apiKey": "YHluz4gk5KU4ZZWr****************",
          "description": "Main production environment key",
          "createdAt": "2024-01-20T11:00:00Z",
          "enabled": true,
          "requests": 15420,
          "lastUsedAt": "2025-10-12T08:45:30Z"
        },
        {
          "name": "Development API Key",
          "apiKey": "fhVbIFjuDlSwZJgY****************",
          "description": "Testing and development",
          "createdAt": "2024-02-05T16:30:00Z",
          "enabled": true,
          "requests": 3287,
          "lastUsedAt": "2025-10-11T15:22:18Z"
        }
      ],
      "usage": {
        "total": {
          "credits": 48920.50,
          "requests": 2540318
        },
        "today": {
          "credits": 35.80,
          "requests": 1850
        },
        "last7Days": {
          "credits": 412.25,
          "requests": 21400
        },
        "last30Days": {
          "credits": 1685.90,
          "requests": 87560
        }
      }
    }
  ]
}

taskType stringrequiredvalue: accountManagement: Identifier for the type of task this response belongs to.

taskUUID stringrequiredUUID v4: UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

organizationName stringrequired: The name of the organization.

organizationUUID stringrequiredUUID v4: Unique identifier for the organization.

balance objectrequired

Current account balance and currency.

Properties3 properties

balance » amount amount floatrequired: Current balance amount.

balance » freeBalance freeBalance float: Available free credit balance.

balance » currency currency stringrequired: Currency code (e.g., USD).

team array of objectsrequired

List of team members.

Properties4 properties

team » name name stringrequired: Full name of the team member.

team » email email stringrequiredEMAIL: Email address of the team member.

team » roles roles array of stringsrequired

Each team member is assigned a role that determines their level of access within the organization.

Capability	Owner	Admin	Developer
API generation and Playground	✓	✓	✓
Manage Playground workflows	✓	✓	✓
Create and manage API keys	✓	✓
View API logs and usage analytics	✓	✓
Manage billing and payment methods	✓	✓
Invite and remove team members	✓	✓
Assign Admin and Developer roles	✓	✓
Assign Owner role	✓
Delete organization	✓

team » joinedAt joinedAt stringDATE-TIME: Date and time when the member joined.

apiKeys array of objectsrequired

List of API keys associated with the account.

Properties7 properties

apiKeys » apiKey apiKey stringrequired: The API key string (partially masked).

apiKeys » name name stringrequired: Name or label for the API key.

apiKeys » description description string: Description of the API key.

apiKeys » enabled enabled booleanrequired: Whether the API key is active.

apiKeys » createdAt createdAt stringrequiredDATE-TIME: Date and time when the key was created.

apiKeys » lastUsedAt lastUsedAt stringDATE-TIME: Date and time when the key was last used.

apiKeys » requests requests integer: Total number of requests made with this key.

usage objectrequired

Usage statistics for different time periods.

Properties4 properties

usage » today today objectrequired

Usage stats for today.

Properties2 properties

usage » today » credits credits floatrequired: Total credits consumed.

usage » today » requests requests integerrequired: Total API requests made.

usage » last7Days last7Days objectrequired

Usage stats for the last 7 days.

Properties2 properties

usage » last7Days » credits credits floatrequired: Total credits consumed.

usage » last7Days » requests requests integerrequired: Total API requests made.

usage » last30Days last30Days objectrequired

Usage stats for the last 30 days.

Properties2 properties

usage » last30Days » credits credits floatrequired: Total credits consumed.

usage » last30Days » requests requests integerrequired: Total API requests made.

usage » total total objectrequired

Total lifetime usage stats.

Properties2 properties

usage » total » credits credits floatrequired: Total credits consumed.

usage » total » requests requests integerrequired: Total API requests made.