---
title: "Token-based Authentication"
method: POST
path: "/v1/auth/grant"
tags: ["tokens"]
---

# Token-based Authentication

`POST /v1/auth/grant`

Generates a temporary JSON Web Token (JWT) with a 30-second (by default) TTL and usage::write permission for core voice APIs, requiring an API key with Member or higher authorization. Tokens created with this endpoint will not work with the Manage APIs.

## Headers

- `Authorization` string, required

## Request body

- GrantV1Request
  - `ttl_seconds` number, double — Time to live in seconds for the token. Defaults to 30 seconds.

## Response `200`

Grant response

- GrantV1Response
  - `access_token` string, required — JSON Web Token (JWT)
  - `expires_in` number, double — Time in seconds until the JWT expires

## Other responses

- `400` — Invalid Request

---

[API](https://skmtc.net/deepgram/apis/rest-api.md) · [All operations](https://skmtc.net/deepgram/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deepgram/rest-api/revisions/bd7ba5c18a6b/schema)