Skip to main content
POST
Share an existing credential with a workspace agent

Authorizations

Authorization
string
header
required

Account API key: key id as the username, secret as the password.

Path Parameters

workspace_agent_id
string<uuid>
required

Body

application/json
auth_config_id
string<uuid>
required
credentials_id
string<uuid>
required

Response

Successful response

id
string<uuid>
created_at
string<date-time>
updated_at
string<date-time>
auth_config_id
string<uuid>

Integration auth config this row applies to

created_by_id
string<uuid>

The user or API key that granted this credential to the agent.

target_id
string<uuid>

Workspace agent install receiving the credential; the association is scoped to this install's workspace. Account-wide availability is plain credential ownership with no association row.

kind
enum<string>

GRANTED = existing credential shared with the agent; CONNECTED = credential created for the agent (connect flow).

Available options:
CONNECTED,
GRANTED
credentials_id
string<uuid> | null

Linked credential row; null while OAuth connect is pending.

integration
any
member_owned
any
owner
any
workspace
any
workspace_agent_id
any