> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Task Status

```bash curl theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl https://sys.poixe.com/api/channel-tasks/sys-1731337200000000000-a3b9c2d1 \
  -H "Authorization: Bearer $POIXE_SYSTEM_TOKEN"
```

```json response theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "task_id": "sys-1731337200000000000-a3b9c2d1",
  "status": "completed",
  "created_count": 2,
  "failed_count": 0,
  "channels": [
    {
      "id": 42,
      "name": "OpenAI ChatGPT · sk-...wxyz · 3 models",
      "type": "openai_chatgpt",
      "type_name": "OpenAI ChatGPT",
      "models": "gpt-4o,gpt-4o-mini,gpt-4-turbo",
      "status": "enabled",
      "created_at": 1731337220
    }
  ],
  "timestamp": 1731337260
}
```

GET
`https://sys.poixe.com/api/channel-tasks/:taskID`

Poll the status of a channel creation task until `status` is `completed` or `failed`. Tasks expire after **24 hours**.

Recommended polling interval: 2–5 seconds. Tasks typically complete within seconds.

## Path Parameters

**taskID** `string` *required*

The `task_id` returned by [Create Channel](https://docs.poixe.com/en/api-reference/system-api/channel/create.md)

## Response Fields

**task\_id** `string`

Task ID

**status** `string`

Task status: `pending` · `running` · `completed` · `failed`

**created\_count** `integer`

Number of channels successfully created

**failed\_count** `integer`

Number of channels that failed. If `status` is `completed` and this is greater than 0, some keys failed model validation — no available models were found. Successfully created channels are still listed

**channels** `array`

Successfully created channels (available after task completes):

**channel fields**

**id** `integer`

Channel ID

**name** `string`

Channel name

**type** `string`

Channel type slug

**type\_name** `string`

Channel type display name

**models** `string`

Comma-separated list of detected available models

**status** `string`

Channel status

**created\_at** `integer`

Creation timestamp (Unix seconds)

**timestamp** `integer`

Response timestamp (Unix seconds)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.