{
  "openapi": "3.1.0",
  "info": {
    "title": "Voiser API",
    "description": "Voiser is an AI-powered service that converts text to audio and converts audio to text. You can access the web page via <a href='https://voiser.ai' target='_blank'>voiser.ai</a>.\n\n**Rate Limiting:** The API is limited to 1 request per minute.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.34.181.188.80.sslip.io"
    }
  ],
  "components": {
    "responses": {
      "RateLimitExceeded": {
        "description": "Rate Limit Exceeded Error",
        "headers": {
          "Retry-After": {
            "description": "The number of seconds to wait before making a new request.",
            "schema": {
              "type": "integer",
              "example": 58
            }
          },
          "X-RateLimit-Limit": {
            "description": "The maximum number of requests allowed in the time window.",
            "schema": {
              "type": "integer",
              "example": 30
            }
          },
          "X-RateLimit-Remaining": {
            "description": "The number of requests remaining in the current time window.",
            "schema": {
              "type": "integer",
              "example": 0
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "boolean",
                  "example": true
                },
                "detail": {
                  "type": "array",
                  "example": [
                    {
                      "code": "RATE_LIMIT_EXCEEDED",
                      "message": "Too many requests. Please slow down.",
                      "detail": {
                        "limit": 30,
                        "window_seconds": 60,
                        "retry_after_seconds": 58
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "The Voiser API uses API keys for authentication. Create, manage, and learn more about API keys in your <a href='https://voiser.ai/account/api'>api settings</a>."
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Text to Speech",
      "description": "All available endpoints for processing text-to-speech requests."
    },
    {
      "name": "Speech to Text",
      "description": "All available endpoints for processing speech-to-text requests."
    },
    {
      "name": "Video",
      "description": "All available endpoints for generating videos from text or images."
    }
  ],
  "paths": {
    "/v1/text-to-speech": {
      "post": {
        "summary": "Create speech",
        "description": "Generates audio from the input text.",
        "tags": [
          "Text to Speech"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "text",
                  "voice_id"
                ],
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The text to generate audio for. The maximum length is `7,000 characters`.",
                    "example": "Every great idea begins with a single spark of inspiration."
                  },
                  "voice_id": {
                    "type": "string",
                    "description": "The voice id to use when generating the audio. Use the <a href='#'>Get voices</a> endpoint list all the available voices.",
                    "example": "ava"
                  },
                  "speed": {
                    "type": "number",
                    "format": "float",
                    "description": "The speed of the generated audio. Select a value from `0.5` to `1.5`.",
                    "default": 1
                  },
                  "pitch": {
                    "type": "number",
                    "format": "float",
                    "description": "The pitch of the generated audio. Select a value from `-15` to `15`.",
                    "default": 0
                  },
                  "style": {
                    "type": "string",
                    "description": "Determines in which mode the voice supports reading the text."
                  },
                  "instruction": {
                    "type": "string",
                    "description": "Control the voice of your generated audio with additional instructions."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "file": {
                      "type": "string",
                      "description": "The URL of the generated audio file."
                    },
                    "file_duration": {
                      "type": "number",
                      "format": "float",
                      "description": "Duration of the file in seconds."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing Parameter Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": false
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "PARAMETERS_MISSING",
                          "message": "Required parameters are missing.",
                          "detail": {
                            "missing_fields": [
                              "text",
                              "voice_id"
                            ]
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/text-to-speech-async": {
      "post": {
        "summary": "Create speech async",
        "description": "Generates sound from the input text asynchronously.",
        "tags": [
          "Text to Speech"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "text",
                  "voice_id"
                ],
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The text to generate audio for. The maximum length is `40,000 characters`.",
                    "example": "Every great idea begins with a single spark of inspiration."
                  },
                  "voice_id": {
                    "type": "string",
                    "description": "The voice id to use when generating the audio. Use the <a href='#'>Get voices</a> endpoint list all the available voices.",
                    "example": "ava"
                  },
                  "speed": {
                    "type": "number",
                    "format": "float",
                    "description": "The speed of the generated audio. Select a value from `0.5` to `1.5`.",
                    "default": 1
                  },
                  "pitch": {
                    "type": "number",
                    "format": "float",
                    "description": "The pitch of the generated audio. Select a value from `-15` to `15`.",
                    "default": 0
                  },
                  "style": {
                    "type": "string",
                    "description": "Determines in which mode the voice supports reading the text."
                  },
                  "instruction": {
                    "type": "string",
                    "description": "Control the voice of your generated audio with additional instructions."
                  },
                  "webhook_url": {
                    "type": "string",
                    "description": "The URL address where the result will be sent using the POST method."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "description": "The unique operation ID that will be used to retrieve the result."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing Parameter Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": false
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "PARAMETERS_MISSING",
                          "message": "Required parameters are missing.",
                          "detail": {
                            "missing_fields": [
                              "text",
                              "voice_id"
                            ]
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/text-to-speech-async/{operation_id}": {
      "get": {
        "summary": "Get speech async",
        "description": "Receives the asynchronously generated audio output.",
        "tags": [
          "Text to Speech"
        ],
        "parameters": [
          {
            "name": "operation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The unique identifier of the async create speech operation."
          }
        ],
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "running",
                        "success",
                        "failed"
                      ],
                      "description": "Indicates the current state of the transcription process. Possible values are `running`, `success`, or `failed`."
                    },
                    "operation_id": {
                      "type": "string",
                      "description": "The unique operation ID."
                    },
                    "completed_at": {
                      "type": "string",
                      "description": "Operation completed date.",
                      "example": "2026-01-01 00:00:00"
                    },
                    "detail": {
                      "type": "object",
                      "properties": {
                        "file": {
                          "type": "string",
                          "description": "The URL of the generated audio file."
                        },
                        "file_duration": {
                          "type": "number",
                          "format": "float",
                          "description": "Duration of the file in seconds."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Operation Not Found Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": false
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "OPERATION_NOT_FOUND",
                          "message": "Operation not found!"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/voices": {
      "get": {
        "summary": "List voices",
        "description": "Gets a list of all available voices.",
        "tags": [
          "Text to Speech"
        ],
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "voice_id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "language_name": {
                        "type": "string",
                        "example": "Multilingual"
                      },
                      "language_code": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "example": null
                      },
                      "enable_instruction": {
                        "type": "boolean",
                        "example": true
                      },
                      "enable_pitch": {
                        "type": "boolean",
                        "example": true
                      },
                      "enable_delay": {
                        "type": "boolean",
                        "example": false
                      },
                      "safety_level": {
                        "type": "string",
                        "enum": [
                          "LOW",
                          "MEDIUM",
                          "HIGH"
                        ],
                        "description": "It determines how sensitive the filter is toward profanity, hate speech, or sensitive topics."
                      },
                      "styles": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "example": []
                      }
                    },
                    "required": [
                      "voice_id",
                      "name",
                      "language_name",
                      "language_code",
                      "enable_instruction",
                      "enable_pitch",
                      "enable_delay",
                      "styles"
                    ]
                  },
                  "example": [
                    {
                      "voice_id": "serena",
                      "name": "Serena",
                      "language_name": "Multilingual",
                      "language_code": null,
                      "enable_instruction": false,
                      "enable_pitch": true,
                      "enable_delay": true,
                      "safety_level": "HIGH",
                      "styles": [
                        "standard",
                        "empathetic",
                        "excited",
                        "friendly",
                        "relieved",
                        "sad",
                        "serious",
                        "shy"
                      ]
                    },
                    {
                      "voice_id": "amber",
                      "name": "Amber",
                      "language_name": "English (American)",
                      "language_code": "en-US",
                      "enable_instruction": false,
                      "enable_pitch": true,
                      "enable_delay": true,
                      "safety_level": "LOW",
                      "styles": []
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/speech-to-text": {
      "post": {
        "summary": "Create transcription",
        "description": "Transcribes audio into the input language.",
        "tags": [
          "Speech to Text"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "url",
                  "language_code"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "The audio/video file url (not file name) to transcribe, in one of these formats: `mp3`, `wav`, `flac`, `aac`, `wma`, `ogg`, `m4a`, `avi`, `mp4`, `mov`, `webm`, `mpeg`, or `3gp`.",
                    "example": "https://voiser.ai/sample-audio.mp3"
                  },
                  "language_code": {
                    "type": "string",
                    "description": "The language of the input audio, provided as an <a href='https://en.wikipedia.org/wiki/IETF_language_tag' target='_blank'>IETF BCP 47</a> language tag (e.g., `en-US`, `tr-TR`).",
                    "example": "en-US"
                  },
                  "punctuation": {
                    "type": "string",
                    "description": "Controls automatic punctuation handling for the transcription. Accepts `on`, `off`, or `auto`.",
                    "default": "auto"
                  },
                  "profanity_filter": {
                    "type": "string",
                    "description": "Determines whether detected profanity should be filtered from the transcription. Accepts on `on` or `off`.",
                    "default": "on"
                  },
                  "speaker_recognition": {
                    "type": "string",
                    "description": "Enables or disables speaker recognition during transcription. Accepts `on` or `off`.",
                    "default": "off"
                  },
                  "webhook_url": {
                    "type": "string",
                    "description": "The callback URL that will receive a POST request when the transcription is completed. Must be a publicly accessible HTTPS endpoint."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "transcription_id": {
                      "type": "string",
                      "description": "The unique identifier of the transcription. This ID is returned in the response and must be used when requesting the result from the transcription result endpoint."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing Parameter Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": false
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "PARAMETERS_MISSING",
                          "message": "Required parameters are missing.",
                          "detail": {
                            "missing_fields": [
                              "url",
                              "language_code"
                            ]
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/speech-to-text/{transcription_id}": {
      "get": {
        "summary": "Get transcription",
        "description": "Transcribes audio into the input language.",
        "tags": [
          "Speech to Text"
        ],
        "parameters": [
          {
            "name": "transcription_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The unique identifier of the transcription."
          }
        ],
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "running",
                        "success",
                        "failed"
                      ],
                      "description": "Indicates the current state of the transcription process. Possible values are `running`, `success`, or `failed`."
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "offset": {
                            "type": "number",
                            "format": "float"
                          },
                          "duration": {
                            "type": "number",
                            "format": "float"
                          },
                          "confidence": {
                            "type": "number",
                            "format": "float"
                          },
                          "speaker_id": {
                            "type": "number"
                          },
                          "text": {
                            "type": "string"
                          }
                        }
                      },
                      "example": [
                        {
                          "offset": 0.16,
                          "duration": 5.84,
                          "confidence": 0.979523,
                          "speaker_id": 0,
                          "text": "Weighing in at nearly a ton and as big as a horse, the liger is the true definition of weird."
                        },
                        {
                          "offset": 6.32,
                          "duration": 8.08,
                          "confidence": 0.979523,
                          "speaker_id": 0,
                          "text": "The hybrid offspring of a male lion and a female tiger, ligers are only created when the two rival cat species meet in captivity."
                        },
                        {
                          "offset": 14.72,
                          "duration": 2.4,
                          "confidence": 0.979523,
                          "speaker_id": 0,
                          "text": "And clearly, opposites attract."
                        },
                        {
                          "offset": 17.52,
                          "duration": 6.48,
                          "confidence": 0.979523,
                          "speaker_id": 0,
                          "text": "The resulting genetic cocktail cooks up a giant, a super cat that is so big it may be too heavy to hunt."
                        },
                        {
                          "offset": 24.32,
                          "duration": 3.28,
                          "confidence": 0.979523,
                          "speaker_id": 0,
                          "text": "In the lion world, size equals dominance."
                        },
                        {
                          "offset": 28,
                          "duration": 3.68,
                          "confidence": 0.985355,
                          "speaker_id": 0,
                          "text": "So male lions pass on genes that encourage growth."
                        },
                        {
                          "offset": 32.08,
                          "duration": 3.68,
                          "confidence": 0.985355,
                          "speaker_id": 0,
                          "text": "But the females know that big doesn't always equal better."
                        },
                        {
                          "offset": 36.08,
                          "duration": 3.44,
                          "confidence": 0.985355,
                          "speaker_id": 0,
                          "text": "And their genes keep male cubs from getting too large."
                        },
                        {
                          "offset": 39.92,
                          "duration": 3.92,
                          "confidence": 0.985355,
                          "speaker_id": 0,
                          "text": "So it's thought that their whole litter has a better chance to survive."
                        },
                        {
                          "offset": 44.16,
                          "duration": 4.24,
                          "confidence": 0.985355,
                          "speaker_id": 0,
                          "text": "Tigresses don't carry a gene that inhibits the size of their cubs."
                        },
                        {
                          "offset": 48.8,
                          "duration": 6.64,
                          "confidence": 0.985355,
                          "speaker_id": 0,
                          "text": "So when a tigress falls for a guy from the wrong continent, their baby can end up bigger than both of the parents combined."
                        },
                        {
                          "offset": 55.84,
                          "duration": 3.04,
                          "confidence": 0.965058,
                          "speaker_id": 0,
                          "text": "That may be a face even a mother can't love."
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/text-to-video": {
      "post": {
        "summary": "Create video from text",
        "description": "Generates a video from the input prompt asynchronously. Returns an `operation_id` that can be used to retrieve the result via the <a href='#'>Get video result</a> endpoint or via webhook.",
        "tags": [
          "Video"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "prompt"
                ],
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "The text prompt describing the video to generate. The maximum length is `2,000 characters`.",
                    "example": "A cinematic shot of a serene beach at sunset with gentle waves."
                  },
                  "video_size": {
                    "type": "string",
                    "description": "Aspect ratio of the generated video. Allowed values: `16:9`, `9:16`.",
                    "default": "16:9",
                    "enum": [
                      "16:9",
                      "9:16"
                    ]
                  },
                  "duration": {
                    "type": "integer",
                    "description": "Duration of the generated video in seconds. Allowed values: `4`, `6`, `8`.",
                    "default": 4,
                    "enum": [
                      4,
                      6,
                      8
                    ]
                  },
                  "webhook_url": {
                    "type": "string",
                    "description": "The URL address where the result will be sent using the POST method when the video is ready."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "description": "The unique operation ID that will be used to retrieve the result."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing Parameter Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": true
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "PARAMETERS_MISSING",
                          "message": "Required parameters are missing.",
                          "detail": {
                            "missing_fields": [
                              "prompt"
                            ]
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/image-to-video": {
      "post": {
        "summary": "Create video from image(s)",
        "description": "Generates a video from a starting and/or ending image (plus an optional prompt) asynchronously. At least one of `start_image_url` or `end_image_url` must be provided. Returns an `operation_id` to be polled via the <a href='#'>Get video result</a> endpoint or received via webhook.",
        "tags": [
          "Video"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "prompt"
                ],
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "The text prompt describing the desired video motion. The maximum length is `2,000 characters`.",
                    "example": "A ghostly woman fades away on a swing under a foggy moonlit tree."
                  },
                  "video_size": {
                    "type": "string",
                    "description": "Aspect ratio of the generated video. Allowed values: `16:9`, `9:16`.",
                    "default": "16:9",
                    "enum": [
                      "16:9",
                      "9:16"
                    ]
                  },
                  "duration": {
                    "type": "integer",
                    "description": "Duration of the generated video in seconds. Allowed values: `4`, `6`, `8`.",
                    "default": 4,
                    "enum": [
                      4,
                      6,
                      8
                    ]
                  },
                  "start_image_url": {
                    "type": "string",
                    "description": "Publicly accessible URL of the starting frame image. At least one of `start_image_url` or `end_image_url` is required.",
                    "example": "https://example.com/images/start-frame.png"
                  },
                  "end_image_url": {
                    "type": "string",
                    "description": "Publicly accessible URL of the ending frame image. At least one of `start_image_url` or `end_image_url` is required.",
                    "example": "https://example.com/images/end-frame.png"
                  },
                  "webhook_url": {
                    "type": "string",
                    "description": "The URL address where the result will be sent using the POST method when the video is ready."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "description": "The unique operation ID that will be used to retrieve the result."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation / Missing Parameter Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": true
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "IMAGE_REQUIRED",
                          "message": "At least one of start_image_url or end_image_url is required."
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    },
    "/v1/video-result/{operation_id}": {
      "get": {
        "summary": "Get video result",
        "description": "Retrieves the result of an asynchronously generated video (text-to-video or image-to-video). The same endpoint serves results for both creation methods.",
        "tags": [
          "Video"
        ],
        "parameters": [
          {
            "name": "operation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The unique identifier returned by the create endpoint."
          }
        ],
        "responses": {
          "200": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "running",
                        "success",
                        "failed"
                      ],
                      "description": "Indicates the current state of the video generation. Possible values are `running`, `success`, or `failed`."
                    },
                    "operation_id": {
                      "type": "string",
                      "description": "The unique operation ID."
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "text-to-video",
                        "image-to-video"
                      ],
                      "description": "Indicates which create endpoint produced this operation."
                    },
                    "completed_at": {
                      "type": "string",
                      "description": "Operation completed date.",
                      "example": "2026-01-01 00:00:00"
                    },
                    "detail": {
                      "type": "object",
                      "properties": {
                        "file": {
                          "type": "string",
                          "description": "The URL of the generated video file."
                        },
                        "video_size": {
                          "type": "string",
                          "description": "Aspect ratio of the generated video.",
                          "example": "16:9"
                        },
                        "duration": {
                          "type": "integer",
                          "description": "Duration of the generated video in seconds.",
                          "example": 4
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Operation Not Found Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": true
                    },
                    "detail": {
                      "type": "array",
                      "example": [
                        {
                          "code": "OPERATION_NOT_FOUND",
                          "message": "Operation not found!"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimitExceeded"
          }
        }
      }
    }
  }
}