---
title: "Connected Agents"
method: GET
path: "/account/connected-agents"
tags: ["account"]
---

# Connected Agents

`GET /account/connected-agents`

## Request

- Base URL: `https://api.beatra.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.beatra.ai/account/connected-agents`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ConnectedAgentsResponse
  - `items` ConnectedAgentItem[], required
    - `installation_id` string, required
    - `platform` string, required
    - `client_name` string, required
    - `device_name` string, nullable
    - `platforms` string[]
    - `external_installation_ref` string, nullable
    - `status` 'connecting' | 'connected' | 'expired' | 'revoked' | 'disconnected', required
    - `connection_phase` 'connecting' | 'waiting', nullable
    - `installation_status` string, required
    - `scopes` string[]
    - `credential_count` integer, required
    - `active_credential_count` integer, required
    - `credential_status` 'issued' | 'active' | 'expired' | 'revoked' | 'superseded', nullable
    - `token_prefix` string, nullable
    - `issued_at` string, date-time, nullable
    - `idle_expires_at` string, date-time, nullable
    - `today_spend_credits` string, required
    - `total_spend_credits` string
    - `recent_tasks` ConnectedAgentRecentTask[]
      - `task_id` string, required
      - `capability` string, required
      - `model` string, nullable
      - `status` string, required
      - `error_code` string, nullable
      - `recovery_hint` string, nullable
      - `created_at` string, date-time, required
    - `skills` ConnectedAgentSkill[]
      - `package_slug` string, required
      - `display_name` string, nullable
      - `last_version` string, required
      - `platforms` string[]
      - `first_seen_at` string, date-time, required
      - `last_seen_at` string, date-time, required
    - `recovery_code` 'none' | 'await_first_use' | 'reauthorize_expired' | 'reauthorize_disconnected' | 'reauthorize_revoked', required
    - `recovery_command` string, nullable
    - `recovery_docs_url` string, nullable
    - `can_revoke` boolean, required
    - `device_kind` string
    - `installed_at` string, date-time, nullable
    - `last_used_at` string, date-time, nullable
    - `revoked_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)