# API & SDK

- [Oz API & SDK](https://docs.warp.dev/reference/api-and-sdk/api-and-sdk.md): Create and inspect cloud agent runs over HTTP with the Oz API, or use the Python and TypeScript SDKs for typed requests, retries, and error handling.
- [API & SDK Quickstart](https://docs.warp.dev/reference/api-and-sdk/quickstart.md): Create and monitor your first cloud agent run via the Oz API or SDK in ~5 minutes.
- [Agent](https://docs.warp.dev/reference/api-and-sdk/agent.md)
- [Schedules](https://docs.warp.dev/reference/api-and-sdk/schedules.md)
- [Models](https://docs.warp.dev/reference/api-and-sdk/models.md)
- [Demo: Sentry monitoring with SDK](https://docs.warp.dev/reference/api-and-sdk/demo-sentry-monitoring-with-sdk.md): Build a Sentry webhook handler that triggers Oz agents to investigate errors and create draft PRs.
- [API Troubleshooting](https://docs.warp.dev/reference/api-and-sdk/troubleshooting.md): Troubleshooting resources for the Oz API and SDK, including a full reference for all platform error codes.
- [Errors](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors.md): Reference for all error codes returned by the Oz platform API. Each error includes an HTTP status, machine-readable code, and actionable resolution steps.
- [insufficient\_credits](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/insufficient-credits.md): Your team has exhausted all Add-on Credits for cloud agent usage. Purchase more credits from your team's billing settings to continue.
- [feature\_not\_available](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/feature-not-available.md): The requested feature is not included in your current plan. Upgrade your team's plan to access this capability.
- [external\_authentication\_required](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/external-authentication-required.md): The task requires access to an external service (GitHub, Slack, Linear, etc.) that hasn't been authorized. Follow the auth\_url to grant access.
- [not\_authorized](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/not-authorized.md): The authenticated user or API key does not have permission to perform the requested operation.
- [invalid\_request](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/invalid-request.md): The request body is malformed, missing required fields, or contains invalid parameter values.
- [resource\_not\_found](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/resource-not-found.md): The requested resource (task, environment, schedule, agent, etc.) does not exist or has been deleted.
- [budget\_exceeded](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/budget-exceeded.md): Your team's configured spending budget limit has been reached. Increase the budget or wait for the budget period to reset.
- [integration\_disabled](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/integration-disabled.md): The integration (Slack, Linear, etc.) is currently disabled in the Oz settings. Enable it to continue.
- [integration\_not\_configured](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/integration-not-configured.md): The integration's setup is incomplete. Visit the setup URL to finish configuring the integration.
- [operation\_not\_supported](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/operation-not-supported.md): The requested operation is not supported for this resource or its current state.
- [environment\_setup\_failed](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed.md): The cloud agent's environment failed to initialize. Check repo URLs, setup commands, and working directory paths.
- [content\_policy\_violation](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/content-policy-violation.md): The task prompt or environment setup commands were flagged by the platform's automated content policy checks.
- [conflict](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/conflict.md): The request conflicts with the current state of the resource. Wait for the resource to reach the expected state and retry.
- [authentication\_required](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/authentication-required.md): The API key in the request is invalid, expired, or missing. Generate a new key and update your client configuration.
- [resource\_unavailable](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/resource-unavailable.md): A transient infrastructure issue prevented the task from running. The platform will automatically retry. No action is needed.
- [internal\_error](https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/internal-error.md): An unexpected server-side error occurred. The platform will automatically retry. Contact support if the issue persists.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.warp.dev/reference/api-and-sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
