Skip to main content

Welcome to the Day Copilot API

The Day Copilot API is a REST API that allows you to programmatically manage tasks, events, and contexts. All endpoints are accessed via https://app.daycopilot.ai/api/v1/ and return JSON responses.

Interactive API Playground

All API endpoints in this reference include an interactive playground where you can test requests with your own authentication token.

Base URL

Authentication

All API requests require authentication via Bearer token in the Authorization header:

Get Started with Authentication

Learn how to obtain and use API tokens

API Resources

Day Copilot API is organized around three main resources:

Tasks

Create and manage actionable items with assignments, due dates, and priorities

Events

Manage calendar events with attendees, times, and locations

Contexts

Organize tasks and events into shared workspaces

Request Format

Headers

All requests should include:

Body

Request bodies use JSON format:

Response Format

Success Responses

Successful responses return HTTP 200/201 with JSON data:

List Responses

List endpoints include pagination metadata:

Error Responses

Errors return appropriate HTTP status codes with details:

HTTP Status Codes

Pagination

List endpoints support pagination via query parameters:

Parameters

Response

Filtering & Searching

Filter by Context

Search Tasks

Filter by Status

Sorting

Sort results using the sort parameter:
  • Prefix with - for descending order
  • Multiple sort fields supported (comma-separated)
  • Default: -created_at

Versioning

The API uses URL-based versioning. Current version is v1:
Breaking changes will be released under a new version (e.g., /api/v2/). We’ll provide advance notice and migration guides for version changes.

Rate Limiting

All endpoints are rate-limited. See Rate Limits for details. Rate limit information is included in response headers:

Data Types

UUIDs

All resource IDs use UUID v4 format:

Timestamps

All timestamps are ISO 8601 formatted in UTC:

Enums

Many fields accept only specific values:

Idempotency

POST and PUT requests support idempotency via the Idempotency-Key header:
Requests with the same idempotency key will return the same response, preventing duplicate resource creation.

Webhooks (Coming Soon)

Subscribe to real-time events:

OpenAPI Specification

Download the complete OpenAPI 3.0 specification:

Download OpenAPI Spec

Use with Postman, Insomnia, or code generators

SDKs & Libraries

Official SDKs (coming soon):
  • JavaScript/TypeScript
  • Python
  • Go
Community SDKs:
  • PHP (maintained by community)
  • Ruby (maintained by community)

Getting Help

Quick Start Guide

Make your first API call in 5 minutes

Architecture Guide

Understand the system architecture

Support

Contact our support team

API Status

Check API uptime and incidents

API Changelog

Stay up to date with API changes:

View Changelog

See recent updates and breaking changes