API Documentation

Developer API

A small, read-only REST API for pulling your agency's data into your own tools. More endpoints (write access, webhooks, AI tool invocation) are on the roadmap — email support@agencypilothq.com if you need one sooner.

Authentication

Create a key from Settings → API Keys in your dashboard. Send it as a Bearer token on every request.

curl https://agencypilothq.com/api/v1/clients \
  -H "Authorization: Bearer apk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Keys are scoped to a single agency workspace and can be revoked at any time. Treat them like a password — anyone with the key can read your agency's data.

Base URL

https://agencypilothq.com/api/v1

Endpoints

GET/v1/clients

Returns up to 100 of your most recent clients.

{
  "data": [
    { "id": "cku1...", "name": "Acme Co", "email": "hi@acme.com", "company": "Acme", "createdAt": "2026-01-01T00:00:00.000Z" }
  ]
}

GET/v1/projects

Returns up to 100 of your most recent projects.

{
  "data": [
    { "id": "ckp1...", "name": "Website redesign", "status": "ACTIVE", "clientId": "cku1...", "startDate": null, "endDate": null, "createdAt": "2026-01-01T00:00:00.000Z" }
  ]
}

Errors

Requests with a missing, invalid, or revoked key return 401 with { "error": "Invalid or missing API key" }.