API Reference Overview

The Chronary REST API provides programmatic access to calendars, events, availability, webhooks, and more.

Base URL

https://api.chronary.ai/v1

All endpoints are versioned under /v1/.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer chr_sk_live_your_key_here

See Authentication for details on test vs live mode.

Request format

• Content-Type: application/json for POST and PATCH requests
• Query parameters: Used for GET requests (filtering, pagination)
• Path parameters: Resource IDs in the URL path

Response format

All responses return JSON with consistent structure:

Single resource:

{
  "id": "agt_a1b2c3d4",
  "name": "Sales Agent",
  "type": "ai",
  "status": "active",
  "created_at": "2026-04-04T12:00:00Z",
  "updated_at": "2026-04-04T12:00:00Z"
}

List response:

{
  "data": [ ... ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

Pagination

All list endpoints support limit and offset query parameters:

Parameter	Type	Default	Range
limit	integer	50	1–200
offset	integer	0	0+

Error responses

Errors follow a standard format:

{
  "error": {
    "type": "not_found",
    "message": "Agent not found",
    "request_id": "req_abc123"
  }
}

See Error Codes for all error types.

Rate limits

• 10 requests per second per API key
• Monthly API call quotas vary by plan

See Rate Limits for details.

Resources

Agents CRUD operations for agents

Calendars Create and manage calendars

Events Create, list, update, delete events

Availability Query free/busy time slots

Webhooks Register event notification endpoints

iCal Feeds Public calendar feeds

iCal Subscriptions Import external calendars

Usage Check quota and usage stats