> For the complete documentation index, see [llms.txt](https://docs.zydon.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zydon.com.br/cadastros-gerais/files.md).

# Files

## GET /files

> Listar arquivos por status (paginacao seek-based)

```json
{"openapi":"3.1.0","info":{"title":"Zydon - Files","version":"production"},"servers":[{"url":"https://api.zydon.com.br/api/files","description":"Generated server url"}],"security":[{"auth":[]}],"components":{"securitySchemes":{"auth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListFilesResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Item":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"organization_id":{"type":"string","format":"uuid"},"solution_id":{"type":"string"},"url":{"type":"string"},"status":{"type":"string","enum":["PENDING","RETRYING","FAILED","READY"]},"content_type":{"type":"string","enum":["APPLICATION_OCTET_STREAM","IMAGE_JPEG","IMAGE_JPG","IMAGE_PNG","IMAGE_GIF","IMAGE_WEBP","IMAGE_SVG","IMAGE_BMP","IMAGE_TIFF","IMAGE_ICO","IMAGE_AVIF","APPLICATION_PDF","TEXT_PLAIN","TEXT_CSV","APPLICATION_RTF","APPLICATION_MSWORD","APPLICATION_DOCX","APPLICATION_MSEXCEL","APPLICATION_XLSX","APPLICATION_MSPOWERPOINT","APPLICATION_PPTX","APPLICATION_ODT","APPLICATION_ODS","APPLICATION_ODP","APPLICATION_XML","TEXT_XML","TEXT_HTML","TEXT_CSS","APPLICATION_JSON","TEXT_JAVASCRIPT","APPLICATION_ZIP","APPLICATION_GZIP","APPLICATION_RAR","APPLICATION_7Z","AUDIO_MPEG","AUDIO_WAV","AUDIO_OGG","AUDIO_WEBM","AUDIO_AAC","VIDEO_MP4","VIDEO_MPEG","VIDEO_OGG","VIDEO_WEBM","VIDEO_QUICKTIME"]},"content_length":{"type":"integer","format":"int64"},"created_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}},"Pagination":{"type":"object","properties":{"has_next":{"type":"boolean"},"last_seek_id":{"type":"string","format":"uuid"}}}}},"paths":{"/files":{"get":{"tags":["Files"],"summary":"Listar arquivos por status (paginacao seek-based)","operationId":"listFiles","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDING","RETRYING","FAILED","READY"]},"uniqueItems":true}},{"name":"solutionId","in":"query","required":false,"schema":{"type":"string"}},{"name":"lastSeekId","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Files listed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFilesResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFilesResponse"}}}},"500":{"description":"An internal server error was thrown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFilesResponse"}}}}}}}}}
```

## POST /files

> Criar arquivos

```json
{"openapi":"3.1.0","info":{"title":"Zydon - Files","version":"production"},"servers":[{"url":"https://api.zydon.com.br/api/files","description":"Generated server url"}],"security":[{"auth":[]}],"components":{"securitySchemes":{"auth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CreateFilesRequest":{"type":"object","properties":{"solution_id":{"type":"string"},"files":{"type":"array","items":{"$ref":"#/components/schemas/CreateFileRequest"}}},"required":["files"]},"CreateFileRequest":{"type":"object","properties":{"content_type":{"type":"string","enum":["APPLICATION_OCTET_STREAM","IMAGE_JPEG","IMAGE_JPG","IMAGE_PNG","IMAGE_GIF","IMAGE_WEBP","IMAGE_SVG","IMAGE_BMP","IMAGE_TIFF","IMAGE_ICO","IMAGE_AVIF","APPLICATION_PDF","TEXT_PLAIN","TEXT_CSV","APPLICATION_RTF","APPLICATION_MSWORD","APPLICATION_DOCX","APPLICATION_MSEXCEL","APPLICATION_XLSX","APPLICATION_MSPOWERPOINT","APPLICATION_PPTX","APPLICATION_ODT","APPLICATION_ODS","APPLICATION_ODP","APPLICATION_XML","TEXT_XML","TEXT_HTML","TEXT_CSS","APPLICATION_JSON","TEXT_JAVASCRIPT","APPLICATION_ZIP","APPLICATION_GZIP","APPLICATION_RAR","APPLICATION_7Z","AUDIO_MPEG","AUDIO_WAV","AUDIO_OGG","AUDIO_WEBM","AUDIO_AAC","VIDEO_MP4","VIDEO_MPEG","VIDEO_OGG","VIDEO_WEBM","VIDEO_QUICKTIME"]},"external_url":{"type":"string"},"name":{"type":"string"}}},"CreateFilesResponse":{"type":"object","properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/FileResponse"}}}},"FileResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"organization_id":{"type":"string","format":"uuid"},"solution_id":{"type":"string"},"url":{"type":"string"},"status":{"type":"string","enum":["PENDING","RETRYING","FAILED","READY"]},"content_type":{"type":"string","enum":["APPLICATION_OCTET_STREAM","IMAGE_JPEG","IMAGE_JPG","IMAGE_PNG","IMAGE_GIF","IMAGE_WEBP","IMAGE_SVG","IMAGE_BMP","IMAGE_TIFF","IMAGE_ICO","IMAGE_AVIF","APPLICATION_PDF","TEXT_PLAIN","TEXT_CSV","APPLICATION_RTF","APPLICATION_MSWORD","APPLICATION_DOCX","APPLICATION_MSEXCEL","APPLICATION_XLSX","APPLICATION_MSPOWERPOINT","APPLICATION_PPTX","APPLICATION_ODT","APPLICATION_ODS","APPLICATION_ODP","APPLICATION_XML","TEXT_XML","TEXT_HTML","TEXT_CSS","APPLICATION_JSON","TEXT_JAVASCRIPT","APPLICATION_ZIP","APPLICATION_GZIP","APPLICATION_RAR","APPLICATION_7Z","AUDIO_MPEG","AUDIO_WAV","AUDIO_OGG","AUDIO_WEBM","AUDIO_AAC","VIDEO_MP4","VIDEO_MPEG","VIDEO_OGG","VIDEO_WEBM","VIDEO_QUICKTIME"]},"content_length":{"type":"integer","format":"int64"},"created_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}}}},"paths":{"/files":{"post":{"tags":["Files"],"summary":"Criar arquivos","operationId":"createFiles","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFilesRequest"}}},"required":true},"responses":{"201":{"description":"Files created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFilesResponse"}}}},"500":{"description":"An internal server error was thrown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFilesResponse"}}}}}}}}}
```

## POST /files/query

> Buscar arquivos

```json
{"openapi":"3.1.0","info":{"title":"Zydon - Files","version":"production"},"servers":[{"url":"https://api.zydon.com.br/api/files","description":"Generated server url"}],"security":[{"auth":[]}],"components":{"securitySchemes":{"auth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"QueryFilesRequest":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","format":"uuid"}}}},"QueryFilesResponse":{"type":"object","properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/FileResponse"}}}},"FileResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"organization_id":{"type":"string","format":"uuid"},"solution_id":{"type":"string"},"url":{"type":"string"},"status":{"type":"string","enum":["PENDING","RETRYING","FAILED","READY"]},"content_type":{"type":"string","enum":["APPLICATION_OCTET_STREAM","IMAGE_JPEG","IMAGE_JPG","IMAGE_PNG","IMAGE_GIF","IMAGE_WEBP","IMAGE_SVG","IMAGE_BMP","IMAGE_TIFF","IMAGE_ICO","IMAGE_AVIF","APPLICATION_PDF","TEXT_PLAIN","TEXT_CSV","APPLICATION_RTF","APPLICATION_MSWORD","APPLICATION_DOCX","APPLICATION_MSEXCEL","APPLICATION_XLSX","APPLICATION_MSPOWERPOINT","APPLICATION_PPTX","APPLICATION_ODT","APPLICATION_ODS","APPLICATION_ODP","APPLICATION_XML","TEXT_XML","TEXT_HTML","TEXT_CSS","APPLICATION_JSON","TEXT_JAVASCRIPT","APPLICATION_ZIP","APPLICATION_GZIP","APPLICATION_RAR","APPLICATION_7Z","AUDIO_MPEG","AUDIO_WAV","AUDIO_OGG","AUDIO_WEBM","AUDIO_AAC","VIDEO_MP4","VIDEO_MPEG","VIDEO_OGG","VIDEO_WEBM","VIDEO_QUICKTIME"]},"content_length":{"type":"integer","format":"int64"},"created_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}}}},"paths":{"/files/query":{"post":{"tags":["Files"],"summary":"Buscar arquivos","operationId":"queryFiles","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryFilesRequest"}}},"required":true},"responses":{"200":{"description":"Files queried successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryFilesResponse"}}}},"500":{"description":"An internal server error was thrown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryFilesResponse"}}}}}}}}}
```

## GET /files/{fileId}

> Obter arquivo

```json
{"openapi":"3.1.0","info":{"title":"Zydon - Files","version":"production"},"servers":[{"url":"https://api.zydon.com.br/api/files","description":"Generated server url"}],"security":[{"auth":[]}],"components":{"securitySchemes":{"auth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"FileResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"organization_id":{"type":"string","format":"uuid"},"solution_id":{"type":"string"},"url":{"type":"string"},"status":{"type":"string","enum":["PENDING","RETRYING","FAILED","READY"]},"content_type":{"type":"string","enum":["APPLICATION_OCTET_STREAM","IMAGE_JPEG","IMAGE_JPG","IMAGE_PNG","IMAGE_GIF","IMAGE_WEBP","IMAGE_SVG","IMAGE_BMP","IMAGE_TIFF","IMAGE_ICO","IMAGE_AVIF","APPLICATION_PDF","TEXT_PLAIN","TEXT_CSV","APPLICATION_RTF","APPLICATION_MSWORD","APPLICATION_DOCX","APPLICATION_MSEXCEL","APPLICATION_XLSX","APPLICATION_MSPOWERPOINT","APPLICATION_PPTX","APPLICATION_ODT","APPLICATION_ODS","APPLICATION_ODP","APPLICATION_XML","TEXT_XML","TEXT_HTML","TEXT_CSS","APPLICATION_JSON","TEXT_JAVASCRIPT","APPLICATION_ZIP","APPLICATION_GZIP","APPLICATION_RAR","APPLICATION_7Z","AUDIO_MPEG","AUDIO_WAV","AUDIO_OGG","AUDIO_WEBM","AUDIO_AAC","VIDEO_MP4","VIDEO_MPEG","VIDEO_OGG","VIDEO_WEBM","VIDEO_QUICKTIME"]},"content_length":{"type":"integer","format":"int64"},"created_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_by":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}}}},"paths":{"/files/{fileId}":{"get":{"tags":["Files"],"summary":"Obter arquivo","operationId":"retrieveFile","parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"File retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"404":{"description":"File not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"500":{"description":"An internal server error was thrown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}}}}}}}
```

## GET /files/{fileId}/content

> Obter conteúdo do arquivo

```json
{"openapi":"3.1.0","info":{"title":"Zydon - Files","version":"production"},"servers":[{"url":"https://api.zydon.com.br/api/files","description":"Generated server url"}],"paths":{"/files/{fileId}/content":{"get":{"tags":["Files"],"summary":"Obter conteúdo do arquivo","operationId":"retrieveFileContent","parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string"}},{"name":"jwt","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"302":{"description":"Redirected to file content url"},"404":{"description":"File not found"},"500":{"description":"An internal server error was thrown"}}}}}}
```