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

# Files

Upload and manage private files for resources

## GET /files

> List uploaded files for the authenticated token

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[{"name":"Files","description":"Upload and manage private files for resources"}],"servers":[{"url":"https://api.autocontentapi.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/files":{"get":{"summary":"List uploaded files for the authenticated token","tags":["Files"],"responses":{"200":{"description":"List of files"},"401":{"description":"Unauthorized"}}}}}}
```

## POST /files

> Upload a private file for later use as a content resource

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[{"name":"Files","description":"Upload and manage private files for resources"}],"servers":[{"url":"https://api.autocontentapi.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/files":{"post":{"summary":"Upload a private file for later use as a content resource","tags":["Files"],"consumes":["multipart/form-data"],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"File to upload (max 200MB)"}}}}}},"responses":{"200":{"description":"File uploaded"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"}}}}}}
```

## DELETE /files/{id}

> Delete an uploaded file by id

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[{"name":"Files","description":"Upload and manage private files for resources"}],"servers":[{"url":"https://api.autocontentapi.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/files/{id}":{"delete":{"summary":"Delete an uploaded file by id","tags":["Files"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"File id returned by the upload endpoint"}],"responses":{"200":{"description":"File deleted"},"401":{"description":"Unauthorized"},"404":{"description":"File not found"}}}}}}
```