# Warble API

**Canonical:** https://apis.io/apis/usewarble/usewarble-api/  
**Provider:** Warble — https://apis.io/providers/usewarble/  
**Base URL:** https://app.usewarble.com  
**Documentation:** https://usewarble.com/developers

Warble API is published by [Warble](https://apis.io/providers/usewarble/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Warble API as documented publicly: 22 operations. Contract generated from the documentation by API Evangelist (2026-11-02); not the provider's own document.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/ad-templates` | GET /api/v1/ad-templates |
| POST | `/api/v1/ads` | POST /api/v1/ads |
| POST | `/api/v1/carousels` | Start an async multi-slide carousel generation job. |
| GET | `/api/v1/credits` | Check the current credit balance and usage. |
| POST | `/api/v1/drafts` | Turn one master post body into native per-channel copy. |
| POST | `/api/v1/drop-links` | Requests a video drop link where a user can upload a video. |
| GET | `/api/v1/drop-links/{id}` | Where a drop link stands — waiting, checking, ready, refused or expired. |
| POST | `/api/v1/ideas` | Generate on-brand post ideas, grounded in the workspace’s voice and business profile. |
| POST | `/api/v1/images` | Generate an AI image for a post idea, returned as a hosted URL. |
| POST | `/api/v1/media` | POST /api/v1/media |
| GET | `/api/v1/performance` | Post-level metrics and totals — impressions, likes, engagement rate, clicks. |
| GET | `/api/v1/posts` | List posts for a workspace, newest-scheduled-first. |
| POST | `/api/v1/posts` | POST /api/v1/posts |
| POST | `/api/v1/posts/publish` | Publishes a post now (no future time). |
| PATCH | `/api/v1/posts/{id}` | Edits the text, reschedules, or cancels a post that hasn’t gone out yet. |
| POST | `/api/v1/posts/{id}/retry` | Retries a failed post via the provider‑aware path. |
| POST | `/api/v1/uploads` | POST /api/v1/uploads |
| GET | `/api/v1/uploads/{id}` | An upload’s status without changing anything: pending , processing , ready , failed or expired. |
| POST | `/api/v1/uploads/{id}/complete` | Finishes the upload and reports its status. |
| GET | `/api/v1/workspaces` | GET /api/v1/workspaces |
| GET | `/api/v1/workspaces/{id}/brand` | Voice profile, business summary, and content pillars — the grounding context an agent needs to write on-brand before calling /ideas or /drafts. |
| GET | `/api/v1/workspaces/{id}/channels` | Connected social channels for a workspace (platform, display name, status). |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/usewarble/openapi/_ae-authored/usewarble-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/usewarble/json-schema/usewarble-get-api-v1-ad-templates-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewarble/json-schema/usewarble-post-api-v1-uploads-id-complete-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewarble/json-schema/usewarble-patch-api-v1-posts-id-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewarble/json-schema/usewarble-post-api-v1-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewarble/json-schema/usewarble-post-api-v1-ads-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewarble/json-schema/usewarble-get-api-v1-workspaces-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/usewarble/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/usewarble/usewarble-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/usewarble/.