---
title: "Get an embedding task's status"
method: GET
path: "/ai/embeddings/{task_id}"
tags: ["Embeddings"]
---

# Get an embedding task's status

`GET /ai/embeddings/{task_id}`

Check the status of a current embedding task. Will be one of the following:
- `queued` - Task is waiting to be picked up by a worker
- `processing` - The embedding task is running
- `success` - Task completed successfully and the bucket is embedded
- `failure` - Task failed and no files were embedded successfully
- `partial_success` - Some files were embedded successfully, but at least one failed

## Path parameters

- `task_id` string, required

## Response `200`

Successful Response

- TaskStatusResponse
  - `data` object, required
    - `task_id` string, uuid
    - `task_name` string
    - `status` 'queued' | 'processing' | 'success' | 'failure' | 'partial_success' — Status of an embeddings task.
    - `created_at` string
    - `finished_at` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)