Schedule & Chill
Developer docs

REST API and MCP, in one reference.

Bearer token for your own code, OAuth for agents. Same capabilities either way.

REST API

API keys

List, create and revoke Schedule & Chill API keys over the REST API. One key authenticates both the REST API and the MCP server.

Manage your API keys over the API. Keys authenticate both the REST API and the MCP server — see Authentication.

List keys

GET/api/api-keys

Returns your keys with a masked preview (the secret is never returned again after creation):

JSON
[
    {
        "id": "1234567890abcdef",
        "name": "Production Server",
        "key_preview": "••••••••abcdef",
        "last_used_at": "2026-06-06T12:30:00Z",
        "created_at": "2026-06-05T10:00:00Z"
    }
]

Create a key

POST/api/api-keys
Field Type Required Notes
name string yes A label to identify the key. Max 255 characters.
Terminal
curl -X POST https://schedulenchill.com/api/api-keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "name": "CI pipeline" }'

Returns 201 Created. The full token is included only in this response — store it securely, it cannot be retrieved again:

JSON
{
    "id": "abc123",
    "name": "CI pipeline",
    "token": "abc123|long-secret-string-shown-once",
    "created_at": "2026-06-06T17:40:00Z"
}

Revoke a key

DELETE/api/api-keys/{id}

Immediately invalidates the key. Returns 204 No Content. Any request using a revoked key returns 401.

Not a developer question?Browse the help centre →

Still stuck? Ask a person.

One inbox, answered by the people who built it. Usually same day, and never a ticket number.