Delete File | Captain API Documentation

Soft delete a specific file from a database.

This operation marks the file as deleted in the organization_files table (is_deleted=true, deleted_at=timestamp) without physically removing the data.

Headers:

Authorization: Bearer {api_key} - Captain API key for authentication
X-Organization-ID: Organization UUID

Args: database_name: Name of the database containing the file file_id: File ID to delete

Returns: StandardResponse indicating success or failure

Soft delete a specific file from a database. This operation marks the file as deleted in the organization_files table (is_deleted=true, deleted_at=timestamp) without physically removing the data. Headers: - Authorization: Bearer {api_key} - Captain API key for authentication - X-Organization-ID: Organization UUID Args: database_name: Name of the database containing the file file_id: File ID to delete Returns: StandardResponse indicating success or failure

Headers

AuthorizationstringRequired

Captain API key for authentication

X-Organization-IDstringRequired

Organization UUID

Request

This endpoint expects an object.

database_namestringRequired

file_idstringRequired

Response

Successful Response

successboolean

messagestring

errorstring or null

1	curl -X POST https://api.runcaptain.com/v1/delete-file \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "X-Organization-ID: YOUR_ORG_UUID" \
4	-H "Content-Type: application/x-www-form-urlencoded" \
5	-d "database_name=contracts_2024" \
6	-d "file_id=file_abc123"

Headers

Request

Response

Errors