Get a Composio account

GET

connected-accounts

{id}

curl --request GET \
  --url https://api.getarbol.com/v1/connected-accounts/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getarbol.com/v1/connected-accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "action": "reauthorize",
  "createdAt": "2026-08-29T14:30:00Z",
  "displayIdentity": "<string>",
  "id": "<string>",
  "integrationKey": "google-calendar",
  "label": "agenda-principal",
  "revision": 123,
  "status": "active",
  "updatedAt": "2026-08-29T14:30:00Z",
  "usage": {
    "assignmentCount": 4503599627370495
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "<string>",
  "data": {
    "issues": [
      {
        "code": "custom",
        "message": "<string>",
        "path": [
          "<string>"
        ]
      }
    ],
    "truncated": true
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "<string>",
  "data": {
    "missingPermissions": [
      "agents:read"
    ]
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "SERVICE_UNAVAILABLE",
  "status": 503,
  "message": "<string>",
  "data": {
    "code": "COMPOSIO_FAILURE",
    "message": "The integration operation could not be completed.",
    "retryable": false,
    "data": {
      "reason": "integration_tool_unavailable",
      "statusCode": 349
    }
  }
}

Authorizations

Authorization

string

header

required

Organization-scoped Auth0 user access token issued to an approved first-party client or exchanged by a trusted OBO resource server.

Path Parameters

string

required

Opaque identifier issued by an external authority; consumers compare it but do not interpret it.

Required string length: 1 - 256

Query Parameters

expand

enum<string>[]

Maximum array length: 1

Available options:

usage

Response

action

enum<string> | null

required

Available options:

reauthorize

createdAt

string<date-time>

required

ISO 8601 timestamp with an explicit UTC offset.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Example:

"2026-08-29T14:30:00Z"

displayIdentity

string | null

required

Maximum string length: 320

string

required

Opaque identifier issued by an external authority; consumers compare it but do not interpret it.

Required string length: 1 - 256

integrationKey

string

required

Stable provider-neutral key for a live-discovered business integration.

Required string length: 1 - 120

Pattern: ^[a-z0-9][a-z0-9.-]*$

Example:

"google-calendar"

label

string

required

Customer-managed account label, unique within one organization and integration.

Required string length: 1 - 120

Example:

"agenda-principal"

revision

integer

required

Required range: x <= 9007199254740991

status

enum<string>

required

Customer-visible authorization lifecycle of a connected account.

Available options:

pending,

active,

actionRequired,

disabled,

revoked

Example:

"active"

updatedAt

string<date-time>

required

ISO 8601 timestamp with an explicit UTC offset.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Example:

"2026-08-29T14:30:00Z"

usage

Connected account usage · object

Number of Agent and personal tool-access entries that reference the account.

Show child attributes

⌘I

Get a Composio account

curl --request GET \
  --url https://api.getarbol.com/v1/connected-accounts/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getarbol.com/v1/connected-accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "action": "reauthorize",
  "createdAt": "2026-08-29T14:30:00Z",
  "displayIdentity": "<string>",
  "id": "<string>",
  "integrationKey": "google-calendar",
  "label": "agenda-principal",
  "revision": 123,
  "status": "active",
  "updatedAt": "2026-08-29T14:30:00Z",
  "usage": {
    "assignmentCount": 4503599627370495
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "<string>",
  "data": {
    "issues": [
      {
        "code": "custom",
        "message": "<string>",
        "path": [
          "<string>"
        ]
      }
    ],
    "truncated": true
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "<string>",
  "data": {
    "missingPermissions": [
      "agents:read"
    ]
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "SERVICE_UNAVAILABLE",
  "status": 503,
  "message": "<string>",
  "data": {
    "code": "COMPOSIO_FAILURE",
    "message": "The integration operation could not be completed.",
    "retryable": false,
    "data": {
      "reason": "integration_tool_unavailable",
      "statusCode": 349
    }
  }
}

Overview

Endpoints

Get a Composio account

Authorizations

Path Parameters

Query Parameters

Response