List connected agents

GET

/api/v1/agent-connections

curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/agent-connections \
  --header 'Authorization: <Authorization>'

Lists the active team’s live agent connections (AI agents signed in through OAuth): the client’s name, id and host, the person who connected it, when, and when it was last used. No tokens or secrets. A viewer sees only their own connections’ email addresses. Requires a signed-in person with any team role: API keys and agent tokens are refused with HUMAN_SESSION_REQUIRED.

Authorizations

• BearerAuth

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

Array<object>

object

client_host

ClientHost is the host of client_id (a CIMD URL); empty for a pre-registered id.

string

client_id

string

client_name

string

created_at

string

id

string

last_used_at

string

revoked

Revoked is always false in the list (it holds live connections only); kept so the shape does not change when revoked history is shown later.

boolean

user_email

UserEmail is the person’s current team address, falling back to the address at approval.

string

user_id

UserID is the Zitadel subject who approved the connection; the agent acts as them.

string

user_name

UserName is the person’s display name in the team, when they have one.

string

Example ^generated

{
  "data": [
    {
      "client_host": "example",
      "client_id": "example",
      "client_name": "example",
      "created_at": "example",
      "id": "example",
      "last_used_at": "example",
      "revoked": true,
      "user_email": "example",
      "user_id": "example",
      "user_name": "example"
    }
  ],
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

HUMAN_SESSION_REQUIRED or FORBIDDEN

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

500

Internal Server Error

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}