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

# Generate Ingest Token

> Create a new ingest token for telemetry data ingestion.

## Authentication

Requires JWT token authentication.

## Example Request

```bash theme={null}
curl -X POST https://api.app.shinzo.ai/auth/generate_ingest_token \
  -H "Authorization: Bearer <jwt_token>"
```

## Response

```json theme={null}
{
  "uuid": "itk_abc123def456",
  "token": "abc123-def456-ghi789-...",
  "created_at": "2025-01-15T10:00:00Z",
  "status": "active"
}
```

<Warning>
  The token value is only displayed once at creation. Store it securely as it cannot be retrieved later.
</Warning>

## Response Fields

| Field        | Type   | Description                       |
| ------------ | ------ | --------------------------------- |
| `uuid`       | string | Unique identifier for the token   |
| `token`      | string | The token value (shown only once) |
| `created_at` | string | Creation timestamp (ISO 8601)     |
| `status`     | string | Token status (`active`)           |

## Status Codes

| Code  | Description                  |
| ----- | ---------------------------- |
| `200` | Token generated successfully |
| `401` | Invalid or missing JWT token |