Skip to main content
GET
/
v1
/
agents
List agents in the org
curl --request GET \
  --url https://api.runtools.ai/v1/agents \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "<string>",
      "name": "<string>",
      "description": "<string>",
      "color": "<string>",
      "avatarSeed": "<string>",
      "avatarImageUrl": "<string>",
      "model": "claude-sonnet-4",
      "executionMode": "in_sandbox",
      "visibility": "private",
      "systemPrompt": "<string>",
      "toolsJson": [
        "<string>"
      ],
      "sandboxId": "<string>",
      "sandboxSlug": "<string>",
      "targetDeviceId": "<string>",
      "status": "draft",
      "configJson": {},
      "providerOptions": {},
      "envJson": {},
      "attachedResources": [
        {
          "type": "workspace",
          "resourceId": "<string>",
          "alias": "<string>",
          "config": {}
        }
      ],
      "version": 123,
      "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ownerDisplayName": "<string>",
      "ownerEmail": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.runtools.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

WorkOS session token or RunTools API key (rt_live_* / rt_test_*). Used in Authorization: Bearer <token> header.

Query Parameters

​
all
boolean

Include resources for all members of the org (admin only).

Response

200 - application/json

Agents.

​
data
object[]