---
title: "Get an agent task"
method: GET
path: "/api/v1/public/brands/{brandSlug}/tasks/{taskId}/"
tags: ["Public: Tasks"]
---

# Get an agent task

`GET /api/v1/public/brands/{brandSlug}/tasks/{taskId}/`

## Request

- Base URL: `https://api.iterant.ai`
- URL: `https://api.iterant.ai/api/v1/public/brands/{brandSlug}/tasks/{taskId}/`
- Auth: HTTP bearer

Poll this every 30-60 seconds while a task runs; a typical task settles in about five minutes.

`resultingRoute` is the page a `build_page` task produced. It is always empty for a `prompt` task, even on success: a free-form turn has no single route, and its result is the chat thread at `chatUrl`.

`error` is present only when `status` is `failed`.

## Path parameters

- `brandSlug` string, required
- `taskId` string, uuid, required

## Response `200`

- PublicAgentTask
  - `taskId` string, uuid, required
  - `command` 'prompt' | 'build_page', required: * `prompt` - Prompt * `build_page` - Build page
  - `status` 'running' | 'succeeded' | 'failed', required: * `running` - Running * `succeeded` - Succeeded * `failed` - Failed
  - `createdAt` string, date-time, required
  - `finishedAt` string, date-time, nullable, required: Null while the task is running.
  - `resultingRoute` string, required: The route the build produced. Always empty for a "prompt" task: a free-form turn has no single route, so its result is the chat thread.
  - `chatUrl` string, required
  - `error` string: Present only when `status` is `failed`.

## Other responses

- `400`
- `401`
- `404`
- `405`
- `406`
- `415`
- `429`
- `500`

---

[API](https://skmtc.dev/iterant/apis/iterant-public-api.md) · [All operations](https://skmtc.dev/iterant/apis/iterant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/iterant/apis/iterant-public-api/revisions/8d62f6ac9cbd?raw)