Skip to main content

​
Authentication

The WithGiga API uses API keys to authenticate requests. You can view and manage your API keys in the WithGiga Dashboard.

​
Using the API Key

Every request to the API must include your API key in the Authorization HTTP header. 
Authorization: Bearer giga_sk_...
Keep your API keys secure. Do not share them in publicly accessible areas such as GitHub, client-side code, or public repositories.

​
Example Request

curl -X GET "https://api.withgiga.ai/api/sessions/{threadId}" \
  -H "Authorization: Bearer giga_sk_..."

​
Optional Headers

  • X-Client-Id (Optional): If you are building an application with multiple users, you can pass a client identifier to attribute usage logs to specific tenants.

​
Unauthorized Requests

Requests that lack valid credentials or contain revoked keys will return a 401 Unauthorized error. 
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid authorization token",
    "requestId": "uuid"
  }
}