Skip to main content

​
Authentication

All API endpoints require JWT Bearer token authentication. 
"Authorization": "Bearer <YOUR_JWT_TOKEN>"

​
Obtaining JWT Tokens

To get a JWT token for API authentication, use the OAuth2 client credentials flow: 
import requests

# OAuth2 client credentials parameters
params = {
    'client_id': '<YOUR_CLIENT_ID>',
    'client_secret': '<YOUR_CLIENT_SECRET>',
    'grant_type': 'client_credentials',
    'scope': 'openid profile email',
}

# Request access token
response = requests.post(
    'https://auth.withblast.com/oauth2/token',
    headers={'Content-Type': 'application/x-www-form-urlencoded'},
    data=params
)

# Extract the access token
access_token = response.json()['access_token']

# Use the token in API requests
headers = {
    'Authorization': f'Bearer {access_token}'
}
Keep your client credentials secure. Never expose them in client-side code or public repositories.

​
OAuth2 Token URL

https://auth.withblast.com/oauth2/token

​
API Base URL

https://api.withblast.com

​
Resources

The API is organized around the following main resources:

Projects

Manage projects and access control

Benchmarks

Create and manage benchmark datasets

Simulations

Run AI simulations with various parameters

Evaluators

Available evaluation metrics

Tags

Organize simulations with tags

​
Pagination

List endpoints support pagination with offset and limit query parameters:
  • offset: Number of items to skip (default: 0)
  • limit: Number of items to return (default: 20, max: 100)
Example: 
GET /projects/{project_id}/benchmarks?offset=20&limit=10