Skip to main content
GET
/
boxes
/
{boxId}
/
events
List box events
curl --request GET \
  --url https://ascii.dev/api/box/v1/boxes/{boxId}/events \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "type": "events.list",
  "id": "bx_23456789",
  "events": [
    {
      "id": "prompt_123",
      "type": "prompt",
      "timestamp": 1780347055370,
      "taskId": "prompt_123",
      "data": {
        "prompt": "Run tests and summarize failures.",
        "status": "running",
        "is_reverted": false
      }
    },
    {
      "id": "response_123-tools",
      "type": "response",
      "timestamp": 1780347063427,
      "taskId": "prompt_123",
      "data": {
        "content": "",
        "model": "gpt-5.4",
        "tools": [
          {
            "use": {
              "id": "call_123",
              "type": "tool_use",
              "name": "Bash",
              "input": {
                "command": "npm test"
              }
            },
            "result": {
              "type": "tool_result",
              "tool_use_id": "call_123",
              "is_error": false,
              "content": "{\"exitCode\":0}"
            }
          }
        ],
        "is_reverted": false
      }
    },
    {
      "id": "response_123",
      "type": "response",
      "timestamp": 1780347065650,
      "taskId": "prompt_123",
      "data": {
        "content": "Tests passed.",
        "model": "gpt-5.4",
        "is_reverted": false
      }
    }
  ],
  "pageInfo": {
    "nextCursor": null,
    "hasMore": false,
    "limit": 100
  }
}

Authorizations

Authorization
string
header
required

Box API key in the form box_.... Create and rotate keys in the Box dashboard or through the v1 API key endpoints.

Path Parameters

boxId
string
required

Public Box id returned by create/list/get box calls.

Pattern: ^bx_[23456789abcdefghjkmnpqrstuvwxyz]{8}$

Query Parameters

limit
integer
default:100

Maximum items to return.

Required range: 1 <= x <= 200
cursor
string | null

Opaque pagination cursor returned as pageInfo.nextCursor.

sort
enum<string>
default:desc

Sort direction for cursor pagination.

Available options:
asc,
desc
type
string

Comma-separated event type filter, for example prompt,response,git_checkpoint.

Response

Box work and lifecycle events.

ok
boolean
required
Example:

true

type
string
required

Stable success envelope discriminator added by v1.

Allowed value: "events.list"
id
string
required
events
object[]
required

Box work and lifecycle event objects. Event shapes are intentionally extensible; branch on each event type when present.

pageInfo
object