Assets

Get the metadata for an asset

get

Get the metadata for an asset

Path parameters

asset_idstring · uuidRequired

The asset to get the metadata for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/metadata

GET /assets/{asset_id}/metadata?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Update an asset's metadata value

put

Update an asset's metadata attribute value

Path parameters

asset_idstring · uuidRequired

The id of the asset to be updated

metadata_attribute_idany ofRequired

The id of the metadata attribute to update

stringOptional

string · uuidOptional

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidRequired

The id of the drive this asset is in

metadata_attribute_valueany ofOptional

The new value for the metadata attribute. Not passing this will remove the value.

anyOptional

nullOptional

Responses

200

The updated asset

application/json

404

Not found

422

Validation Error

application/json

put

/assets/{asset_id}/metadata/{metadata_attribute_id}/value

PUT /assets/{asset_id}/metadata/{metadata_attribute_id}/value HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "metadata_attribute_value": null,
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "path": "text",
  "name": "text",
  "extension": "text",
  "updated": "2026-01-22T13:27:28.965Z",
  "created": "2026-01-22T13:27:28.965Z",
  "type": "IMAGE",
  "size_bytes": 1,
  "stack_id": "123e4567-e89b-12d3-a456-426614174000",
  "stack_number": 1,
  "is_fs_draft_blob": true,
  "is_fs_null_blob": true,
  "rating": 1,
  "ai_indexed": true,
  "system_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "custom_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "category": "text",
  "palette": [
    [
      1
    ]
  ],
  "ocr": "text",
  "transcription_id": "123e4567-e89b-12d3-a456-426614174000",
  "faces_present": true,
  "content_length": 1,
  "preview_job_state": "NOT_STARTED",
  "metadata_job_state": "NOT_STARTED",
  "core_vision_job_state": "NOT_STARTED",
  "color_palette_job_state": "NOT_STARTED",
  "core_audio_job_state": "NOT_STARTED",
  "audio_job_state": "NOT_STARTED",
  "facial_recognition_job_state": "NOT_STARTED",
  "proxy_job_state": "NOT_STARTED",
  "audio_proxy_job_state": "NOT_STARTED",
  "transcription_job_state": "NOT_STARTED",
  "objects": [],
  "texture_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "integration_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "preview_images": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "frame": 1,
      "signed_url": "text"
    }
  ],
  "custom_thumbnail": "text",
  "proxy": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "audio_proxy": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Bulk update asset metadata attributes

put

Either pass in asset_ids/metadata_attributes OR assets.

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

asset_idsany ofOptional

The id of the assets to be updated

string · uuid[]Optional

nullOptional

metadata_attributesany ofOptional

The id and values of the metadata attributes to update

nullOptional

asset_ids_with_metadata_attributesany ofOptional

The asset ids and their corresponding metadata attributes to update

nullOptional

drive_idstring · uuidRequired

The id of the drive this asset is in

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

put

/assets/metadata/values

PUT /assets/metadata/values HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 373

{
  "asset_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "metadata_attributes": [
    {
      "id": "text",
      "value": null,
      "append": false
    }
  ],
  "asset_ids_with_metadata_attributes": [
    {
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "metadata_attributes": [
        {
          "id": "text",
          "value": null,
          "append": false
        }
      ]
    }
  ],
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "asset_id": "123e4567-e89b-12d3-a456-426614174000",
    "updated_metadata_attribute_ids": [
      "text"
    ]
  }
]

Get all comments for an asset

get

Get all comments for an asset

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidOptional

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

A list of all comments for the asset

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/comments

GET /assets/{asset_id}/comments HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "asset_id": "123e4567-e89b-12d3-a456-426614174000",
    "content": "text",
    "author": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "email": "text",
      "avatar_url": "text",
      "user_type": "regular"
    },
    "created": "2026-01-22T13:27:28.965Z",
    "updated": "2026-01-22T13:27:28.965Z",
    "resolved": true,
    "is_public": true,
    "parent_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": 1,
    "duration": 1,
    "replies": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "asset_id": "123e4567-e89b-12d3-a456-426614174000",
        "content": "text",
        "author": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular"
        },
        "created": "2026-01-22T13:27:28.965Z",
        "updated": "2026-01-22T13:27:28.965Z",
        "resolved": true,
        "is_public": true,
        "parent_id": "123e4567-e89b-12d3-a456-426614174000",
        "timestamp": 1,
        "duration": 1,
        "replies": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "asset_id": "123e4567-e89b-12d3-a456-426614174000",
            "content": "text",
            "author": {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular"
            },
            "created": "2026-01-22T13:27:28.965Z",
            "updated": "2026-01-22T13:27:28.965Z",
            "resolved": true,
            "is_public": true,
            "parent_id": "123e4567-e89b-12d3-a456-426614174000",
            "timestamp": 1,
            "duration": 1,
            "replies": "[Circular Reference]",
            "mentions": [
              {
                "user_id": "text",
                "text": "text",
                "start_index": 1,
                "end_index": 1,
                "user_name": ""
              }
            ],
            "reactions": [
              {
                "users": [
                  {
                    "id": "123e4567-e89b-12d3-a456-426614174000",
                    "name": "text",
                    "email": "text",
                    "avatar_url": "text",
                    "user_type": "regular",
                    "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                  }
                ],
                "content": "text",
                "count": 1
              }
            ],
            "anchor": {
              "x": 1,
              "y": 1
            },
            "annotation": [
              {
                "tool": "text",
                "color": "text",
                "size": 1,
                "xs": [
                  1
                ],
                "ys": [
                  1
                ]
              }
            ],
            "is_copied": false,
            "attachments": [
              {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "drive_id": "123e4567-e89b-12d3-a456-426614174000",
                "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
                "uploaded": true,
                "name": "text",
                "mime_type": "text",
                "size": 1,
                "download_url": "text"
              }
            ]
          }
        ],
        "mentions": [
          {
            "user_id": "text",
            "text": "text",
            "start_index": 1,
            "end_index": 1,
            "user_name": ""
          }
        ],
        "reactions": [
          {
            "users": [
              {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "name": "text",
                "email": "text",
                "avatar_url": "text",
                "user_type": "regular",
                "comment_id": "123e4567-e89b-12d3-a456-426614174000"
              }
            ],
            "content": "text",
            "count": 1
          }
        ],
        "anchor": {
          "x": 1,
          "y": 1
        },
        "annotation": [
          {
            "tool": "text",
            "color": "text",
            "size": 1,
            "xs": [
              1
            ],
            "ys": [
              1
            ]
          }
        ],
        "is_copied": false,
        "attachments": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "drive_id": "123e4567-e89b-12d3-a456-426614174000",
            "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
            "uploaded": true,
            "name": "text",
            "mime_type": "text",
            "size": 1,
            "download_url": "text"
          }
        ]
      }
    ],
    "mentions": [
      {
        "user_id": "text",
        "text": "text",
        "start_index": 1,
        "end_index": 1,
        "user_name": ""
      }
    ],
    "reactions": [
      {
        "users": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular",
            "comment_id": "123e4567-e89b-12d3-a456-426614174000"
          }
        ],
        "content": "text",
        "count": 1
      }
    ],
    "anchor": {
      "x": 1,
      "y": 1
    },
    "annotation": [
      {
        "tool": "text",
        "color": "text",
        "size": 1,
        "xs": [
          1
        ],
        "ys": [
          1
        ]
      }
    ],
    "is_copied": false,
    "attachments": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "drive_id": "123e4567-e89b-12d3-a456-426614174000",
        "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
        "uploaded": true,
        "name": "text",
        "mime_type": "text",
        "size": 1,
        "download_url": "text"
      }
    ]
  }
]

Add a comment to an asset

post

Add a comment to an asset

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidOptional

The id of the drive this asset is in

commentstringRequired

The comment to add to the asset

mentionsany ofOptional

The mentions in the comment

Default: []

nullOptional

timestampany ofOptional

The timestamp of the comment from the start of the video

numberOptional

nullOptional

durationany ofOptional

The duration of the comment timestamp in seconds (for range based comments)

numberOptional

nullOptional

is_publicbooleanOptional

Whether the comment is public or not

Default: true

urlstringRequired

The url of the comment

anchorany ofOptional

The anchor of the comment

nullOptional

annotationany ofOptional

The annotation is a list of annotation paths

nullOptional

attachment_tokensany ofOptional

JWT tokens for attachments to link to this comment

string[]Optional

nullOptional

Responses

200

The comment

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/comments

POST /assets/{asset_id}/comments HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 387

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "comment": "text",
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "timestamp": 1,
  "duration": 1,
  "is_public": true,
  "url": "text",
  "anchor": {
    "x": 1,
    "y": 1
  },
  "annotation": [
    {
      "tool": "text",
      "color": "text",
      "size": 1,
      "xs": [
        1
      ],
      "ys": [
        1
      ]
    }
  ],
  "attachment_tokens": [
    "text"
  ],
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "asset_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "author": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "created": "2026-01-22T13:27:28.965Z",
  "updated": "2026-01-22T13:27:28.965Z",
  "resolved": true,
  "is_public": true,
  "parent_id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": 1,
  "duration": 1,
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "content": "text",
      "author": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "email": "text",
        "avatar_url": "text",
        "user_type": "regular"
      },
      "created": "2026-01-22T13:27:28.965Z",
      "updated": "2026-01-22T13:27:28.965Z",
      "resolved": true,
      "is_public": true,
      "parent_id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": 1,
      "duration": 1,
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_id": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "author": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular"
          },
          "created": "2026-01-22T13:27:28.965Z",
          "updated": "2026-01-22T13:27:28.965Z",
          "resolved": true,
          "is_public": true,
          "parent_id": "123e4567-e89b-12d3-a456-426614174000",
          "timestamp": 1,
          "duration": 1,
          "replies": [
            "[Circular Reference]"
          ],
          "mentions": [
            {
              "user_id": "text",
              "text": "text",
              "start_index": 1,
              "end_index": 1,
              "user_name": ""
            }
          ],
          "reactions": [
            {
              "users": [
                {
                  "id": "123e4567-e89b-12d3-a456-426614174000",
                  "name": "text",
                  "email": "text",
                  "avatar_url": "text",
                  "user_type": "regular",
                  "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                }
              ],
              "content": "text",
              "count": 1
            }
          ],
          "anchor": {
            "x": 1,
            "y": 1
          },
          "annotation": [
            {
              "tool": "text",
              "color": "text",
              "size": 1,
              "xs": [
                1
              ],
              "ys": [
                1
              ]
            }
          ],
          "is_copied": false,
          "attachments": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "drive_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploaded": true,
              "name": "text",
              "mime_type": "text",
              "size": 1,
              "download_url": "text"
            }
          ]
        }
      ],
      "mentions": [
        {
          "user_id": "text",
          "text": "text",
          "start_index": 1,
          "end_index": 1,
          "user_name": ""
        }
      ],
      "reactions": [
        {
          "users": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular",
              "comment_id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ],
          "content": "text",
          "count": 1
        }
      ],
      "anchor": {
        "x": 1,
        "y": 1
      },
      "annotation": [
        {
          "tool": "text",
          "color": "text",
          "size": 1,
          "xs": [
            1
          ],
          "ys": [
            1
          ]
        }
      ],
      "is_copied": false,
      "attachments": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "drive_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploaded": true,
          "name": "text",
          "mime_type": "text",
          "size": 1,
          "download_url": "text"
        }
      ]
    }
  ],
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "reactions": [
    {
      "users": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular",
          "comment_id": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "content": "text",
      "count": 1
    }
  ],
  "anchor": {
    "x": 1,
    "y": 1
  },
  "annotation": [
    {
      "tool": "text",
      "color": "text",
      "size": 1,
      "xs": [
        1
      ],
      "ys": [
        1
      ]
    }
  ],
  "is_copied": false,
  "attachments": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "drive_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploaded": true,
      "name": "text",
      "mime_type": "text",
      "size": 1,
      "download_url": "text"
    }
  ]
}

Update a comment

put

Update a comment

Path parameters

asset_idstring · uuidRequired

The id of the asset that the comment is on

comment_idstring · uuidRequired

The id of the comment to update

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidRequired

The id of the drive this comment is in

contentany ofOptional

The comment to add to the asset

stringOptional

nullOptional

mentionsany ofOptional

The mentions in the comment

nullOptional

is_publicbooleanOptional

Whether the comment is public or not

urlstringRequired

The url of the comment

timestampany ofOptional

The timestamp of the comment from the start of the video. delete with -1

numberOptional

nullOptional

durationany ofOptional

The duration of the comment timestamp in seconds (for range based comments). delete with -1

numberOptional

nullOptional

Responses

200

The comment

application/json

404

Not found

422

Validation Error

application/json

put

/assets/{asset_id}/comments/{comment_id}

PUT /assets/{asset_id}/comments/{comment_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 262

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "is_public": true,
  "url": "text",
  "timestamp": 1,
  "duration": 1,
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "asset_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "author": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "created": "2026-01-22T13:27:28.965Z",
  "updated": "2026-01-22T13:27:28.965Z",
  "resolved": true,
  "is_public": true,
  "parent_id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": 1,
  "duration": 1,
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "content": "text",
      "author": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "email": "text",
        "avatar_url": "text",
        "user_type": "regular"
      },
      "created": "2026-01-22T13:27:28.965Z",
      "updated": "2026-01-22T13:27:28.965Z",
      "resolved": true,
      "is_public": true,
      "parent_id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": 1,
      "duration": 1,
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_id": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "author": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular"
          },
          "created": "2026-01-22T13:27:28.965Z",
          "updated": "2026-01-22T13:27:28.965Z",
          "resolved": true,
          "is_public": true,
          "parent_id": "123e4567-e89b-12d3-a456-426614174000",
          "timestamp": 1,
          "duration": 1,
          "replies": [
            "[Circular Reference]"
          ],
          "mentions": [
            {
              "user_id": "text",
              "text": "text",
              "start_index": 1,
              "end_index": 1,
              "user_name": ""
            }
          ],
          "reactions": [
            {
              "users": [
                {
                  "id": "123e4567-e89b-12d3-a456-426614174000",
                  "name": "text",
                  "email": "text",
                  "avatar_url": "text",
                  "user_type": "regular",
                  "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                }
              ],
              "content": "text",
              "count": 1
            }
          ],
          "anchor": {
            "x": 1,
            "y": 1
          },
          "annotation": [
            {
              "tool": "text",
              "color": "text",
              "size": 1,
              "xs": [
                1
              ],
              "ys": [
                1
              ]
            }
          ],
          "is_copied": false,
          "attachments": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "drive_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploaded": true,
              "name": "text",
              "mime_type": "text",
              "size": 1,
              "download_url": "text"
            }
          ]
        }
      ],
      "mentions": [
        {
          "user_id": "text",
          "text": "text",
          "start_index": 1,
          "end_index": 1,
          "user_name": ""
        }
      ],
      "reactions": [
        {
          "users": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular",
              "comment_id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ],
          "content": "text",
          "count": 1
        }
      ],
      "anchor": {
        "x": 1,
        "y": 1
      },
      "annotation": [
        {
          "tool": "text",
          "color": "text",
          "size": 1,
          "xs": [
            1
          ],
          "ys": [
            1
          ]
        }
      ],
      "is_copied": false,
      "attachments": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "drive_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploaded": true,
          "name": "text",
          "mime_type": "text",
          "size": 1,
          "download_url": "text"
        }
      ]
    }
  ],
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "reactions": [
    {
      "users": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular",
          "comment_id": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "content": "text",
      "count": 1
    }
  ],
  "anchor": {
    "x": 1,
    "y": 1
  },
  "annotation": [
    {
      "tool": "text",
      "color": "text",
      "size": 1,
      "xs": [
        1
      ],
      "ys": [
        1
      ]
    }
  ],
  "is_copied": false,
  "attachments": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "drive_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploaded": true,
      "name": "text",
      "mime_type": "text",
      "size": 1,
      "download_url": "text"
    }
  ]
}

Delete a comment

delete

Delete a comment

Path parameters

asset_idstring · uuidRequired

The id of the asset that the comment is on

comment_idstring · uuidRequired

The id of the comment to delete

Query parameters

drive_idstring · uuidRequired

The id of the drive this comment is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

Responseany

404

Not found

422

Validation Error

application/json

delete

/assets/{asset_id}/comments/{comment_id}

DELETE /assets/{asset_id}/comments/{comment_id}?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Update a comment to be resolved or not

put

Update a comment's resolve status

Path parameters

asset_idstring · uuidRequired

The id of the asset that the comment is on

comment_idstring · uuidRequired

The id of the comment to update

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idany ofOptional

The id of the drive this comment is in

string · uuidOptional

nullOptional

resolvedany ofOptional

Whether the comment is resolved

booleanOptional

nullOptional

urlstringRequired

The url of the comment with REPLACE_COMMENT_ID_ON_SERVER placeholder

Responses

200

The comment

application/json

404

Not found

422

Validation Error

application/json

put

/assets/{asset_id}/comments/{comment_id}/resolve

PUT /assets/{asset_id}/comments/{comment_id}/resolve HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 126

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "resolved": true,
  "url": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "asset_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "author": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "created": "2026-01-22T13:27:28.965Z",
  "updated": "2026-01-22T13:27:28.965Z",
  "resolved": true,
  "is_public": true,
  "parent_id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": 1,
  "duration": 1,
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "content": "text",
      "author": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "email": "text",
        "avatar_url": "text",
        "user_type": "regular"
      },
      "created": "2026-01-22T13:27:28.965Z",
      "updated": "2026-01-22T13:27:28.965Z",
      "resolved": true,
      "is_public": true,
      "parent_id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": 1,
      "duration": 1,
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_id": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "author": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular"
          },
          "created": "2026-01-22T13:27:28.965Z",
          "updated": "2026-01-22T13:27:28.965Z",
          "resolved": true,
          "is_public": true,
          "parent_id": "123e4567-e89b-12d3-a456-426614174000",
          "timestamp": 1,
          "duration": 1,
          "replies": [
            "[Circular Reference]"
          ],
          "mentions": [
            {
              "user_id": "text",
              "text": "text",
              "start_index": 1,
              "end_index": 1,
              "user_name": ""
            }
          ],
          "reactions": [
            {
              "users": [
                {
                  "id": "123e4567-e89b-12d3-a456-426614174000",
                  "name": "text",
                  "email": "text",
                  "avatar_url": "text",
                  "user_type": "regular",
                  "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                }
              ],
              "content": "text",
              "count": 1
            }
          ],
          "anchor": {
            "x": 1,
            "y": 1
          },
          "annotation": [
            {
              "tool": "text",
              "color": "text",
              "size": 1,
              "xs": [
                1
              ],
              "ys": [
                1
              ]
            }
          ],
          "is_copied": false,
          "attachments": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "drive_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploaded": true,
              "name": "text",
              "mime_type": "text",
              "size": 1,
              "download_url": "text"
            }
          ]
        }
      ],
      "mentions": [
        {
          "user_id": "text",
          "text": "text",
          "start_index": 1,
          "end_index": 1,
          "user_name": ""
        }
      ],
      "reactions": [
        {
          "users": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular",
              "comment_id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ],
          "content": "text",
          "count": 1
        }
      ],
      "anchor": {
        "x": 1,
        "y": 1
      },
      "annotation": [
        {
          "tool": "text",
          "color": "text",
          "size": 1,
          "xs": [
            1
          ],
          "ys": [
            1
          ]
        }
      ],
      "is_copied": false,
      "attachments": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "drive_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploaded": true,
          "name": "text",
          "mime_type": "text",
          "size": 1,
          "download_url": "text"
        }
      ]
    }
  ],
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "reactions": [
    {
      "users": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular",
          "comment_id": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "content": "text",
      "count": 1
    }
  ],
  "anchor": {
    "x": 1,
    "y": 1
  },
  "annotation": [
    {
      "tool": "text",
      "color": "text",
      "size": 1,
      "xs": [
        1
      ],
      "ys": [
        1
      ]
    }
  ],
  "is_copied": false,
  "attachments": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "drive_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploaded": true,
      "name": "text",
      "mime_type": "text",
      "size": 1,
      "download_url": "text"
    }
  ]
}

Reply to a comment

post

Reply to a comment

Path parameters

asset_idstring · uuidRequired

The id of the asset that the comment is on

comment_idstring · uuidRequired

The id of the comment to reply to

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidRequired

The id of the drive this comment is in

contentstringRequired

The content of the comment to add to the asset

mentionsany ofOptional

The mentions in the comment

Default: []

nullOptional

urlstringRequired

The url of the comment

Responses

200

The comment

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/comments/{comment_id}/reply

POST /assets/{asset_id}/comments/{comment_id}/reply HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "url": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "asset_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "author": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "created": "2026-01-22T13:27:28.965Z",
  "updated": "2026-01-22T13:27:28.965Z",
  "resolved": true,
  "is_public": true,
  "parent_id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": 1,
  "duration": 1,
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "content": "text",
      "author": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "email": "text",
        "avatar_url": "text",
        "user_type": "regular"
      },
      "created": "2026-01-22T13:27:28.965Z",
      "updated": "2026-01-22T13:27:28.965Z",
      "resolved": true,
      "is_public": true,
      "parent_id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": 1,
      "duration": 1,
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_id": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "author": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular"
          },
          "created": "2026-01-22T13:27:28.965Z",
          "updated": "2026-01-22T13:27:28.965Z",
          "resolved": true,
          "is_public": true,
          "parent_id": "123e4567-e89b-12d3-a456-426614174000",
          "timestamp": 1,
          "duration": 1,
          "replies": [
            "[Circular Reference]"
          ],
          "mentions": [
            {
              "user_id": "text",
              "text": "text",
              "start_index": 1,
              "end_index": 1,
              "user_name": ""
            }
          ],
          "reactions": [
            {
              "users": [
                {
                  "id": "123e4567-e89b-12d3-a456-426614174000",
                  "name": "text",
                  "email": "text",
                  "avatar_url": "text",
                  "user_type": "regular",
                  "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                }
              ],
              "content": "text",
              "count": 1
            }
          ],
          "anchor": {
            "x": 1,
            "y": 1
          },
          "annotation": [
            {
              "tool": "text",
              "color": "text",
              "size": 1,
              "xs": [
                1
              ],
              "ys": [
                1
              ]
            }
          ],
          "is_copied": false,
          "attachments": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "drive_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploaded": true,
              "name": "text",
              "mime_type": "text",
              "size": 1,
              "download_url": "text"
            }
          ]
        }
      ],
      "mentions": [
        {
          "user_id": "text",
          "text": "text",
          "start_index": 1,
          "end_index": 1,
          "user_name": ""
        }
      ],
      "reactions": [
        {
          "users": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular",
              "comment_id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ],
          "content": "text",
          "count": 1
        }
      ],
      "anchor": {
        "x": 1,
        "y": 1
      },
      "annotation": [
        {
          "tool": "text",
          "color": "text",
          "size": 1,
          "xs": [
            1
          ],
          "ys": [
            1
          ]
        }
      ],
      "is_copied": false,
      "attachments": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "drive_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploaded": true,
          "name": "text",
          "mime_type": "text",
          "size": 1,
          "download_url": "text"
        }
      ]
    }
  ],
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "reactions": [
    {
      "users": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular",
          "comment_id": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "content": "text",
      "count": 1
    }
  ],
  "anchor": {
    "x": 1,
    "y": 1
  },
  "annotation": [
    {
      "tool": "text",
      "color": "text",
      "size": 1,
      "xs": [
        1
      ],
      "ys": [
        1
      ]
    }
  ],
  "is_copied": false,
  "attachments": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "drive_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploaded": true,
      "name": "text",
      "mime_type": "text",
      "size": 1,
      "download_url": "text"
    }
  ]
}

React to a comment

put

React to a comment

Path parameters

asset_idstring · uuidRequired

The id of the asset that the comment is on

comment_idstring · uuidRequired

The id of the comment to react to

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidRequired

The id of the drive this comment is in

reaction_to_addany ofOptional

The reaction to add to the comment. Either pass this or reaction_to_remove

stringOptional

nullOptional

reaction_to_removeany ofOptional

The id of the reaction to remove. Either pass this or reaction_to_add

string · uuidOptional

nullOptional

Responses

200

The comment

application/json

404

Not found

422

Validation Error

application/json

put

/assets/{asset_id}/comments/{comment_id}/react

PUT /assets/{asset_id}/comments/{comment_id}/react HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 182

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "reaction_to_add": "text",
  "reaction_to_remove": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "asset_id": "123e4567-e89b-12d3-a456-426614174000",
  "content": "text",
  "author": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "created": "2026-01-22T13:27:28.965Z",
  "updated": "2026-01-22T13:27:28.965Z",
  "resolved": true,
  "is_public": true,
  "parent_id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": 1,
  "duration": 1,
  "replies": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "content": "text",
      "author": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "email": "text",
        "avatar_url": "text",
        "user_type": "regular"
      },
      "created": "2026-01-22T13:27:28.965Z",
      "updated": "2026-01-22T13:27:28.965Z",
      "resolved": true,
      "is_public": true,
      "parent_id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": 1,
      "duration": 1,
      "replies": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_id": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "author": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular"
          },
          "created": "2026-01-22T13:27:28.965Z",
          "updated": "2026-01-22T13:27:28.965Z",
          "resolved": true,
          "is_public": true,
          "parent_id": "123e4567-e89b-12d3-a456-426614174000",
          "timestamp": 1,
          "duration": 1,
          "replies": [
            "[Circular Reference]"
          ],
          "mentions": [
            {
              "user_id": "text",
              "text": "text",
              "start_index": 1,
              "end_index": 1,
              "user_name": ""
            }
          ],
          "reactions": [
            {
              "users": [
                {
                  "id": "123e4567-e89b-12d3-a456-426614174000",
                  "name": "text",
                  "email": "text",
                  "avatar_url": "text",
                  "user_type": "regular",
                  "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                }
              ],
              "content": "text",
              "count": 1
            }
          ],
          "anchor": {
            "x": 1,
            "y": 1
          },
          "annotation": [
            {
              "tool": "text",
              "color": "text",
              "size": 1,
              "xs": [
                1
              ],
              "ys": [
                1
              ]
            }
          ],
          "is_copied": false,
          "attachments": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "drive_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
              "uploaded": true,
              "name": "text",
              "mime_type": "text",
              "size": 1,
              "download_url": "text"
            }
          ]
        }
      ],
      "mentions": [
        {
          "user_id": "text",
          "text": "text",
          "start_index": 1,
          "end_index": 1,
          "user_name": ""
        }
      ],
      "reactions": [
        {
          "users": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular",
              "comment_id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ],
          "content": "text",
          "count": 1
        }
      ],
      "anchor": {
        "x": 1,
        "y": 1
      },
      "annotation": [
        {
          "tool": "text",
          "color": "text",
          "size": 1,
          "xs": [
            1
          ],
          "ys": [
            1
          ]
        }
      ],
      "is_copied": false,
      "attachments": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "drive_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
          "uploaded": true,
          "name": "text",
          "mime_type": "text",
          "size": 1,
          "download_url": "text"
        }
      ]
    }
  ],
  "mentions": [
    {
      "user_id": "text",
      "text": "text",
      "start_index": 1,
      "end_index": 1,
      "user_name": ""
    }
  ],
  "reactions": [
    {
      "users": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular",
          "comment_id": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "content": "text",
      "count": 1
    }
  ],
  "anchor": {
    "x": 1,
    "y": 1
  },
  "annotation": [
    {
      "tool": "text",
      "color": "text",
      "size": 1,
      "xs": [
        1
      ],
      "ys": [
        1
      ]
    }
  ],
  "is_copied": false,
  "attachments": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "drive_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
      "uploaded": true,
      "name": "text",
      "mime_type": "text",
      "size": 1,
      "download_url": "text"
    }
  ]
}

Start the upload process for a comment attachment

post

Start the upload process for a comment attachment

Path parameters

asset_idstring · uuidRequired

The id of the asset to create the attachment for

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidRequired

The id of the drive to create the attachment for

namestringRequired

The name of the attachment to be created

mime_typestringRequired

The mime type of the attachment to be created

sizeintegerRequired

The size of the attachment to be created

comment_idstring · uuidRequired

The id of the comment to attach to

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/comments/attachments

POST /assets/{asset_id}/comments/attachments HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "mime_type": "text",
  "size": 1,
  "comment_id": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded": true,
  "name": "text",
  "mime_type": "text",
  "size": 1,
  "upload_url": "text"
}

Mark the upload of a comment attachment as complete

post

Mark the upload of a comment attachment as complete

Path parameters

asset_idstring · uuidRequired

The id of the asset to mark the attachment uploaded for

attachment_idstring · uuidRequired

The id of the attachment to mark as uploaded

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidRequired

The id of the drive to mark the attachment uploaded for

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/comments/attachments/{attachment_id}

POST /assets/{asset_id}/comments/attachments/{attachment_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
  "uploaded": true,
  "name": "text",
  "mime_type": "text",
  "size": 1,
  "download_url": "text"
}

Paste comments from another asset

post

Paste all comments from source asset to target asset

Path parameters

asset_idstring · uuidRequired

The id of the asset to paste comments to

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

source_asset_idstring · uuidRequired

The id of the asset to copy comments from

drive_idstring · uuidRequired

The id of the drive

Responses

200

List of newly created comments

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/comments/paste

POST /assets/{asset_id}/comments/paste HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "source_asset_id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "asset_id": "123e4567-e89b-12d3-a456-426614174000",
    "content": "text",
    "author": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "email": "text",
      "avatar_url": "text",
      "user_type": "regular"
    },
    "created": "2026-01-22T13:27:28.965Z",
    "updated": "2026-01-22T13:27:28.965Z",
    "resolved": true,
    "is_public": true,
    "parent_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": 1,
    "duration": 1,
    "replies": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "asset_id": "123e4567-e89b-12d3-a456-426614174000",
        "content": "text",
        "author": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "email": "text",
          "avatar_url": "text",
          "user_type": "regular"
        },
        "created": "2026-01-22T13:27:28.965Z",
        "updated": "2026-01-22T13:27:28.965Z",
        "resolved": true,
        "is_public": true,
        "parent_id": "123e4567-e89b-12d3-a456-426614174000",
        "timestamp": 1,
        "duration": 1,
        "replies": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "asset_id": "123e4567-e89b-12d3-a456-426614174000",
            "content": "text",
            "author": {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "text",
              "email": "text",
              "avatar_url": "text",
              "user_type": "regular"
            },
            "created": "2026-01-22T13:27:28.965Z",
            "updated": "2026-01-22T13:27:28.965Z",
            "resolved": true,
            "is_public": true,
            "parent_id": "123e4567-e89b-12d3-a456-426614174000",
            "timestamp": 1,
            "duration": 1,
            "replies": "[Circular Reference]",
            "mentions": [
              {
                "user_id": "text",
                "text": "text",
                "start_index": 1,
                "end_index": 1,
                "user_name": ""
              }
            ],
            "reactions": [
              {
                "users": [
                  {
                    "id": "123e4567-e89b-12d3-a456-426614174000",
                    "name": "text",
                    "email": "text",
                    "avatar_url": "text",
                    "user_type": "regular",
                    "comment_id": "123e4567-e89b-12d3-a456-426614174000"
                  }
                ],
                "content": "text",
                "count": 1
              }
            ],
            "anchor": {
              "x": 1,
              "y": 1
            },
            "annotation": [
              {
                "tool": "text",
                "color": "text",
                "size": 1,
                "xs": [
                  1
                ],
                "ys": [
                  1
                ]
              }
            ],
            "is_copied": false,
            "attachments": [
              {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "drive_id": "123e4567-e89b-12d3-a456-426614174000",
                "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
                "uploaded": true,
                "name": "text",
                "mime_type": "text",
                "size": 1,
                "download_url": "text"
              }
            ]
          }
        ],
        "mentions": [
          {
            "user_id": "text",
            "text": "text",
            "start_index": 1,
            "end_index": 1,
            "user_name": ""
          }
        ],
        "reactions": [
          {
            "users": [
              {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "name": "text",
                "email": "text",
                "avatar_url": "text",
                "user_type": "regular",
                "comment_id": "123e4567-e89b-12d3-a456-426614174000"
              }
            ],
            "content": "text",
            "count": 1
          }
        ],
        "anchor": {
          "x": 1,
          "y": 1
        },
        "annotation": [
          {
            "tool": "text",
            "color": "text",
            "size": 1,
            "xs": [
              1
            ],
            "ys": [
              1
            ]
          }
        ],
        "is_copied": false,
        "attachments": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "drive_id": "123e4567-e89b-12d3-a456-426614174000",
            "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
            "uploaded": true,
            "name": "text",
            "mime_type": "text",
            "size": 1,
            "download_url": "text"
          }
        ]
      }
    ],
    "mentions": [
      {
        "user_id": "text",
        "text": "text",
        "start_index": 1,
        "end_index": 1,
        "user_name": ""
      }
    ],
    "reactions": [
      {
        "users": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "email": "text",
            "avatar_url": "text",
            "user_type": "regular",
            "comment_id": "123e4567-e89b-12d3-a456-426614174000"
          }
        ],
        "content": "text",
        "count": 1
      }
    ],
    "anchor": {
      "x": 1,
      "y": 1
    },
    "annotation": [
      {
        "tool": "text",
        "color": "text",
        "size": 1,
        "xs": [
          1
        ],
        "ys": [
          1
        ]
      }
    ],
    "is_copied": false,
    "attachments": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "drive_id": "123e4567-e89b-12d3-a456-426614174000",
        "uploader_id": "123e4567-e89b-12d3-a456-426614174000",
        "uploaded": true,
        "name": "text",
        "mime_type": "text",
        "size": 1,
        "download_url": "text"
      }
    ]
  }
]

Export comments in various formats

get

Export all comments for an asset in the specified format

Path parameters

asset_idstring · uuidRequired

The id of the asset to export comments for

Query parameters

typestring · enumRequired

The type of export to generate

Possible values:

drive_idstring · uuidOptional

The id of the drive this asset is in

authorizationany ofOptional

The authorization token to use to fetch the export

stringOptional

nullOptional

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Exported comments file

application/json

Responseany

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/comments/export

GET /assets/{asset_id}/comments/export?type=csv HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get the transcription utterances for an asset if it exists

get

Get the transcription utterances for an asset if it exists

Path parameters

asset_idstring · uuidRequired

The asset to get the transcription for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

Responseany of

nullOptional

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/transcription/utterances

GET /assets/{asset_id}/transcription/utterances?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "speaker": "text",
    "start": 1,
    "end": 1,
    "text": "text",
    "words": [
      {
        "start": 1,
        "end": 1,
        "text": "text"
      }
    ]
  }
]

Get the transcription segments for an asset if it exists

get

Get the transcription segments for an asset if it exists

Path parameters

asset_idstring · uuidRequired

The asset to get the transcription for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

Responseany of

nullOptional

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/transcription/segments

GET /assets/{asset_id}/transcription/segments?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "start": 1,
    "end": 1,
    "text": "text"
  }
]

Export the transcription as a file for an asset if it exists

get

Path parameters

asset_idstring · uuidRequired

The asset to get the transcription for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

typestring · enumOptional

The type of transcription to get

Default: vttPossible values:

authorizationany ofOptional

The authorization token to use to fetch the preview

stringOptional

nullOptional

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

Responseany

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/transcription/file

GET /assets/{asset_id}/transcription/file?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get AI-generated conversation starters for the transcript

get

Generate 3 pertinent conversation starters based on the transcript content using LeMuR AI.

Path parameters

asset_idstring · uuidRequired

The asset to get suggestions for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/transcription/suggestions

GET /assets/{asset_id}/transcription/suggestions?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "suggestions": [
    "text"
  ]
}

Chat with the transcript using LeMuR AI

post

Chat with the transcript using AssemblyAI's LeMuR (powered by Claude 3.5 Sonnet). The AI will provide timestamps in [MM:SS] or [HH:MM:SS] format that can be clicked in the UI.

Path parameters

asset_idstring · uuidRequired

The asset to chat with the transcription for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/transcription/chat

POST /assets/{asset_id}/transcription/chat?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "request": {
    "message": "text",
    "conversation_history": [
      {
        "role": "user",
        "content": "text"
      }
    ]
  },
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "response": "text"
}

Get all preview images for an asset with signed urls

get

Get all preview images for an asset, including signed URLs for each preview image.

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/previews

GET /assets/{asset_id}/previews?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "frame": 1,
    "signed_url": "text"
  }
]

Get the usage of a drive's assets for analytics

get

Query parameters

drive_idstring · uuidRequired

The id of the drive we get asset usage for

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

/assets/usage

GET /assets/usage?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "num_assets": 1,
  "num_ai_assets": 1,
  "bytes": 1,
  "types": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "collections": 1
}

Get all the faces for an asset

get

Get all the faces an asset contains

Path parameters

asset_idstring · uuidRequired

The asset to get the faces for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/faces

GET /assets/{asset_id}/faces?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "bbox": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "face_preview": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "frame": 1,
      "signed_url": "text"
    },
    "individual_id": "123e4567-e89b-12d3-a456-426614174000"
  }
]

Get all mentionable users on comments for an asset

get

Get all mentionable users on comments for an asset

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

A list of mentionable users on comments for the asset

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/mentionable-users

GET /assets/{asset_id}/mentionable-users?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  }
]

Clip a video between two timestamps (hybrid head re-encode + tail copy)

get

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

start_timenumberRequired

The start time of the clip in seconds

end_timenumberRequired

The end time of the clip in seconds

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

Responseany

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/clip

GET /assets/{asset_id}/clip?drive_id=123e4567-e89b-12d3-a456-426614174000&start_time=1&end_time=1 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get a signed download URL for an asset's data

get

Get a signed download URL for an asset's data based on the origin type

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

origin_typestring · enumRequired

The origin of the asset's data to fetch

Possible values:

namestringOptional

The name of the file to download as

downloadbooleanOptional

Whether to download the file or view it inline

Default: true

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

A signed download URL

application/json

Responsestring

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/download

GET /assets/{asset_id}/download?drive_id=123e4567-e89b-12d3-a456-426614174000&origin_type=SOURCE HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

text

Get an asset source by redirecting to the signed url

get

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

namestringOptional

The name of the file to download as

authorizationany ofOptional

The authorization token to use to fetch the preview

stringOptional

nullOptional

shade-collection-idany ofOptional

The collection id to authorize against, if not provided will use the default collection for the user.

string · uuidOptional

nullOptional

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

A signed download URL

application/json

Responseany

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}/source

GET /assets/{asset_id}/source?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get an asset from its path

get

Get an asset from its path

Query parameters

pathstringRequired

The path of the asset to retrieve

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

The asset

application/json

404

Not found

422

Validation Error

application/json

get

/assets/path

GET /assets/path?path=text&drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "path": "text",
  "name": "text",
  "extension": "text",
  "updated": "2026-01-22T13:27:28.965Z",
  "created": "2026-01-22T13:27:28.965Z",
  "type": "IMAGE",
  "size_bytes": 1,
  "stack_id": "123e4567-e89b-12d3-a456-426614174000",
  "stack_number": 1,
  "is_fs_draft_blob": true,
  "is_fs_null_blob": true,
  "rating": 1,
  "ai_indexed": true,
  "system_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "custom_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "category": "text",
  "palette": [
    [
      1
    ]
  ],
  "ocr": "text",
  "transcription_id": "123e4567-e89b-12d3-a456-426614174000",
  "faces_present": true,
  "content_length": 1,
  "preview_job_state": "NOT_STARTED",
  "metadata_job_state": "NOT_STARTED",
  "core_vision_job_state": "NOT_STARTED",
  "color_palette_job_state": "NOT_STARTED",
  "core_audio_job_state": "NOT_STARTED",
  "audio_job_state": "NOT_STARTED",
  "facial_recognition_job_state": "NOT_STARTED",
  "proxy_job_state": "NOT_STARTED",
  "audio_proxy_job_state": "NOT_STARTED",
  "transcription_job_state": "NOT_STARTED",
  "objects": [],
  "texture_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "integration_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "preview_images": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "frame": 1,
      "signed_url": "text"
    }
  ],
  "custom_thumbnail": "text",
  "proxy": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "audio_proxy": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Bulk update asset metadata attributes

put

Either pass in asset_ids/metadata_attributes OR assets.

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

asset_idsany ofOptional

The id of the assets to be updated

string · uuid[]Optional

nullOptional

metadata_attributesany ofOptional

The id and values of the metadata attributes to update

nullOptional

asset_ids_with_metadata_attributesany ofOptional

The asset ids and their corresponding metadata attributes to update

nullOptional

drive_idstring · uuidRequired

The id of the drive this asset is in

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

put

/assets/bulk/metadata/values

PUT /assets/bulk/metadata/values HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 373

{
  "asset_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "metadata_attributes": [
    {
      "id": "text",
      "value": null,
      "append": false
    }
  ],
  "asset_ids_with_metadata_attributes": [
    {
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "metadata_attributes": [
        {
          "id": "text",
          "value": null,
          "append": false
        }
      ]
    }
  ],
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "asset_id": "123e4567-e89b-12d3-a456-426614174000",
    "updated_metadata_attribute_ids": [
      "text"
    ]
  }
]

Get all assets for a stack

get

Path parameters

stack_idstring · uuidRequired

The id of the stack to retrieve assets for

Query parameters

directory_pathstringRequired

The directory path that the stack is located under

drive_idstring · uuidRequired

The id of the drive this stack is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

A list of assets for the stack

application/json

404

Not found

422

Validation Error

application/json

get

/assets/stack/{stack_id}

GET /assets/stack/{stack_id}?directory_path=text&drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "drive_id": "123e4567-e89b-12d3-a456-426614174000",
    "path": "text",
    "name": "text",
    "extension": "text",
    "updated": "2026-01-22T13:27:28.965Z",
    "created": "2026-01-22T13:27:28.965Z",
    "type": "IMAGE",
    "size_bytes": 1,
    "stack_id": "123e4567-e89b-12d3-a456-426614174000",
    "stack_number": 1,
    "is_fs_draft_blob": true,
    "is_fs_null_blob": true,
    "rating": 1,
    "ai_indexed": true,
    "system_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "custom_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "category": "text",
    "palette": [
      [
        1
      ]
    ],
    "ocr": "text",
    "transcription_id": "123e4567-e89b-12d3-a456-426614174000",
    "faces_present": true,
    "content_length": 1,
    "preview_job_state": "NOT_STARTED",
    "metadata_job_state": "NOT_STARTED",
    "core_vision_job_state": "NOT_STARTED",
    "color_palette_job_state": "NOT_STARTED",
    "core_audio_job_state": "NOT_STARTED",
    "audio_job_state": "NOT_STARTED",
    "facial_recognition_job_state": "NOT_STARTED",
    "proxy_job_state": "NOT_STARTED",
    "audio_proxy_job_state": "NOT_STARTED",
    "transcription_job_state": "NOT_STARTED",
    "objects": [],
    "texture_data": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "integration_data": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "preview_images": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "frame": 1,
        "signed_url": "text"
      }
    ],
    "custom_thumbnail": "text",
    "proxy": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    },
    "audio_proxy": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
]

Create a new stack from a list of assets

post

Create a new stack from a list of assets

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

asset_idsstring · uuid[]Required

List of asset IDs to create a stack from

drive_idstring · uuidRequired

The id of the drive these assets are in

Responses

200

The ID of the created stack

application/json

Responsestring · uuid

404

Not found

422

Validation Error

application/json

post

/assets/stack

POST /assets/stack HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 150

{
  "asset_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

123e4567-e89b-12d3-a456-426614174000

Add an asset to a stack

post

Add an asset to a stack

Path parameters

asset_idstring · uuidRequired

The id of the asset to add to the stack

Query parameters

target_asset_idstring · uuidRequired

The id of an asset in the stack to add the asset to

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

The stack number of the added asset

application/json

Responseinteger

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/stack

POST /assets/{asset_id}/stack?target_asset_id=123e4567-e89b-12d3-a456-426614174000&drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Remove an asset from its stack

delete

Remove an asset from its stack

Path parameters

asset_idstring · uuidRequired

The id of the asset to remove from its stack

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Whether the asset was removed from the stack

application/json

Responseany

404

Not found

422

Validation Error

application/json

delete

/assets/{asset_id}/stack

DELETE /assets/{asset_id}/stack?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Move an asset to a new position within its stack

put

Move an asset to a new position within its stack

Path parameters

asset_idstring · uuidRequired

The id of the asset to move within the stack

Query parameters

new_stack_numberintegerRequired

The new stack number position for the asset

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Whether the asset was successfully moved

application/json

Responseany

404

Not found

422

Validation Error

application/json

put

/assets/{asset_id}/stack/move

PUT /assets/{asset_id}/stack/move?new_stack_number=1&drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Rerun transcription for an asset

post

Rerun transcription for an asset. If the asset was previously completed with no dialogue, it will skip the dialogue classifier.

Path parameters

asset_idstring · uuidRequired

The id of the asset to rerun transcription for

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Success status

application/json

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/transcription-override

POST /assets/{asset_id}/transcription-override?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Get an asset

get

Get an asset

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this asset is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

The asset

application/json

404

Not found

422

Validation Error

application/json

get

/assets/{asset_id}

GET /assets/{asset_id}?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "path": "text",
  "name": "text",
  "extension": "text",
  "updated": "2026-01-22T13:27:28.965Z",
  "created": "2026-01-22T13:27:28.965Z",
  "type": "IMAGE",
  "size_bytes": 1,
  "stack_id": "123e4567-e89b-12d3-a456-426614174000",
  "stack_number": 1,
  "is_fs_draft_blob": true,
  "is_fs_null_blob": true,
  "rating": 1,
  "ai_indexed": true,
  "system_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "custom_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "category": "text",
  "palette": [
    [
      1
    ]
  ],
  "ocr": "text",
  "transcription_id": "123e4567-e89b-12d3-a456-426614174000",
  "faces_present": true,
  "content_length": 1,
  "preview_job_state": "NOT_STARTED",
  "metadata_job_state": "NOT_STARTED",
  "core_vision_job_state": "NOT_STARTED",
  "color_palette_job_state": "NOT_STARTED",
  "core_audio_job_state": "NOT_STARTED",
  "audio_job_state": "NOT_STARTED",
  "facial_recognition_job_state": "NOT_STARTED",
  "proxy_job_state": "NOT_STARTED",
  "audio_proxy_job_state": "NOT_STARTED",
  "transcription_job_state": "NOT_STARTED",
  "objects": [],
  "texture_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "integration_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "preview_images": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "frame": 1,
      "signed_url": "text"
    }
  ],
  "custom_thumbnail": "text",
  "proxy": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "audio_proxy": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Set Custom Thumbnail

post

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

drive_idstring · uuidOptional

The id of the drive this asset is in

attachment_tokenstringOptional

JWT tokens for attachments to link to this thumbnail

Responses

200

Successful Response

application/json

Responseany

404

Not found

422

Validation Error

application/json

post

/assets/{asset_id}/custom-thumbnail

POST /assets/{asset_id}/custom-thumbnail HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "attachment_token": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Reset Custom Thumbnail

delete

Path parameters

asset_idstring · uuidRequired

The id of the asset to retrieve

Query parameters

drive_idstring · uuidRequired

The id of the drive this attachment is in

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

nullOptional

Body

Responses

200

Successful Response

application/json

Responseany

404

Not found

422

Validation Error

application/json

delete

/assets/{asset_id}/custom-thumbnail

DELETE /assets/{asset_id}/custom-thumbnail?drive_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

PreviousGroups NextAttachments

Last updated 12 days ago

Good afternoon

hashtagGet the metadata for an asset

hashtagUpdate an asset's metadata value

hashtagBulk update asset metadata attributes

hashtagGet all comments for an asset

hashtagAdd a comment to an asset

hashtagUpdate a comment

hashtagDelete a comment

hashtagUpdate a comment to be resolved or not

hashtagReply to a comment

hashtagReact to a comment

hashtagStart the upload process for a comment attachment

hashtagMark the upload of a comment attachment as complete

hashtagPaste comments from another asset

hashtagExport comments in various formats

hashtagGet the transcription utterances for an asset if it exists

hashtagGet the transcription segments for an asset if it exists

hashtagExport the transcription as a file for an asset if it exists

hashtagGet AI-generated conversation starters for the transcript

hashtagChat with the transcript using LeMuR AI

hashtagGet all preview images for an asset with signed urls

hashtagGet the usage of a drive's assets for analytics

hashtagGet all the faces for an asset

hashtagGet all mentionable users on comments for an asset

hashtagClip a video between two timestamps (hybrid head re-encode + tail copy)

hashtagGet a signed download URL for an asset's data

hashtagGet an asset source by redirecting to the signed url

hashtagGet an asset from its path

hashtagBulk update asset metadata attributes

hashtagGet all assets for a stack

hashtagCreate a new stack from a list of assets

hashtagAdd an asset to a stack

hashtagRemove an asset from its stack

hashtagMove an asset to a new position within its stack

hashtagRerun transcription for an asset

hashtagGet an asset

hashtagSet Custom Thumbnail

hashtagReset Custom Thumbnail

Get the metadata for an asset

Update an asset's metadata value

Bulk update asset metadata attributes

Get all comments for an asset

Add a comment to an asset

Update a comment

Delete a comment

Update a comment to be resolved or not

Reply to a comment

React to a comment

Start the upload process for a comment attachment

Mark the upload of a comment attachment as complete

Paste comments from another asset

Export comments in various formats

Get the transcription utterances for an asset if it exists

Get the transcription segments for an asset if it exists

Export the transcription as a file for an asset if it exists

Get AI-generated conversation starters for the transcript

Chat with the transcript using LeMuR AI

Get all preview images for an asset with signed urls

Get the usage of a drive's assets for analytics

Get all the faces for an asset

Get all mentionable users on comments for an asset

Clip a video between two timestamps (hybrid head re-encode + tail copy)

Get a signed download URL for an asset's data

Get an asset source by redirecting to the signed url

Get an asset from its path

Bulk update asset metadata attributes

Get all assets for a stack

Create a new stack from a list of assets

Add an asset to a stack

Remove an asset from its stack

Move an asset to a new position within its stack

Rerun transcription for an asset

Get an asset

Set Custom Thumbnail

Reset Custom Thumbnail