Sign in
toolkits

List toolkits

List all toolkits with metadata summary.

Returns all toolkits visible to the caller with key counts and bound credential counts. Admin users see all toolkits. Agents see only their own toolkit.

Each toolkit includes:

  • Metadata (name, description, disabled state, simulation mode)
  • Active key count (revoked keys excluded)
  • Bound credential count (upstream API credentials available to this toolkit)

The default toolkit implicitly has access to all credentials without explicit binding.

get/toolkits

Response

Successful Response

idstring required

Toolkit ID

namestring required

Human-readable toolkit name

descriptionstring nullable

Optional description of this toolkit's purpose

created_atnumber nullable

Unix timestamp when created

disabledboolean

If true, all API keys for this toolkit are revoked

key_countinteger nullable

Number of API keys issued for this toolkit

credential_countinteger nullable

Number of credentials bound to this toolkit

permissionsobject[]

Access control rules for this toolkit

Example response

[
  {
    "id": "default",
    "name": "Default Toolkit",
    "description": "Default toolkit for general-purpose API access",
    "created_at": 1672531200,
    "key_count": 3,
    "credential_count": 5,
    "keys": [],
    "credentials": [],
    "permissions": [
      {
        "effect": "allow",
        "methods": [
          "GET"
        ]
      }
    ]
  }
]

Changes