List agent activity

GET

/api/v3/agents/activity

curl --request GET \
  --url 'https://api.tryletterhead.com/api/v3/agents/activity?api=true&sort=newest' \
  --header 'Authorization: Bearer <token>'

• Production

Org-wide, paginated feed of agent runs and their judgments across every channel your API key can see. Filter by agent, agent type, date range, or a free-text query, and sort newest or oldest first.

Authorizations

• bearerAuth

Parameters

Query Parameters

api

required

boolean

Required. Set to true.

limit

integer

Results per page. Defaults to 20, maximum 100.

page

integer

Page number. Defaults to 1.

sort

string

Allowed values: newest oldest

Sort order. Defaults to newest.

agentUniqueId

string

Restrict the feed to one agent’s runs.

agentType

integer

Restrict the feed to one agent type.

dateFrom

string

Only runs on or after this date, as YYYY-MM-DD.

dateTo

string

Only runs on or before this date, as YYYY-MM-DD.

queryParams

string

Free-text search over run content.

Responses

200

200 OK

Media type application/json

object

items

Array<object>

object

uniqueId

string

agentUniqueId

string

agentName

string

agentType

integer

letterTitle

string

contextLabel

string

resourceType

integer

resourceUniqueId

string

status

integer

summary

string

nullable

validationCode

integer

dispatchedAt

string

nullable

startedAt

string

nullable

completedAt

string

nullable

judgments

Array<object>

object

uniqueId

string

severity

integer

confidence

integer

category

string

finding

string

suggestion

string

state

integer

createdAt

string

updatedAt

string

isOutdated

boolean

createdAt

string

updatedAt

string

message

string

total

integer

Example

{
  "items": [
    {
      "uniqueId": "vq5rnof1op",
      "agentUniqueId": "mofuehvagv",
      "agentName": "House style checker",
      "agentType": 0,
      "letterTitle": "This week in the daily",
      "contextLabel": "the-daily",
      "resourceType": 0,
      "resourceUniqueId": "35f725edbi",
      "status": 1,
      "summary": "No major issues found.",
      "validationCode": 200,
      "dispatchedAt": "2026-06-18T14:22:03+00:00",
      "startedAt": "2026-06-18T14:22:05+00:00",
      "completedAt": "2026-06-18T14:22:09+00:00",
      "judgments": [],
      "createdAt": "2026-06-18T14:22:03+00:00",
      "updatedAt": "2026-06-18T14:22:09+00:00"
    }
  ],
  "message": "",
  "total": 1
}