Skip to content
Warp

Reference > Errors

authentication_required

Open in ChatGPT ↗
Ask ChatGPT about this page
Open in Claude ↗
Ask Claude about this page
Copied!

The API key in the request is invalid, expired, or missing. Generate a new key and update your client configuration.

The authentication_required error occurs when the API request lacks valid authentication credentials.

Details

Section titled “Details”
  • HTTP Status: 401 Unauthorized
  • Retryable: No
  • Task State: ERROR

When does this occur?

Section titled “When does this occur?”

This error is returned when:

  • The Authorization header is missing from the request
  • The API key has been revoked or has expired
  • The API key is malformed or invalid

Example response

Section titled “Example response”
{
  "type": "/reference/api-and-sdk/troubleshooting/errors/authentication-required/",
  "title": "Your API key is invalid or has expired. Please generate a new key and try again.",
  "status": 401,
  "instance": "/api/v1/agent/tasks",
  "error": "Your API key is invalid or has expired. Please generate a new key and try again.",
  "retryable": false
}

How to resolve

Section titled “How to resolve”
  1. Generate a new API key from the Oz web app or via the Oz CLI.
  2. Update your client configuration with the new key.
  3. Retry the request.
Section titled “Related”