CreativeClaw OAuth API

openapi: 3.2.0
info:
  title: Creativeclaw Co OAuth API
  version: 0.3.0
  contact:
    name: CreativeClaw
    email: hello@creativeclaw.co
    url: https://creativeclaw.co
  license:
    name: Proprietary
    url: https://creativeclaw.co/terms/
  termsOfService: https://creativeclaw.co/terms/
  description: 'Operations tagged OAuth across 2 of this provider''s published API definitions: creativeclaw-co-openapi.json, creativeclaw-co-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.creativeclaw.co
  description: Production MCP host
security:
- oauth2:
  - profile
  - email
tags:
- name: OAuth
  description: RFC 8414 / RFC 9728 discovery. Used by MCP clients before the first authenticated call.
paths:
  /.well-known/oauth-protected-resource/mcp:
    get:
      tags:
      - OAuth
      operationId: getProtectedResourceMetadata
      summary: OAuth protected resource metadata (RFC 9728)
      security: []
      responses:
        '200':
          description: Resource identifier, authorization servers, and supported scopes (`profile`, `email`).
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
    servers:
    - url: https://app.creativeclaw.co
      description: Production MCP host
  /.well-known/oauth-authorization-server:
    get:
      tags:
      - OAuth
      operationId: getAuthorizationServerMetadata
      summary: OAuth authorization server metadata (RFC 8414)
      description: Proxied from Clerk with `scopes_supported` pinned to `profile` and `email`. Dynamic clients must not request `openid`.
      security: []
      responses:
        '200':
          description: Authorization, token, registration, and JWKS URLs.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
    servers:
    - url: https://app.creativeclaw.co
      description: Production MCP host
  /.well-known/openid-configuration:
    get:
      tags:
      - OAuth
      operationId: getOpenIdConfiguration
      summary: OpenID Provider configuration
      security: []
      responses:
        '200':
          description: Same Clerk issuer metadata with MCP-safe scopes.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
    servers:
    - url: https://app.creativeclaw.co
      description: Production MCP host
components:
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.1 authorization code with PKCE S256. Dynamic client registration is supported. Request only `profile` and `email`.
      flows:
        authorizationCode:
          authorizationUrl: https://clerk.creativeclaw.co/oauth/authorize
          tokenUrl: https://clerk.creativeclaw.co/oauth/token
          refreshUrl: https://clerk.creativeclaw.co/oauth/token
          scopes:
            profile: Read the authenticated user profile
            email: Read the authenticated user email
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Access token from the Clerk token endpoint, sent as `Authorization: Bearer <token>`.'
externalDocs:
  description: Developer and agent documentation
  url: https://creativeclaw.co/developers/
x-refined-from:
- creativeclaw-co-openapi.json
- creativeclaw-co-openapi.yml
x-mcp-endpoint: https://app.creativeclaw.co/mcp
x-mcp-transport: streamable-http
x-pkce: S256
x-mcp-tools:
- name: swap_video_characters
  summary: Swap people or characters in an existing video (up to 30 seconds) from reference photos or saved Characters with Seedance 2.5, keeping motion, cuts and audio. Free image previews first; 480p draft by default, 720p or 1080p direct.
  category: edit
  async: true
- name: update_video_workflow
  summary: Change one free preview of a video workflow, such as a character swap, before its paid render.
  category: edit
- name: generate_image
  summary: 'Generate or edit an image. Default model: Nano Banana 2.'
  category: generate
- name: generate_video
  summary: 'Generate, animate, extend, or edit video. Default model: Gemini Omni Flash.'
  category: generate
  async: true
- name: generate_speech
  summary: 'Generate speech or dialogue. Default model: ElevenLabs v4.'
  category: generate
- name: compare_models
  summary: Run one image prompt through 2–4 image models side by side.
  category: generate
- name: list_models
  summary: List current image, video, speech, and upscale models. Filter by category.
  category: discover
- name: get_model_params
  summary: Read a model’s live schema, defaults, enums, and extras.
  category: discover
- name: render_html_image
  summary: Render HTML/CSS to a PNG via the branded layout engine.
  category: layout
- name: render_html_video
  summary: Render code-driven HTML motion to MP4. Returns a job ID.
  category: layout
  async: true
- name: create_template
  summary: Create a reusable HTML or generative template.
  category: layout
- name: render_template
  summary: Render a saved template with parameter values.
  category: layout
- name: update_template
  summary: Patch an existing template’s fields.
  category: layout
- name: list_templates
  summary: List saved templates for the account.
  category: layout
- name: transcribe
  summary: Transcribe audio or video with word-level timestamps.
  category: edit
  async: true
- name: isolate_audio
  summary: Remove noise, music, and reverb from a voice recording.
  category: edit
  async: true
- name: upscale_image
  summary: 'Upscale an image: image_url, a model id such as upscale/aura-sr (default), and model-specific extras. list_models({category:"upscale"}) lists the models; get_model_params gives each model’s extras.'
  category: edit
- name: upscale_video
  summary: 'Upscale a video: video_url, a model id such as upscale/bytedance (default), and model-specific extras. list_models({category:"upscale"}) lists the models; get_model_params gives each model’s extras.'
  category: edit
- name: increase_frame_rate
  summary: 'Raise a video’s frame rate or make slow motion by generating in-between frames: video_url, a model id such as frame-interpolation/topaz-apollo (default), and extras target_fps, slowdown_factor. list_models({category:"frame_interpolation"}) lists the models.'
  category: edit
  async: true
- name: trim_video
  summary: Cut a time range from a video.
  category: edit
- name: scale_video
  summary: Resize, crop, or pad a video.
  category: edit
- name: add_subtitles
  summary: Burn captions onto a video.
  category: edit
- name: remove_background
  summary: 'Remove the background from an image or video: media_url, type, an optional model such as background-removal/bria-v3 (video default) or background-removal/veed (semi-transparent subjects), extras, and output_format webm, mp4 or prores. list_models({category:"background_removal"}) lists the models.'
  category: edit
- name: extract_frames
  summary: Extract still frames from a video.
  category: edit
- name: merge_media
  summary: Concatenate videos or audio, or mix an audio track onto video.
  category: edit
  async: true
- name: create_character
  summary: Create a Character with a reference image and optional voice.
  category: characters
- name: update_character
  summary: Update a Character, its reference image, or its saved voices.
  category: characters
- name: clone_voice
  summary: Attach a consented voice clone to an existing Character.
  category: characters
- name: list_characters
  summary: List reusable Characters and IDs.
  category: characters
- name: delete_character
  summary: Permanently delete a Character and its saved voices.
  category: characters
- name: create_film_project
  summary: Create a multi-shot Film project.
  category: film
- name: update_film_project
  summary: Save script, shots, storyboards, clips, and approval state.
  category: film
- name: get_film_project
  summary: Inspect one Film project.
  category: film
- name: list_film_projects
  summary: List Film projects for the account.
  category: film
- name: assemble_film
  summary: Merge approved clips and audio into the final Film.
  category: film
- name: list_themes
  summary: List brand themes and the default theme.
  category: brand
- name: get_theme
  summary: Fetch the default or named brand theme.
  category: brand
- name: update_theme
  summary: Create or update a brand theme, or open the visual editor.
  category: brand
- name: delete_theme
  summary: Soft-delete a brand theme.
  category: brand
- name: search_assets
  summary: Search the permanent asset library by type, query, tags, or name.
  category: assets
- name: show_media
  summary: Display workspace images, videos, and audio by asset ID, job ID, or Creative Claw CDN URL.
  category: assets
- name: update_asset
  summary: Set a unique name, replace tags, or update a description.
  category: assets
- name: delete_asset
  summary: Soft-delete an asset.
  category: assets
- name: load_image
  summary: Load an image URL inline for visual review.
  category: assets
- name: import_media
  summary: Open the media picker when the user still needs to choose a file.
  category: assets
- name: import_chatgpt_media
  summary: Convert a ChatGPT attachment into a durable CreativeClaw asset (ChatGPT only).
  category: assets
- name: get_upload_url
  summary: Mint a signed upload URL for clients that can HTTP PUT bytes.
  category: assets
- name: confirm_upload
  summary: Finalize a signed upload into the asset library.
  category: assets
- name: upload_asset
  summary: Copy a public, directly downloadable URL into the library.
  category: assets
- name: check_job
  summary: Poll an async job by job_id until it completes or fails.
  category: billing
- name: get_credits_balance
  summary: Read remaining credits and optionally estimate a generation cost.
  category: billing
- name: get_credits_link
  summary: Return a user-operated Polar checkout link for credit top-up.
  category: billing
- name: purchase_credits
  summary: 'Start a credit purchase. Packs: 1000/$10, 5000/$50, 11000/$100, 27500/$250.'
  category: billing
- name: submit_feedback
  summary: Send product feedback (bug, missing feature, praise) to the team.
  category: billing