> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get event

> Read one event from the last 30 days.

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.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.wordsmith.ai/api/v1/events/8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.