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.

GitHub OpenAPI

Operations 22

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. #
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). #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/usewarble/openapi/_ae-authored/usewarble-openapi-generated.yml

Schemas & Data

📊
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

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/usewarble/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/usewarble:usewarble-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

usewarble-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Warble API
  version: '2026-11-02'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-02: 22 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Warble has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 6
    documentation: 16
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-02'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://usewarble.com/developers
  - https://usewarble.com/integrations/mcp
servers:
- url: https://app.usewarble.com
paths:
  /api/v1/ad-templates:
    get:
      operationId: get_api_v1_ad_templates
      tags:
      - Api
      summary: GET /api/v1/ad-templates
      x-source: https://usewarble.com/developers
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1AdTemplatesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://app.usewarble.com/api/v1/ad-templates  -H \"Authorization: Bearer $WARBLE_API_KEY\" \n Response — 200 (3 entries\
          \ shown) Copy {\n \"templates\": [\n {\n \"id\": \"offer-promo-hero\",\n \"name\": \"Offer / Promotion\",\n \"category\": \"headline-offer\"\
          ,\n \"intent\": \"The money-maker. Test your core offer.\",\n \"aspect_ratios\": [\"9:16\", \"1:1\"],\n \"capabilities\": {\n \"needsProductPhoto\"\
          : true,\n \"ugcNative\": false,\n"
  /api/v1/ads:
    post:
      operationId: post_api_v1_ads
      tags:
      - Api
      summary: POST /api/v1/ads
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AdsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1AdsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://app.usewarble.com/api/v1/ads  -H \"Authorization: Bearer $WARBLE_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\n \"workspace_id\": \"5b8f19a2-6e2d-4d7b-9d0a-1f7c9e2a44f0\",\n \"template_id\": \"text-message-convo\",\n \"aspect\": \"4:5\"\
          ,\n \"brief\": \"Same-day peony bouquets. Order by 2pm for delivery today.\"\n }' \n Response — 200 (example values) Copy {\n \"url\"\
          : \"https://cdn.example.com/9c41e07b2"
  /api/v1/carousels:
    post:
      operationId: post_api_v1_carousels
      tags:
      - Api
      summary: Start an async multi-slide carousel generation job.
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CarouselsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1CarouselsResponse'
      x-evidence:
        kind: documentation
  /api/v1/credits:
    get:
      operationId: get_api_v1_credits
      tags:
      - Api
      summary: Check the current credit balance and usage.
      x-source: https://usewarble.com/developers
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CreditsResponse'
      x-evidence:
        kind: documentation
  /api/v1/drafts:
    post:
      operationId: post_api_v1_drafts
      tags:
      - Api
      summary: Turn one master post body into native per-channel copy.
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1DraftsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1DraftsResponse'
      x-evidence:
        kind: documentation
  /api/v1/drop-links:
    post:
      operationId: post_api_v1_drop_links
      tags:
      - Api
      summary: Requests a video drop link where a user can upload a video.
      x-source: https://usewarble.com/developers
      parameters:
      - name: workspace_id
        in: query
        required: true
        schema:
          type: string
        description: ID of the workspace.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1DropLinksRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1DropLinksResponse'
      x-evidence:
        kind: documentation
  /api/v1/drop-links/{id}:
    get:
      operationId: get_api_v1_drop_links_id
      tags:
      - Api
      summary: Where a drop link stands — waiting, checking, ready, refused or expired.
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/ideas:
    post:
      operationId: post_api_v1_ideas
      tags:
      - Api
      summary: Generate on-brand post ideas, grounded in the workspace’s voice and business profile.
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1IdeasRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1IdeasResponse'
      x-evidence:
        kind: documentation
  /api/v1/images:
    post:
      operationId: post_api_v1_images
      tags:
      - Api
      summary: Generate an AI image for a post idea, returned as a hosted URL.
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ImagesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ImagesResponse'
      x-evidence:
        kind: documentation
  /api/v1/media:
    post:
      operationId: post_api_v1_media
      tags:
      - Api
      summary: POST /api/v1/media
      x-source: https://usewarble.com/developers
      parameters:
      - name: workspace_id
        in: query
        required: true
        schema:
          type: string
        description: ID of the workspace.
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: External image URL to import.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1MediaRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1MediaResponse'
      x-evidence:
        kind: documentation
  /api/v1/performance:
    get:
      operationId: get_api_v1_performance
      tags:
      - Api
      summary: Post-level metrics and totals — impressions, likes, engagement rate, clicks.
      x-source: https://usewarble.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/posts:
    get:
      operationId: get_api_v1_posts
      tags:
      - Api
      summary: List posts for a workspace, newest-scheduled-first.
      x-source: https://usewarble.com/developers
      parameters:
      - name: workspace_id
        in: query
        required: true
        schema:
          type: string
      - name: status
        in: query
        required: false
        schema:
          type: string
      - name: release_id
        in: query
        required: false
        schema:
          type: string
      - name: ids
        in: query
        required: false
        schema:
          type: string
      - name: since
        in: query
        required: false
        schema:
          type: string
      - name: until
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: before
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1PostsResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_posts
      tags:
      - Api
      summary: POST /api/v1/posts
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PostsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1PostsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://app.usewarble.com/api/v1/posts  -H \"Authorization: Bearer $WARBLE_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -H \"Idempotency-Key: sched-5b8f19a2-peony-video-2026-10-03T15:00:00Z\"  -d '{\n \"workspace_id\": \"5b8f19a2-6e2d-4d7b-9d0a-1f7c9e2a44f0\"\
          ,\n \"body\": \"Building the Saturday peony arrangement, start to finish.\",\n \"channels\": [\"instagram\", \"facebook\", \"tiktok\"\
          , \"youtube\"],\n \"schedul"
  /api/v1/posts/publish:
    post:
      operationId: post_api_v1_posts_publish
      tags:
      - Api
      summary: Publishes a post now (no future time).
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PostsPublishRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1PostsPublishResponse'
      x-evidence:
        kind: documentation
  /api/v1/posts/{id}:
    patch:
      operationId: patch_api_v1_posts_id
      tags:
      - Api
      summary: Edits the text, reschedules, or cancels a post that hasn’t gone out yet.
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiV1PostsIdRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchApiV1PostsIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/posts/{id}/retry:
    post:
      operationId: post_api_v1_posts_id_retry
      tags:
      - Api
      summary: Retries a failed post via the provider‑aware path.
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PostsIdRetryRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1PostsIdRetryResponse'
      x-evidence:
        kind: documentation
  /api/v1/uploads:
    post:
      operationId: post_api_v1_uploads
      tags:
      - Api
      summary: POST /api/v1/uploads
      x-source: https://usewarble.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1UploadsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1UploadsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://app.usewarble.com/api/v1/uploads  -H \"Authorization: Bearer $WARBLE_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\n \"workspace_id\": \"5b8f19a2-6e2d-4d7b-9d0a-1f7c9e2a44f0\",\n \"filename\": \"peony-arrangement.mov\",\n \"content_type\"\
          : \"video/quicktime\",\n \"bytes\": 48213904\n }'"
  /api/v1/uploads/{id}:
    get:
      operationId: get_api_v1_uploads_id
      tags:
      - Api
      summary: 'An upload’s status without changing anything: pending , processing , ready , failed or expired.'
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1UploadsIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/uploads/{id}/complete:
    post:
      operationId: post_api_v1_uploads_id_complete
      tags:
      - Api
      summary: Finishes the upload and reports its status.
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1UploadsIdCompleteResponse'
      x-evidence:
        kind: documentation
  /api/v1/workspaces:
    get:
      operationId: get_api_v1_workspaces
      tags:
      - Api
      summary: GET /api/v1/workspaces
      x-source: https://usewarble.com/developers
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1WorkspacesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://app.usewarble.com/api/v1/workspaces  -H \"Authorization: Bearer $WARBLE_API_KEY\" \n Response — 200 Copy {\n \"\
          workspaces\": [\n {\n \"id\": \"5b8f19a2-6e2d-4d7b-9d0a-1f7c9e2a44f0\",\n \"name\": \"Wildflower Co.\",\n \"type\": \"business\"\n },\n\
          \ {\n \"id\": \"e1c47a90-3f2b-4c8e-a615-9b0d2f7e4c13\",\n \"name\": \"Ash Street Pizza\",\n \"type\": \"business\"\n },\n {\n \"id\"\
          : \"7d2e5b18-a94c-4f60-8b3e-c51f0a6d9e27\",\n \"name\": \"Ke"
  /api/v1/workspaces/{id}/brand:
    get:
      operationId: get_api_v1_workspaces_id_brand
      tags:
      - Api
      summary: Voice profile, business summary, and content pillars — the grounding context an agent needs to write on-brand before calling /ideas
        or /drafts.
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1WorkspacesIdBrandResponse'
      x-evidence:
        kind: documentation
  /api/v1/workspaces/{id}/channels:
    get:
      operationId: get_api_v1_workspaces_id_channels
      tags:
      - Api
      summary: Connected social channels for a workspace (platform, display name, status).
      x-source: https://usewarble.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1WorkspacesIdChannelsResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1AdTemplatesResponse:
      type: object
      properties:
        templates:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              category:
                type: string
              intent:
                type: string
              aspect_ratios:
                type: array
                items:
                  type: string
              capabilities:
                type: object
                properties:
                  needsProductPhoto:
                    type: boolean
                  ugcNative:
                    type: boolean
                  textHeavy:
                    type: boolean
              recommended_model_class:
                type: string
              kind:
                type: string
              needs_product_photo:
                type: boolean
              detail_fields:
                type: array
                items:
                  type: object
                  properties:
                    key:
                      type: string
                    label:
                      type: string
                    required:
                      type: boolean
                    hint:
                      type: string
                    owner_fact:
                      type: boolean
    PostApiV1AdsRequest:
      type: object
      properties:
        workspace_id:
          type: string
        template_id:
          type: string
        aspect:
          type: string
        brief:
          type: string
    PostApiV1AdsResponse:
      type: object
      properties:
        url:
          type: string
        model:
          type: string
        model_class:
          type: string
        template_id:
          type: string
        aspect:
          type: string
        prompt:
          type: string
    PostApiV1CarouselsRequest:
      type: object
      properties:
        workspace_id:
          type: string
        topic:
          type: string
      required:
      - workspace_id
      - topic
    PostApiV1CarouselsResponse:
      type: object
      properties:
        job_id:
          type: string
        poll_after_ms:
          type: integer
    GetApiV1CreditsResponse:
      type: object
      properties:
        balance:
          type: integer
        spent_24h:
          type: integer
        daily_cap:
          type: integer
          description: Null if uncapped.
    PostApiV1DraftsRequest:
      type: object
      properties:
        workspace_id:
          type: string
        body:
          type: string
        channels:
          type: array
      required:
      - workspace_id
      - body
      - channels
    PostApiV1DraftsResponse:
      type: object
      properties:
        body_by_channel:
          type: object
        compliance:
          type: object
    PostApiV1DropLinksRequest:
      type: object
      properties:
        workspace_id:
          type: string
      required:
      - workspace_id
    PostApiV1DropLinksResponse:
      type: object
      properties:
        id:
          type: string
          description: Drop‑link identifier.
        url:
          type: string
          description: URL the user should visit to drop a video.
    PostApiV1IdeasRequest:
      type: object
      properties:
        workspace_id:
          type: string
        topic:
          type: string
        count:
          type: integer
      required:
      - workspace_id
    PostApiV1IdeasResponse:
      type: object
      properties:
        ideas:
          type: array
        compliance:
          type: array
    PostApiV1ImagesRequest:
      type: object
      properties:
        workspace_id:
          type: string
        idea:
          type: string
        model:
          type: string
      required:
      - workspace_id
      - idea
    PostApiV1ImagesResponse:
      type: object
      properties:
        url:
          type: string
        model:
          type: string
        prompt:
          type: string
    PostApiV1MediaRequest:
      type: object
      properties:
        workspace_id:
          type: string
        url:
          type: string
      required:
      - workspace_id
      - url
    PostApiV1MediaResponse:
      type: object
      properties:
        id:
          type: string
        url:
          type: string
    GetApiV1PostsResponse:
      type: object
      properties:
        posts:
          type: array
        next_cursor:
          type: string
    PostApiV1PostsRequest:
      type: object
      properties:
        workspace_id:
          type: string
        body:
          type: string
        channels:
          type: array
          items:
            type: string
        scheduled_at:
          type: string
          format: date-time
        video_url:
          type: string
    PostApiV1PostsResponse:
      type: object
      properties:
        drop_id:
          type: string
        drop_url:
          type: string
        expires_at:
          type: string
          format: date-time
        assistant:
          type: string
    PostApiV1PostsPublishRequest:
      type: object
      properties:
        workspace_id:
          type: string
        body:
          type: string
        channels:
          type: array
      required:
      - workspace_id
      - body
      - channels
    PostApiV1PostsPublishResponse:
      type: object
      properties:
        release_id:
          type: string
        posts:
          type: array
    PatchApiV1PostsIdRequest:
      type: object
      properties:
        body:
          type: string
          description: New full text.
        scheduled_at:
          type: string
          description: New ISO‑8601 timestamp.
        cancel:
          type: boolean
          description: Set true to cancel the post.
    PatchApiV1PostsIdResponse:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        scheduled_at:
          type: string
        cancelled:
          type: boolean
    PostApiV1PostsIdRetryRequest:
      type: object
      properties:
        mode:
          type: string
          description: '"provider-retry" or "requeue".'
    PostApiV1PostsIdRetryResponse:
      type: object
      properties:
        id:
          type: string
        mode:
          type: string
    PostApiV1UploadsRequest:
      type: object
      properties:
        workspace_id:
          type: string
        filename:
          type: string
        content_type:
          type: string
        bytes:
          type: integer
    PostApiV1UploadsResponse:
      type: object
      properties:
        drop_id:
          type: string
        drop_url:
          type: string
        expires_at:
          type: string
          format: date-time
        assistant:
          type: string
    GetApiV1UploadsIdResponse:
      type: object
      properties:
        upload_id:
          type: string
        status:
          type: string
        url:
          type: string
        reason:
          type: string
        poll_after_ms:
          type: integer
    PostApiV1UploadsIdCompleteResponse:
      type: object
      properties:
        upload_id:
          type: string
        status:
          type: string
        reason:
          type: string
          description: Present when status is failed.
        url:
          type: string
          description: Video URL when status is ready.
        poll_after_ms:
          type: integer
          description: When to poll again if still processing.
    GetApiV1WorkspacesResponse:
      type: object
      properties:
        workspaces:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              type:
                type: string
    GetApiV1WorkspacesIdBrandResponse:
      type: object
      properties:
        workspace_id:
          type: string
        voice:
          type: string
        business_profile:
          type: object
        compliance:
          type: object
    GetApiV1WorkspacesIdChannelsResponse:
      type: object
      properties:
        channels:
          type: array
        platform:
          type: string
        display_name:
          type: string
        status:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api