Zero to your first API call

Everything your team sees on the board — tasks, projects, comments, search — is reachable over a plain REST API. This guide takes you from nothing to an authenticated request in about five minutes.

Create an API key

In the app, open Settings → API keys and create an organization key. Keys are scoped: you choose which capabilities (read tasks, write comments, and so on) and which spaces the key can touch. The key is shown once — store it in your secret manager, not your shell history.

Keys look like amk_… and authenticate as a Bearer token. Every action taken with a key is attributed in the audit trail to the key and the user who created it — there are no anonymous writes.

Make the call

List the tasks the key can see:

curl -s https://app.agenttask.dev/api/v1/tasks \
  -H "Authorization: Bearer $AGENT_TASK_API_KEY"

Where to go next

The full endpoint catalog lives in the API reference, including creating tasks, threading comments, and cursor-paginated search. If your caller is an AI agent rather than a script, skip ahead to the MCP guide — the same backlog, but with typed tools instead of raw HTTP.