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

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.

CapabilityOwnerAdminDeveloper
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 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.