{
    "info": {
        "description": "External API for downloading files.",
        "title": "Talque File API",
        "version": "1.0.0"
    },
    "paths": {
        "/api/v1/file/org/{orgId}/file/{fileId}": {
            "get": {
                "summary": "Download an organization file",
                "description": "Redirects to a signed download URL for the file.",
                "parameters": [
                    {
                        "name": "orgId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The unique identifier of the organization."
                    },
                    {
                        "name": "fileId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The unique identifier of the file."
                    },
                    {
                        "name": "X-TQ-CLIENT-ID",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client ID for authentication."
                    },
                    {
                        "name": "X-TQ-SECRET",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client secret for authentication."
                    }
                ],
                "responses": {
                    "302": {
                        "description": "Redirect to signed download URL",
                        "headers": {
                            "Location": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "The signed URL to download the file."
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request (invalid org/file ID)"
                    },
                    "403": {
                        "description": "Forbidden (file not publicly accessible)"
                    },
                    "404": {
                        "description": "File not found"
                    }
                }
            }
        }
    },
    "openapi": "3.0.3"
}