{
  "openapi": "3.0.1",
  "info": {
    "title": "Setp 2: Submit Audio File",
    "version": "1.0.0",
    "description": "API for uploading audio files."
  },
    "servers": [
    {
      "url": "https://upload.fineshare.net",
      "description": "Upload endpoint 1"
    },
	{
      "url": "https://ovc.fineshare.com",
      "description": "Upload endpoint 2"
    }
  ],
  "paths": {
    "/api/uploadaudiofile/{uuid}": {
      "post": {
        "summary": "Upload an audio file",
        "operationId": "UploadAudioFile",
        "tags": ["Audio Upload"],
        "parameters": [
          {
            "name": "uuid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
			"example": "task_id",
            "description": "The task_id returned in the step 1."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Bearer token for authorization."
          },
          {
            "name": "Changer-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The type value returned in the step 1."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "audioFile": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file to upload."
                  }
                },
                "required": ["audioFile"]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Audio file successfully uploaded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Audio file uploaded successfully."
                    },
                    "uuid": {
                      "type": "string",
                      "example": "123e4567-e89b-12d3-a456-426614174000"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - invalid input.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - invalid or missing token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            }
          },
          "500": {
            "description": "Server error - unable to process the request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorModel"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorModel": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "example": "Invalid input parameters."
          },
          "details": {
            "type": "string",
            "example": "The 'audioFile' field is required."
          }
        }
      }
    }
  }
}

