AdminInspect an aggregate (state + event history)

Inspect an aggregate (state + event history)

Returns the registry row, live Durable Object state, and R2 event history for a single aggregate. type accepts the canonical aggregate type (e.g. LockAggregate) or its friendly slug (e.g. lock). Requires dual admin auth (X-Admin-API-Key + JWT with an allowed email domain).

curl -X GET "https://api.spkey.co/admin/aggregates/example_string/example_string?limit=42" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "aggregateType": "example_string",
  "aggregateId": "example_string",
  "doId": "null",
  "registry": "null",
  "stateFound": true,
  "state": "null",
  "events": [
    {
      "version": 3.14,
      "type": "example_string",
      "timestamp": "example_string",
      "orgId": "example_string",
      "event": "null"
    }
  ],
  "eventCount": 3.14,
  "eventsTruncated": true
}
GET
/admin/aggregates/{type}/{id}
GET
Base URLstring

Target server for requests. Edit to use your own host.

⚠️Authentication configuration error - security schemes not found
path
typestring
Required

Aggregate type or slug, e.g. "lock" or "LockAggregate"

path
idstring
Required

Aggregate id (== state.id used for DO routing)

query
limitinteger

Max events to return (default 200).

Min: 1 • Max: 500
Request Preview
Response

Response will appear here after sending the request

Path Parameters

typestring
Required

Aggregate type or slug, e.g. "lock" or "LockAggregate"

idstring
Required

Aggregate id (== state.id used for DO routing)

Query Parameters

limitinteger

Max events to return (default 200).

Responses

aggregateTypestring
Required
aggregateIdstring
Required
doIdstring,null
Required
registryobject,null
Required
stateFoundboolean
Required
statestring
eventsarray
Required
eventCountnumber
Required
eventsTruncatedboolean
Required