Token-based Authentication | Deepgram's Docs

🚀 Introducing Flux, the first conversational speech recognition model built for voice agents. (Learn more!)🚀

Playground Console Community Support Free API Key

Home API Reference Voice Agent Speech-to-Text Text-to-Speech Intelligence Self-Hosted Deployments

General
API Reference

Playground Console Community Support Free API Key

API Reference Auth V1 Tokens

POST

/v1/auth/grant

POST

/v1/auth/grant

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

Try it

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

Was this page helpful?

Built with

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.

Token-based Authentication

Headers

AuthorizationstringRequired

Request

Time to live settings

ttl_secondsintegerOptional>=1<=3600

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

Response

Grant response

access_tokenstring

JSON Web Token (JWT)

expires_indouble or null

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": "<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	}

Headers

Request

Response

Errors