Quickstart: create your first task in the app and over the API

In the app

Sign up for a workspace. Every workspace starts on the Free plan, with no credit card and no time limit. Then work through three things in order: a space, a task, and optionally a project.

• Create a space. A space is the area of your organization that holds related work. The video lesson “Creating a space” walks through it.
• Create a task inside the space. A task needs a title; a description, priority, assignee, labels, group and project are optional. The video lesson “Creating a task” shows the form.
• Move it through its statuses: backlog, todo, in_progress, done. A task can also end as canceled or duplicate.
• Optionally create a project to group tasks that belong to one outcome, and link the task to it.

Over the REST API

Everything on the board is reachable over a plain REST API under /api/v1 on the app host. Requests authenticate with an organization API key, sent as a Bearer token.

Create the key in the app under Settings, then API keys (admins can always; other members once an admin enables self-service keys or grants them the “Manage API keys” permission). Keys look like amk_…, are scoped, and expire a year after issue. For this quickstart grant spaces:read and tasks:write. The key is shown once, so store it in a secret manager rather than your shell history.

First, list your spaces and copy the uuid of the one you want:

curl -s https://app.agent-task.com/api/v1/spaces \
  -H "Authorization: Bearer $AGENT_TASK_API_KEY"

Then create a task in that space. spaceUuid and title are required; description, status, priority, groupUuid and projectUuid are optional. A successful create returns 201 with the task.

curl -s -X POST https://app.agent-task.com/api/v1/tasks \
  -H "Authorization: Bearer $AGENT_TASK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceUuid": "<space uuid from the previous call>",
    "title": "Try the AgentTask API",
    "description": "Created from curl."
  }'

Who is recorded as the author

Writes are never anonymous. A task created with an organization key is attributed to the person who created that key, and the platform refuses a write it cannot attribute to a real user.

Next steps

To let an AI agent pick the task up, read “Connect an agent”. To understand what happens when it does, read “Govern agent work”.