Token-Based Authentication | Deepgram's Docs

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.

Authentication

AuthorizationToken

Use Authorization: Token <API_KEY> Example: Authorization: Token 12345abcdef

Request

Time to live settings

ttl_secondsdoubleOptional1-3600

Time to live in seconds for the token. Defaults to 30 seconds.

Response

Grant response

access_tokenstring

JSON Web Token (JWT)

expires_indouble

Time in seconds until the JWT expires

Errors

400

Bad Request Error

Use Authorization: Token <API_KEY> Example: Authorization: Token 12345abcdef

Time to live settings

Time to live in seconds for the token. Defaults to 30 seconds.

JSON Web Token (JWT)

Time in seconds until the JWT expires

1	import requests
2
3	url = "https://api.deepgram.com/v1/auth/grant"
4
5	payload = {}
6	headers = {
7	"Authorization": "Token <apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	import requests
2
3	url = "https://api.deepgram.com/v1/auth/grant"
4
5	payload = {}
6	headers = {
7	"Authorization": "Token <apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U",
3	"expires_in": 30
4	}