List what a connected agent did

GET

/api/v1/agent-connections/{id}/activity

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

Returns one of the active team’s agent connections’ requests, newest first, 50 per page, from the agent audit log, which keeps 90 days. Refused and failed requests are included. Events have the same shape as API key activity: a ready-made lowercase phrase (“created a deployment of {project}”, or “tried to …” when outcome is refused or failed), where {project} appears only when project is non-null; path is the route pattern, never a concrete URL. Pass next_cursor back as cursor for older events; it is null on the last page. A revoked connection’s activity stays readable until its row is swept. Requires a signed-in person with the member role: API keys and agent tokens are refused with HUMAN_SESSION_REQUIRED.

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Agent connection ID (UUID)

Query Parameters

cursor

string

Next_cursor from the previous page

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

events

Events are newest first; never null.

Array<object>

object

client

Client is the client the request claimed to come from (unverified); null when it named none.

string

Allowed values: dashboard cli mcp migrate

created_at

CreatedAt is when the request was made, in UTC.

string

id

string

method

string

outcome

Outcome is “done” below 400, “refused” for 4xx and “failed” for 5xx.

string

Allowed values: done refused failed

path

Path is the route pattern (“/api/v1/projects/:id”), never a concrete URL. Empty when the stored path is not a known pattern.

string

phrase

Phrase is lowercase-first plain English: “created a deployment of {project}”, or “tried to create a deployment of {project}” when the request was refused or failed. It holds “{project}” if and only if project is non-null; render the name there.

string

project

Project is the project the request acted on; null when unknown or deleted.

object

id

string

name

string

status_code

integer

next_cursor

NextCursor fetches the next (older) page; null on the last page.

string

Example

{
  "data": {
    "events": [
      {
        "client": "dashboard",
        "method": "POST",
        "outcome": "done",
        "path": "/api/v1/deployments",
        "phrase": "created a deployment of {project}",
        "status_code": 201
      }
    ]
  }
}

400

INVALID_INPUT

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"
  }
}

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"
  }
}

404

AGENT_CONNECTION_NOT_FOUND

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"
  }
}