Get the activity feed for an agent

Activity feed of agent interactions, errors, lifecycle and config changes, conversations, artifacts, ratings, access changes, and share events. Backed by Elasticsearch.

GET /v1/activity

Get the activity feed for an agent

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/activity \
  --header 'Authorization: Bearer <token>'

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

fetch('https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/activity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/activity"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "items": [
    {
      "id": "<string>",
      "type": "<string>",
      "group": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "correlationId": "<string>",
      "userId": "<string>",
      "agent_id": "<string>",
      "data": {}
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Query Parameters

agent_id · string · required

Agent identifier (required).

Maximum string length: 64

groups · string

Comma-separated list of activity groups (message, error, agent_lifecycle, conversation, artifact, rating, access, share).

Maximum string length: 256

since · string

ISO timestamp lower bound.

Maximum string length: 64

until · string

ISO timestamp upper bound.

Maximum string length: 64

correlationId · string

Filter by correlationId to trace a single workflow.

Maximum string length: 128

limit · string

Page size (default 25).

page · string

Page number (1-indexed, default 1).

Response

200

application/json

Page of activity items.

items · object[]

Hide child attributes

items. id · string

items. type · string

items. group · string

items. timestamp · string<date-time>

items. correlationId · string

items. userId · string

items. agent_id · string

items. data · object

Sanitized event payload (sensitive fields stripped).

total · integer

page · integer

limit · integer