How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Warble

Warble API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

Warble API is published by Warble on the 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.

This API exposes 22 operations across 21 paths, and defines 32 schemas. It is described by OpenAPI 3.1.0, at version 2026-11-02.

Requests are made against a single base URL, https://app.usewarble.com.

22 operations 21 paths 32 schemas 9 GET1 PATCH12 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-11-02
Base URL
https://app.usewarble.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Warble API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearer). By default, every request must be authenticated.

Paths & Operations 22

Across 21 paths, the API surfaces 22 operations — 9 GET, 1 PATCH, 12 POST. Each is listed below with its method, path, parameters, and response codes.

Api 22
GET
/api/v1/ad-templates
GET /api/v1/ad-templates
get_api_v1_ad_templates → 200
POST
/api/v1/ads
POST /api/v1/ads
post_api_v1_ads body → 201
POST
/api/v1/carousels
Start an async multi-slide carousel generation job.
post_api_v1_carousels body → 201
GET
/api/v1/credits
Check the current credit balance and usage.
get_api_v1_credits → 200
POST
/api/v1/drafts
Turn one master post body into native per-channel copy.
post_api_v1_drafts body → 201
POST
/api/v1/drop-links
Requests a video drop link where a user can upload a video.
post_api_v1_drop_links 1 param body → 201
GET
/api/v1/drop-links/{id}
Where a drop link stands — waiting, checking, ready, refused or expired.
get_api_v1_drop_links_id 1 param → 200
POST
/api/v1/ideas
Generate on-brand post ideas, grounded in the workspace’s voice and business profile.
post_api_v1_ideas body → 201
POST
/api/v1/images
Generate an AI image for a post idea, returned as a hosted URL.
post_api_v1_images body → 201
POST
/api/v1/media
POST /api/v1/media
post_api_v1_media 2 params body → 201
GET
/api/v1/performance
Post-level metrics and totals — impressions, likes, engagement rate, clicks.
get_api_v1_performance → 200
GET
/api/v1/posts
List posts for a workspace, newest-scheduled-first.
get_api_v1_posts 8 params → 200
POST
/api/v1/posts
POST /api/v1/posts
post_api_v1_posts body → 201
POST
/api/v1/posts/publish
Publishes a post now (no future time).
post_api_v1_posts_publish body → 201
PATCH
/api/v1/posts/{id}
Edits the text, reschedules, or cancels a post that hasn’t gone out yet.
patch_api_v1_posts_id 1 param body → 200
POST
/api/v1/posts/{id}/retry
Retries a failed post via the provider‑aware path.
post_api_v1_posts_id_retry 1 param body → 201
POST
/api/v1/uploads
POST /api/v1/uploads
post_api_v1_uploads body → 201
GET
/api/v1/uploads/{id}
An upload’s status without changing anything: pending , processing , ready , failed or expired.
get_api_v1_uploads_id 1 param → 200
POST
/api/v1/uploads/{id}/complete
Finishes the upload and reports its status.
post_api_v1_uploads_id_complete 1 param → 201
GET
/api/v1/workspaces
GET /api/v1/workspaces
get_api_v1_workspaces → 200
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_brand 1 param → 200
GET
/api/v1/workspaces/{id}/channels
Connected social channels for a workspace (platform, display name, status).
get_api_v1_workspaces_id_channels 1 param → 200

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are PostApiV1AdsResponse (6 properties), GetApiV1UploadsIdResponse (5 properties), PostApiV1PostsRequest (5 properties), PostApiV1UploadsIdCompleteResponse (5 properties). Each schema is shown below with its type and property counts.

GetApiV1AdTemplatesResponse
object
1 property
PostApiV1AdsRequest
object
4 properties
PostApiV1AdsResponse
object
6 properties
PostApiV1CarouselsRequest
object
2 properties 2 required
PostApiV1CarouselsResponse
object
2 properties
GetApiV1CreditsResponse
object
3 properties
PostApiV1DraftsRequest
object
3 properties 3 required
PostApiV1DraftsResponse
object
2 properties
PostApiV1DropLinksRequest
object
1 property 1 required
PostApiV1DropLinksResponse
object
2 properties
PostApiV1IdeasRequest
object
3 properties 1 required
PostApiV1IdeasResponse
object
2 properties
PostApiV1ImagesRequest
object
3 properties 2 required
PostApiV1ImagesResponse
object
3 properties
PostApiV1MediaRequest
object
2 properties 2 required
PostApiV1MediaResponse
object
2 properties
GetApiV1PostsResponse
object
2 properties
PostApiV1PostsRequest
object
5 properties
PostApiV1PostsResponse
object
4 properties
PostApiV1PostsPublishRequest
object
3 properties 3 required
PostApiV1PostsPublishResponse
object
2 properties
PatchApiV1PostsIdRequest
object
3 properties
PatchApiV1PostsIdResponse
object
4 properties
PostApiV1PostsIdRetryRequest
object
1 property
PostApiV1PostsIdRetryResponse
object
2 properties
PostApiV1UploadsRequest
object
4 properties
PostApiV1UploadsResponse
object
4 properties
GetApiV1UploadsIdResponse
object
5 properties
PostApiV1UploadsIdCompleteResponse
object
5 properties
GetApiV1WorkspacesResponse
object
1 property
GetApiV1WorkspacesIdBrandResponse
object
4 properties
GetApiV1WorkspacesIdChannelsResponse
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

usewarble-openapi-generated.yml Raw ↑
← Back to W APIs
API Details
ID
usewarble:usewarble-api
Base URL
https://app.usewarble.com
Docs
https://usewarble.com/developers
Provider
Warble
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=usewarble-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/usewarble-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Warble API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.