---
title: "Returns a custom agent's connection configuration for the current user."
method: GET
path: "/agents/{agentId}/configuration"
tags: ["customAgents"]
---

# Returns a custom agent's connection configuration for the current user.

`GET /agents/{agentId}/configuration`

Returns the linked connector and skill ids, the account selected for each connector,
            why that account was selected, and whether it is available.
            Uses a saved agent choice, or the enabled awork Agent default when no choice is saved.
            An editor-provided account is used when the connector has specificConnection mode.
            API-key requests do not inherit awork Agent defaults.
            This read does not save or change any choices.
            <Check title="Required Permissions" icon="key">The user must have read access to the agent.</Check>

## Path parameters

- `agentId` string, uuid, required

## Response `200`

OK

- CustomAgentConfigurationResponseModel — The current user's configuration for one custom agent: linked capabilities and an account choice for each connector. Reading this response does not save any choices.
  - `agentId` string, uuid — The custom agent identifier.
  - `enabledConnectorIds` string[], nullable — The ids of connectors linked to this agent. A linked connector may still need a working account.
  - `enabledSkillIds` string[], nullable — The ids of skills linked to this agent.
  - `connectorConnections` CustomAgentConnectorConfigurationModel[], nullable — One entry per linked connector, with this user's account choice, its source, and its availability.
    - `connectorId` string, uuid — The linked connector identifier.
    - `selectedConnectionId` string, uuid, nullable — The account this user explicitly chose for this agent and connector; null when no choice is saved.
    - `defaultConnectionId` string, uuid, nullable — The account the agent would try to use after applying the selection rules; null when none is selected. This may be a saved choice, an awork Agent default, or an editor-provided account. Check Status before treating the account as available.
    - `connectionSource` string, nullable — Why the account was selected: userSelection is this user's saved agent choice; personalDefault is their enabled awork Agent default; specificConnection is the editor-provided account; none means no account was selected.
    - `status` string, nullable — The account's availability: pending, connected, authRequired, error, or suspended. Missing means no account could be selected. Inaccessible means the user cannot use the connector or account.

## Other responses

- `401` — Unauthorized
- `404` — Not Found

## Changes

- **2026-09-20** `5332322ffca3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/awork-io/apis/api-v1-reference/changes/agents/:agentId/configuration/get.md)

---

[API](https://skmtc.dev/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.dev/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/awork-io/apis/api-v1-reference/revisions/eadefd26df12?raw)