Files

Upload File

post

https://api.activeloop.aihttps://api-beta.activeloop.dev

/files

Upload a file with optional metadata.

Authorizations

Bearer

AuthorizationstringRequired

Enter your bearer token in the format 'your-token' (without quotes or 'Bearer' prefix)

Body

multipart/form-data

filestring · binary[]Optional

purposestring · enumOptionalDefault: user_dataPossible values:

metadataany ofOptional

JSON string with file metadata

stringOptional

or

nullOptional

instructionsany ofOptional

Instructions used to process the file

stringOptional

or

nullOptional

workspacestringOptionalDefault: default

Responses

200

Successful Response

application/json

Responseany of

or

422

Validation Error

application/json

post

/files

HTTPcURLJavaScriptPython

POST /files HTTP/1.1
Host: api.activeloop.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 103

{
  "file": [
    "binary"
  ],
  "purpose": "user_data",
  "metadata": "text",
  "instructions": "text",
  "workspace": "default"
}

[
  {
    "id": "text",
    "object": "file",
    "bytes": 1,
    "created_at": 1,
    "filename": "text",
    "purpose": "user_data",
    "status": "uploaded",
    "status_details": "text",
    "expires_at": 1,
    "org_id": "text",
    "workspace_id": "default",
    "user_id": "text",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
]

List Files

get

https://api.activeloop.aihttps://api-beta.activeloop.dev

/files

Returns a list of files, filtered by the organization.

Authorizations

Bearer

AuthorizationstringRequired

Enter your bearer token in the format 'your-token' (without quotes or 'Bearer' prefix)

Query parameters

workspacestringOptional

List files in workspace

Default: default

afterany ofOptional

Cursor for pagination

stringOptional

or

nullOptional

limitinteger · min: 1 · max: 10000Optional

Limit the number of returned files

Default: 10000

orderstringOptional

Sort order by creation timestamp

Default: desc

purposeany ofOptional

Filter by purpose

string · enumOptionalPossible values:

or

nullOptional

filterany ofOptional

Filter by metadata

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/files

HTTPcURLJavaScriptPython

GET /files HTTP/1.1
Host: api.activeloop.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "text",
      "object": "file",
      "bytes": 1,
      "created_at": 1,
      "filename": "text",
      "purpose": "user_data",
      "status": "uploaded",
      "status_details": "text",
      "expires_at": 1,
      "org_id": "text",
      "workspace_id": "default",
      "user_id": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "object": "list",
  "total": 1
}

Retrieve File

get

https://api.activeloop.aihttps://api-beta.activeloop.dev

/files/{file_id}

Returns information about a specific file, verifying organization access.

Authorizations

Bearer

AuthorizationstringRequired

Enter your bearer token in the format 'your-token' (without quotes or 'Bearer' prefix)

Path parameters

file_idstringRequired

The ID of the file

Query parameters

workspacestringOptional

Get file from workspace

Default: default

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/files/{file_id}

HTTPcURLJavaScriptPython

GET /files/{file_id} HTTP/1.1
Host: api.activeloop.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "object": "file",
  "bytes": 1,
  "created_at": 1,
  "filename": "text",
  "purpose": "user_data",
  "status": "uploaded",
  "status_details": "text",
  "expires_at": 1,
  "org_id": "text",
  "workspace_id": "default",
  "user_id": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Delete File

delete

https://api.activeloop.aihttps://api-beta.activeloop.dev

/files/{file_id}

Delete a file, verifying organization access.

Authorizations

Bearer

AuthorizationstringRequired

Enter your bearer token in the format 'your-token' (without quotes or 'Bearer' prefix)

Path parameters

file_idstringRequired

The ID of the file

Query parameters

workspacestringOptional

Delete file from workspace

Default: default

Responses

200

Successful Response

application/json

422

Validation Error

application/json

delete

/files/{file_id}

HTTPcURLJavaScriptPython

DELETE /files/{file_id} HTTP/1.1
Host: api.activeloop.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "object": "file",
  "deleted": true
}

Retrieve File Content

get

https://api.activeloop.aihttps://api-beta.activeloop.dev

/files/{file_id}/content

Returns the contents of the specified file, verifying organization access.

Authorizations

Bearer

AuthorizationstringRequired

Enter your bearer token in the format 'your-token' (without quotes or 'Bearer' prefix)

Path parameters

file_idstringRequired

The ID of the file

Query parameters

workspacestringOptional

The workspace id to get file content from

Default: default

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

get

/files/{file_id}/content

HTTPcURLJavaScriptPython

GET /files/{file_id}/content HTTP/1.1
Host: api.activeloop.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update File Metadata

patch

https://api.activeloop.aihttps://api-beta.activeloop.dev

/files/{file_id}/metadata

Update metadata for a specific file, verifying organization access.

Authorizations

Bearer

AuthorizationstringRequired

Enter your bearer token in the format 'your-token' (without quotes or 'Bearer' prefix)

Path parameters

file_idstringRequired

The ID of the file

Query parameters

workspacestringOptional

The workspace id to update th file in

Default: default

Body

application/json

The metadata to update. instructions key is considered as an instruction to update metadata by AI.

Other propertiesanyOptional

Responses

200

Successful Response

application/json

Responseany of

or

nullOptional

422

Validation Error

application/json

patch

/files/{file_id}/metadata

HTTPcURLJavaScriptPython

PATCH /files/{file_id}/metadata HTTP/1.1
Host: api.activeloop.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "id": "text",
  "object": "file",
  "bytes": 1,
  "created_at": 1,
  "filename": "text",
  "purpose": "user_data",
  "status": "uploaded",
  "status_details": "text",
  "expires_at": 1,
  "org_id": "text",
  "workspace_id": "default",
  "user_id": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}