---
title: "Store a single event"
method: POST
path: "/api/events"
tags: ["Events"]
---

# Store a single event

`POST /api/events`

## Request body

- object
  - `category` 'tool' | 'skill' | 'session' | 'api' | 'task' | 'workflow' | 'system', required
  - `event` 'tool.start' | 'tool.end' | 'skill.invoke' | 'skill.complete' | 'session.start' | 'session.end' | 'session.resume' | 'session.cost' | 'api.request' | 'api.error' | 'task.poll' | 'task.assign' | 'task.timeout' | 'workflow.step.start' | 'workflow.step.end' | 'workflow.run.start' | 'workflow.run.end' | 'system.boot' | 'system.migration' | 'system.error' | 'script.global_upsert' | 'schedule.deleted', required
  - `status` 'ok' | 'error' | 'timeout' | 'skipped'
  - `source` 'worker' | 'api' | 'hook' | 'scheduler' | 'cli', required
  - `agentId` string
  - `taskId` string
  - `sessionId` string
  - `parentEventId` string
  - `numericValue` number
  - `durationMs` integer
  - `data` object

## Response `201`

Event stored

- object
  - `success` true, required
  - `event` SwarmEvent, required
    - `id` string, uuid, required
    - `category` 'tool' | 'skill' | 'session' | 'api' | 'task' | 'workflow' | 'system', required
    - `event` 'tool.start' | 'tool.end' | 'skill.invoke' | 'skill.complete' | 'session.start' | 'session.end' | 'session.resume' | 'session.cost' | 'api.request' | 'api.error' | 'task.poll' | 'task.assign' | 'task.timeout' | 'workflow.step.start' | 'workflow.step.end' | 'workflow.run.start' | 'workflow.run.end' | 'system.boot' | 'system.migration' | 'system.error' | 'script.global_upsert' | 'schedule.deleted', required
    - `status` 'ok' | 'error' | 'timeout' | 'skipped', required
    - `source` 'worker' | 'api' | 'hook' | 'scheduler' | 'cli', required
    - `agentId` string
    - `taskId` string
    - `sessionId` string
    - `parentEventId` string
    - `numericValue` number
    - `durationMs` integer
    - `data` object
    - `createdAt` string, date-time, required

## Other responses

- `400` — Validation error

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/101e7a060651/schema)