DOdovetail
Files

Get file by id

Changed on

Retrieve metadata for a single file by its unique identifier. Returns the file's name, MIME type, size in bytes, processing status (pending, completed, or failed), author, and creation date.

Files are attachments (images, documents, audio, video) that can be embedded in docs, data entries, or other content. Use this endpoint to check a file's processing status after upload.

Required scope: file:read

get/v1/files/{file_id}

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/files/{file_id}
  • Auth
    HTTP bearer

Path parameters

file_idstring required

Unique identifier of the file.

Response

200

Changes

  • 8abea327e6b9Revision changes
    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status