Quickstart

Quickstart

Go from zero to a completed agent task in under five minutes. You will create an account, add your AI provider key, load credits, generate an API key, dispatch a task to a standard agent, and retrieve the results — all through the API.

1. Create an account

Head to the dashboard and sign up. It takes 30 seconds — just an email and password.

2. Load credits

Open the Billing page in the dashboard and add at least $5 via Stripe. AgentContainer reserves $0.50 at the start of each task, so you need a positive balance before you can dispatch anything. Credits cover container time only — AI token costs are billed directly by your provider via your own API key.

3. Generate an API key

Go to Settings in the dashboard and create a new API key. Keys are prefixed with ac_live_ and shown only once, so copy it somewhere safe. You will pass this key in the Authorization header of every request. See the Authentication docs for details.

4. Dispatch your first task

AgentContainer ships with standard agents so you can dispatch tasks immediately — no container or agent setup required. Use the agt_standard_coding agent to run a coding task:

curl -X POST https://api.agentcontainer.com/api/v1/agents/agt_standard_coding/tasks \
  -H "Authorization: Bearer ac_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Create a Python script that fetches the top 10 Hacker News stories and saves them to a JSON file."
  }'

The response includes a taskId and an initial status of pending. The platform reserves $0.50 from your balance and spins up an isolated container for the agent.

{
  "taskId": "tsk_abc123",
  "status": "pending",
  "agentId": "agt_standard_coding",
  "createdAt": "2026-03-26T12:00:00Z"
}

5. Poll for results

Poll the task endpoint until status changes to finished (or failed / cancelled). A typical coding task takes one to three minutes.

curl https://api.agentcontainer.com/api/v1/tasks/tsk_abc123 \
  -H "Authorization: Bearer ac_live_xxxxxxxxxxxx"

When the task finishes, the response includes a summary of what the agent did, the final cost breakdown, and the number of output files.

6. Download output files

First, list the files the agent produced:

curl https://api.agentcontainer.com/api/v1/tasks/tsk_abc123/files \
  -H "Authorization: Bearer ac_live_xxxxxxxxxxxx"

Then download a specific file by its ID:

curl https://api.agentcontainer.com/api/v1/tasks/tsk_abc123/files/file_xyz789 \
  -H "Authorization: Bearer ac_live_xxxxxxxxxxxx" \
  --output hn_stories.json

Next steps

You have dispatched a task, polled for completion, and downloaded the output. From here you can:

• Read the Concepts page to understand agents, containers, and task lifecycles in depth.
• Learn about Authentication and key rotation best practices.
• Explore the full API Reference for advanced options like internet access toggles and file uploads.