VEvetnio
uploaded-files

Delete an uploaded file

Removes the file and its extracted analysis text from S3, then deletes the database row. Idempotent — deleting a file that no longer exists still returns ok: true. If any S3 object fails to delete, the call returns 500 and the database row is preserved so the delete can be retried without leaking orphaned storage.

delete/workspaces/{workspaceId}/consultations/{consultationId}/uploaded-files/{fileName}

Request

  • Base URL
    https://vetnio.com/api/v2
  • URL
    https://vetnio.com/api/v2/workspaces/{workspaceId}/consultations/{consultationId}/uploaded-files/{fileName}
  • Auth
    HTTP bearer

Path parameters

workspaceIdstring required

Opaque identifier of the Vetnio workspace (veterinary clinic) that owns the resource. Scopes every request — callers can only access files under workspaces they are a member of.

Example:furunculotic-loud-chihuahua
consultationIdstring required

Identifier of the consultation (a single veterinary visit) the file is attached to. The consultation must belong to the same workspace as the authenticated caller.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890
fileNamestring required

Stable internal identifier for the file — a server-generated UUID returned by initUpload. Used in every subsequent endpoint (finalize, download, delete). Not intended for display; use originalFileName for that.

Example:8f1c4a60-7e3b-4b6f-9a9d-6d9f3c8b2e4a

Response

File and its analysis were removed (or were already gone).

okboolean required

Always true on success.

Example response

{
  "ok": true
}

Changes