Get File | BCTRL Docs

Get one file metadata record using the canonical v2 file resource.

AuthorizationBearer

Use Bearer <api-key>.

fileIdstringRequired

spaceIdstringRequiredformat: "uuid"

Default Response

contentTypestring>=1 character

createdAtstring

idstringformat: "uuid"

namestring>=1 character

pathstring>=1 character

sizeBytesinteger0-9007199254740991

sourceenum

Allowed values:

typestring>=1 character

downloadUrlstring

expiresAtstring or null

metadataobject or null

runIdstring or nullformat: "uuid"

runtimeIdstring or nullformat: "uuid"

spaceIdstringformat: "uuid"

$	curl -G https://api.bctrl.ai/v2/files/fileId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d spaceId=spaceId

1	{
2	"contentType": "application/pdf",
3	"createdAt": "2024-06-10T09:15:30Z",
4	"id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
5	"name": "ProjectProposal.pdf",
6	"path": "/documents/proposals/ProjectProposal.pdf",
7	"sizeBytes": 245760,
8	"source": "upload",
9	"type": "file",
10	"downloadUrl": "https://cdn.bctrl.ai/files/3f2504e0-4f89-11d3-9a0c-0305e82c3301/download",
11	"expiresAt": null,
12	"metadata": {},
13	"runId": null,
14	"runtimeId": null,
15	"spaceId": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
16	}