Get event

Read one event from the last 30 days.

GET /api/v1/events/{event_id}

cURL

curl "https://api.wordsmith.ai/api/v1/events/8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "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"
  }
}

Returns one event, if you can read it. Events carry IDs and statuses, never content: read the resource for that.

​

Authentication

Requires an API key, or an OAuth token with webhooks:read.

​

Path parameters

event_id · string · required

The event, as its id or the Wordsmith-Event-Id header gave it.

​

Query parameters

audience · string · default: "user"

customer reads an event about shared work, with webhooks:admin.

​

Response

Returns the event.

cURL

curl "https://api.wordsmith.ai/api/v1/events/8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "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"
  }
}

​

Errors

Status	error_code	When
404	resource_not_found	No such event you can read, or it is older than 30 days.