AudioStack API

openapi: 3.1.0
info:
  title: AudioStack API
  version: '2026-10-14'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-14: 4 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; AudioStack has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 1
    pages-with-code: 3
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-14'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.audiostack.ai/reference
  - https://docs.audiostack.ai/reference/story-1
  - https://docs.audiostack.ai/reference/getstory
  - https://docs.audiostack.ai/reference/poststory
  - https://docs.audiostack.ai/reference/getstory.md
  - https://docs.audiostack.ai/reference/authentication
  - https://docs.audiostack.ai/reference/authentication.md
servers:
- url: https://v2.api.audio
paths:
  /content/media:
    get:
      operationId: get_content_media
      tags:
      - Content
      summary: GET /content/media
      x-source: https://docs.audiostack.ai/reference/authentication.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl --request GET  --url ''https://v2.api.audio/content/media''  --header ''Accept: application/json''  --header ''x-api-key:
          APIKEY''

          ```'
  /content/script:
    post:
      operationId: post_content_script
      tags:
      - Content
      summary: POST /content/script
      x-source: https://docs.audiostack.ai/reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostContentScriptRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X 'POST'  'https://v2.api.audio/content/script'  -H 'accept: application/json'  -H 'x-api-key: APIKEY'  -H 'Content-Type:\
          \ application/json'  -d '{\n \"projectName\": \"myFirstAudioProject\",\n \"moduleName\": \"admodule\",\n \"scriptName\": \"script1\"\
          ,\n \"scriptText\": \"Got my first script created!\"\n}' \n Retrieve uploaded custom audio files \n Shell curl --request GET  --url\
          \ 'https://v2.api.audio/content/med"
  /creator/story:
    post:
      operationId: post_creator_story
      tags:
      - Creator
      summary: BETA - Submit a story to drive AI-assisted creation of longform audio content
      description: Submit a story to drive AI-assisted creation of longform audio content.
      x-source: https://docs.audiostack.ai/reference/getstory
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCreatorStoryResponse'
      x-evidence:
        kind: documentation
  /creator/story/{storyid}:
    get:
      operationId: get_creator_story_storyid
      tags:
      - Creator
      summary: BETA - Retrieve the status and results of a previously submitted story creation request
      description: Use this endpoint with the storyId returned from the POST /creator/story endpoint to poll until the job completes.
      x-source: https://docs.audiostack.ai/reference/story-1
      parameters:
      - name: storyid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCreatorStoryStoryidResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostContentScriptRequest:
      type: object
      properties:
        projectName:
          type: string
        moduleName:
          type: string
        scriptName:
          type: string
        scriptText:
          type: string
    PostCreatorStoryResponse:
      type: object
      properties:
        '200':
          type: string
          description: Story creation job has finished (success or failure). Always includes storyId; may include optional storyResult and audioforms.
            On failure, message details the problem.
        '202':
          type: string
          description: Story creation request is still being processed. Response includes storyId and may include a message. Poll again with the
            same storyId.
        '404':
          type: string
          description: Story creation request not found.
    GetCreatorStoryStoryidResponse:
      type: object
      properties:
        '200':
          type: string
          description: Story successfully queued for processing
        '422':
          type: string
          description: Invalid request cannot be processed
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: Content
- name: Creator