Error Reference

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has been revoked.",
    "type": "authentication_error",
    "param": null
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "The 'model' field is required.",
    "type": "invalid_request_error",
    "param": "model"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid.",
    "type": "authentication_error"
  }
}

# Check your API key is set
import os
api_key = os.environ.get("ISA_API_KEY")
if not api_key or not api_key.startswith("isa_"):
    raise ValueError("ISA_API_KEY must be set and start with 'isa_'")

{
  "error": {
    "code": "insufficient_permissions",
    "message": "Your role does not have permission: models.deploy",
    "type": "permission_error"
  }
}

{
  "error": {
    "code": "resource_not_found",
    "message": "Agent 'agent_abc123' not found.",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": "conflict",
    "message": "An agent with this name already exists.",
    "type": "conflict_error"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "temperature must be between 0 and 2",
    "type": "validation_error",
    "param": "temperature"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 2 seconds.",
    "type": "rate_limit_error"
  }
}

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1714003200
Retry-After: 2

import time
import requests
 
def call_with_retry(url, payload, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(url, json=payload, headers=headers)
        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 2 ** attempt))
            time.sleep(retry_after)
            continue
        return response
    raise Exception("Max retries exceeded")

async function callWithRetry(url: string, payload: unknown, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const res = await fetch(url, { method: 'POST', body: JSON.stringify(payload), headers });
    if (res.status === 429) {
      const retryAfter = parseInt(res.headers.get('Retry-After') || String(2 ** attempt));
      await new Promise(r => setTimeout(r, retryAfter * 1000));
      continue;
    }
    return res;
  }
  throw new Error('Max retries exceeded');
}

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred. Please try again.",
    "type": "server_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "The model service is temporarily unavailable.",
    "type": "server_error"
  }
}