Skip to main content
POST
mintIngestToken

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Tenant
string

Workspace slug. Overrides subdomain-based workspace resolution when provided.

Example:

"acme"

X-Request-ID
string<uuid>

Optional request correlation ID echoed back in the response.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

Input for minting a new ingest token. The tap must belong to the calling workspace; the service layer enforces this before minting.

tenantConnectorTapId
string
required

The collector TenantConnectorTap this token routes to.

Response

Successful response

data
object
required

Result of mintIngestToken and rotateIngestToken. The plaintext token is returned exactly once and is irrecoverable afterwards — clients must surface it (and the endpointUrl embedding it) to the user immediately and never re-fetch.

meta
object
required