---
title: "Issue a Cube API token for Usage Analytics"
method: POST
path: "/api/v1/usage-analytics/token"
tags: ["Usage Analytics"]
---

# Issue a Cube API token for Usage Analytics

`POST /api/v1/usage-analytics/token`

## Response `200`

- UsageAnalyticsTokenResponse
  - `apiUrl` string, required — Base URL of the Usage Analytics deployment’s Cube REST API (e.g. `https://<host>/cubejs-api/v1`). Query it with the returned token.
  - `deploymentId` integer, required — Id of the Usage Analytics deployment the token was issued for.
  - `expiresAt` string, nullable — When the token expires, as an ISO-8601 timestamp. Request a new token before this moment — issuing one is idempotent and cheap.
  - `token` string, required — A short-lived JWT for the Usage Analytics deployment, carrying this tenant’s security context. Send it as `Authorization: Bearer <token>` on requests to `apiUrl`.

## Changes

- **2026-08-30** `3adb3c5e66ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cube-js/apis/cube-cloud-rest-api/changes/api/v1/usage-analytics/token/post.md)

---

[API](https://skmtc.dev/cube-js/apis/cube-cloud-rest-api.md) · [All operations](https://skmtc.dev/cube-js/apis/cube-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cube-js/cube-cloud-rest-api/revisions/3adb3c5e66ca/schema)