List events

List the events you can read from the last 30 days, oldest first.

GET /api/v1/events

cURL

curl "https://api.wordsmith.ai/api/v1/events?types=task.*,review.completed&created_after=2026-11-08T00:00:00Z" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48",
      "type": "task.assigned",
      "api_version": "2026-11-01",
      "created_at": "2026-11-09T10:12:03Z",
      "resource": {
        "type": "task",
        "id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58"
      },
      "actor": {
        "kind": "user",
        "id": "1a2b3c4d-5e6f-4a70-8b91-c2d3e4f5a6b7"
      },
      "data": {
        "task_id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58",
        "status": "open",
        "assignee_id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
        "team_id": null,
        "agent_id": null,
        "url": "https://app.wordsmith.ai/tasks?activeId=5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58"
      }
    }
  ],
  "cursor": null
}

The event log holds the same events webhook endpoints receive, for 30 days. Use it to catch up after your receiver was down. Each event is checked as you: you see only events whose resource you can read and whose scope your credential grants. Filters apply after the read, so a page can hold fewer than limit events and still have a cursor.

​

Authentication

Requires an API key, or an OAuth token with webhooks:read. With audience=customer, also webhooks:admin.

​

Query parameters

types · string

Comma-separated event types to return. A wildcard such as task.* is allowed.

created_after · string

ISO 8601. Without a cursor, start at events created at or after this time.

audience · string · default: "user"

customer lists events about work shared with the whole organisation.

cursor · string

The cursor from the previous page.

limit · integer · default: "50"

Events per page, from 1 to 100.

​

Response

Returns a page of events. A cursor of null means you have read to the end of the log.

cURL

curl "https://api.wordsmith.ai/api/v1/events?types=task.*,review.completed&created_after=2026-11-08T00:00:00Z" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48",
      "type": "task.assigned",
      "api_version": "2026-11-01",
      "created_at": "2026-11-09T10:12:03Z",
      "resource": {
        "type": "task",
        "id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58"
      },
      "actor": {
        "kind": "user",
        "id": "1a2b3c4d-5e6f-4a70-8b91-c2d3e4f5a6b7"
      },
      "data": {
        "task_id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58",
        "status": "open",
        "assignee_id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
        "team_id": null,
        "agent_id": null,
        "url": "https://app.wordsmith.ai/tasks?activeId=5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58"
      }
    }
  ],
  "cursor": null
}

​

Errors

Status	error_code	When
400	bad_request	A created_after that is not ISO 8601, or a cursor this API did not return.
403	insufficient_scope	audience=customer without webhooks:admin.
404	resource_not_found	Webhooks are not on for your organisation.