API Setup
Tokens API
API reference for managing API tokens
List Tokens
Retrieve a list of all API tokens for your organization.
GET /api/v1/tokensResponse
[
{
"id": "token_id",
"key": "abcd1234...wxyz9876",
"description": "Development API Key",
"createdAt": "2024-02-14T10:00:00Z"
}
]Create Token
Create a new API token for your organization.
POST /api/v1/tokensRequest Body
{
"description": "Development API Key"
}Response
{
"id": "token_id",
"key": "your_new_api_key",
"description": "Development API Key",
"createdAt": "2024-02-14T10:00:00Z"
}Delete Token
Delete an existing API token.
DELETE /api/v1/tokens/{token_id}Parameters
| Parameter | Type | Description |
|---|---|---|
| token_id | string | The ID of the token to delete |
Response
Returns a 204 No Content response on successful deletion.
Error Responses
| Status Code | Description |
|---|---|
| 400 | Bad Request - Invalid input parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 404 | Not Found - Token or organization not found |
| 500 | Internal Server Error |
Security
- All endpoints require authentication using a valid API key
- Tokens are organization-specific
- Token keys are masked in list responses for security
- Default tokens cannot be deleted