Headers

Header name Description
Content-Type
required
application/json
X-API-KEY
required
YOUR_API_KEY

Params

Param name Description
asset_id
required

Asset ID

Validations:

  • Must be a String

Examples

// Successful request
POST /api/v2/drop_folders/43/incoming_asset
{
  "asset_id": "_kPKuU-Mwl2h5rYABNgq"
}
200
{
  "assets": [
    {
      "id": "_kPKuU-Mwl2h5rYABNgq",
      "external_id": null,
      "parent_id": null,
      "project_id": null,
      "owner": "admin-user-138@example.com",
      "title": "Sample Asset",
      "description": "Sample asset description.",
      "category": "test asset category",
      "tags": [
        "test",
        "tag"
      ],
      "ai_tags": [],
      "status": "open",
      "media_type": "placeholder",
      "original_filename": null,
      "drop_folder_id": 43,
      "md5_sum": null,
      "created_date": "2023-11-27T09:43:06.868Z",
      "modification_date": "2023-11-27T09:43:07.088Z",
      "deleted": null
    }
  ]
}
// Drop folder not found
POST /api/v2/drop_folders/not-found-id/incoming_asset
{
  "asset_id": "-rQimblkf0RbmhXoRORP"
}
404
{
  "error": "dropfolder not found"
}
// Asset not found
POST /api/v2/drop_folders/44/incoming_asset
{
  "asset_id": "not-found-id"
}
400
{
  "error": "asset not found"
}

Errors

Code Description
401 Unauthorized
404 Not found
500 Internal Server Error
422 Missing parameters