# Docs Birdy — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Docs Birdy provides 3 callable API endpoints through the Parse marketplace.

**Category:** Developer Tools | **Website:** [docs.birdy.chat/openapi.json](https://docs.birdy.chat/openapi.json) | **Docs:** [parse.bot/marketplace/b7376a6e-a2d6-400a-a01d-97e5c9b80756/docs-birdy-chat-api](https://parse.bot/marketplace/b7376a6e-a2d6-400a-a01d-97e5c9b80756/docs-birdy-chat-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-docs-birdy-chat-api-b7376a6e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_api_overview

Returns a high-level overview of all BirdyChat API operations grouped by tag, including authentication details, rate limits, webhook information, server URL, and the complete list of operations with their IDs, HTTP methods, paths, and summaries. One round trip to the public OpenAPI spec.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-docs-birdy-chat-api-b7376a6e/get_api_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_operation_detail

Returns full details for a specific API operation by its operation_id, including HTTP method, path, parameters with schemas, request body fields, and response schemas with field definitions. One round trip to the public OpenAPI spec.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `operation_id` | string | Yes | The operationId of the API operation to retrieve (e.g. createIntegration, listThreadMessages, addThreadUsers). Available operation IDs can be discovered via get_api_overview. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-docs-birdy-chat-api-b7376a6e/get_operation_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation_id":"<string>"}'
```

### get_schema_detail

Returns the full definition of a named component schema from the OpenAPI spec, including all fields with types, required status, descriptions, patterns, enums, and one level of nested schema resolution. One round trip to the public OpenAPI spec.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `schema_name` | string | Yes | Name of the component schema to retrieve (e.g. Thread, Message, Channel, User, Integration, Event, WebhookEvent). Available schema names are listed in the error message when an invalid name is provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-docs-birdy-chat-api-b7376a6e/get_schema_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"schema_name":"<string>"}'
```