v1

latestOpenAPI 3.0.3BSL2026-07-17133415718.8 KB

File

Get File with Signed URL

Get all of the information for a file along with a signed s3 url corresponding to the file_id requested such that you can download the file.

get/api/file/{file_id}

Path parameters

file_idstring uuid required

The id of the file to fetch

Query parameters

ttlinteger nullable

The time to live of the signed url in seconds

content_typestring nullable

Optional field to override the presigned url's Content-Type header

Headers

TR-Datasetstring uuid required

The dataset id or tracking_id to use for the request. We assume you intend to use an id if the value is a valid uuid.

Response

The file's information and s3_url where the original file can be downloaded

created_atstring date-time required

file_namestring required

idstring uuid required

linkstring nullable

{"stackTrail":"components:schemas:FileDTO:properties:metadata","oasType":"schema","type":"unknown","nullable":true}

s3_urlstring required

sizeinteger required

tag_setstring[] nullable

time_stampstring date-time nullable

updated_atstring date-time required

Example response

{
  "created_at": "2021-01-01 00:00:00.000",
  "file_name": "file.txt",
  "id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
  "link": "https://trieve.ai",
  "metadata": {
    "key": "value"
  },
  "s3_url": "https://trieve.ai",
  "size": 1000,
  "updated_at": "2021-01-01 00:00:00.000"
}