For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Portal
GuidesRecipesAPI ReferenceChangelog
GuidesRecipesAPI ReferenceChangelog
  • Airtop API
      • GETGet a list of files
      • POSTCreate a file
      • GETGet a file
      • DELDelete a file
      • POSTPush a file to a session
Portal
Airtop APIFiles

Get a file

GET
https://api.airtop.ai/api/v1/files/:id
GET
/api/v1/files/:id
$curl https://api.airtop.ai/api/v1/files/id \
> -H "Authorization: Bearer <apiKey>"
200Retrieved
1{
2 "data": {
3 "downloadUrl": "downloadUrl",
4 "fileBytes": 1000000,
5 "fileName": "fileName",
6 "fileType": "browser_download",
7 "id": "id",
8 "orgId": "orgId",
9 "status": "available",
10 "uploadStartTime": "2024-01-15T09:30:00Z",
11 "expiryTime": "2024-01-15T09:30:00Z",
12 "sessionIds": [
13 "sessionIds"
14 ]
15 },
16 "meta": {
17 "requestId": "requestId"
18 },
19 "errors": [
20 {
21 "message": "message",
22 "code": "code",
23 "details": {
24 "key": "value"
25 },
26 "reason": "reason"
27 }
28 ],
29 "warnings": [
30 {
31 "message": "message",
32 "code": "code",
33 "details": {
34 "key": "value"
35 },
36 "reason": "reason"
37 }
38 ]
39}
Was this page helpful?
Previous

Delete a file

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired
ID of the file

Response

OK
dataobject
metaobject
errorslist of objects
warningslist of objects