Authentication - Diro API

API Keys

All API requests require authentication using a Bearer token.

Getting Your API Key

Log in to the Diro Dashboard
Navigate to API Keys
Click “Create API Key”
Give it a descriptive name
Copy and securely store your key

API keys are shown only once. If you lose your key, you’ll need to create a new one.

Using Your API Key

Include your API key in the Authorization header:

Authorization: Bearer diro_your_api_key

Example Request

curl https://www.getdiro.com/api/v1/templates \
  -H "Authorization: Bearer diro_your_api_key"

Plan Limits

API access is available on all plans, including Free. Each plan has different render limits.

Plan	API Access	Monthly Renders
Free	✅	50
Starter	✅	150
Pro	✅	500
Enterprise	✅	5,000

Error Responses

Invalid API Key

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid or missing API key"
  }
}

Render Limit Exceeded

{
  "success": false,
  "error": {
    "code": "RENDER_LIMIT_EXCEEDED",
    "message": "Monthly render limit exceeded. Please upgrade your plan."
  }
}

Security Best Practices

Never expose keys in client-side code

API keys should only be used in server-side code or secure environments.

Use environment variables

Store API keys in environment variables, not in source code.

Rotate keys periodically

Create new keys and delete old ones regularly.

Use separate keys for different environments

Create separate keys for development, staging, and production.

​API Keys

​Getting Your API Key

​Using Your API Key

​Example Request

​Plan Limits

​Error Responses

​Invalid API Key

​Render Limit Exceeded

​Security Best Practices

API Keys

Getting Your API Key

Using Your API Key

Example Request

Plan Limits

Error Responses

Invalid API Key

Render Limit Exceeded

Security Best Practices