---
title: "Create an analytics token"
method: POST
path: "/analytics/ingest-token"
tags: ["Analytics"]
---

# Create an analytics token

`POST /analytics/ingest-token`

## Request

- Base URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor`
- URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor/analytics/ingest-token`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/docs/analytics/ingest-token/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a token for submitting analytics events, valid for five minutes.

## Headers

- `x-api-key` string: API key for authentication

## Response `200`

Analytics ingest token and its expiry

- AnalyticsIngestTokenResponse
  - `token` string, required: Purpose-limited JWT authorizing analytics event ingest for five minutes
  - `expiresAt` string, date-time, required: UTC expiry matching the JWT exp claim

## Other responses

- `401`: Missing or invalid API key
- `403`: The authenticated project is not permitted or is not billable.
- `503`: Tenant billing verification is temporarily unavailable; retry after 5 seconds.

## Changes

- **2026-11-06** `aa1767d704fa`: 5 info
  - the endpoint scheme security `internalProjectBearer` was added to the API
  - the endpoint scheme security `tenantApiKey` was added to the API
  - the `header` request parameter `x-api-key` became optional
  - added the non-success response with the status `403`
  - …1 more
- **2026-09-17** `676300ac19ff`: 1 info
  - added the optional property `code` to the response with the `401` status
- **2026-09-04** `54262a43c6a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/changes/analytics/ingest-token/post.md)

---

[API](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api.md) - [All operations](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/revisions/aa1767d704fa?raw)