​
Overview

The Extend platform uses Bearer token authentication for all API requests. You’ll need to include your API token in the Authorization header of each request.

​
Obtaining an API Token

  1. Log into the Extend Dashboard
  2. Navigate to Settings → Developer
  3. Create a new API key or copy an existing one

Important: Keep your API tokens secure and never share them publicly. Rotate them regularly and immediately if they’re ever compromised.

​
Making Authenticated Requests

​
HTTP Header Format

Include your API token in the Authorization header:

Authorization: Bearer <API_TOKEN>

​
Example Requests

​
Using Node.js (fetch)

const makeAuthenticatedRequest = async () => {
  const response = await fetch('https://api-prod.extend.com/v1/workflow_runs/workflow_run_1234', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_TOKEN',
      'Content-Type': 'application/json',
      'Extend-Api-Version': '2024-11-14'
    }
  });
  
  return response.json();
};

​
Using cURL

curl -X GET https://api-prod.extend.com/v1/workflow_runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Extend-Api-Version: 2024-11-14"
  -d '{ ... }'

​
Error Handling

If authentication fails, you’ll receive a 401 Unauthorized response. Common causes include:

  • Missing the Authorization header
  • Invalid token format
  • Expired or revoked token
  • Insufficient permissions for the requested resource
API Versioning