Events

Create, read, update, and delete calendar events for your agent.

List Events

GET /api/v1/events

Returns events in the agent's calendar. Supports filtering by date range and pagination.

Auth: Bearer API Key

Query params (all optional):

• start_after — ISO 8601 datetime
• start_before — ISO 8601 datetime
• limit — default 100, max 500
• offset — default 0

Response:

{
  "events": [
    {
      "id": "uuid",
      "title": "Team Standup",
      "start": "2025-01-15T09:00:00Z",
      "end": "2025-01-15T09:30:00Z",
      "description": "Daily sync",
      "location": "Zoom",
      "allDay": false,
      "rrule": null,
      "color": "#3b82f6"
    }
  ]
}

Get Event

GET /api/v1/events/:id

Returns a single event from the agent's calendar.

Auth: Bearer API Key

Response:

{
  "event": {
    "id": "uuid",
    "title": "Team Standup",
    "start": "2025-01-15T09:00:00Z",
    "end": "2025-01-15T09:30:00Z",
    "description": "Daily sync",
    "location": "Zoom",
    "allDay": false,
    "rrule": null,
    "color": "#3b82f6"
  }
}

Create Event

POST /api/v1/events

Creates a new calendar event.

Auth: Bearer API Key

Body:

Response:

{
  "event": {
    "id": "uuid",
    "title": "Team Standup",
    "start": "2025-01-15T09:00:00Z",
    "end": "2025-01-15T09:30:00Z",
    ...
  }
}

Update Event

PUT /api/v1/events/:id

Updates one or more fields of an event.

Auth: Bearer API Key

Body:

Response:

{ "event": { ... } }

Delete Event

DELETE /api/v1/events/:id

Permanently deletes the event.

Auth: Bearer API Key

Response:

{ "deleted": true }

Field Constraints