Headers

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

Params

Param name Description
project_id
required

Project ID of project to add thumbnail to

Validations:

  • Must be a String

thumbnail_asset_id
required

ID of asset which should be set as thumbnail image

Validations:

  • Must be a String

Examples

// Invalid project_id
PUT /api/v2/projects/not-found-id/thumbnail
{
  "thumbnail_asset_id": "dJ8rY4vgqDB7rUUNfGAI"
}
404
{
  "error": "project not found"
}
// Asset with thumbnail_asset_id is not found
PUT /api/v2/projects/3-tMEl0MjmmlilcnmcNk/thumbnail
{
  "thumbnail_asset_id": "not_found_id"
}
404
{
  "error": "Could not find asset with id not_found_id"
}
// Thumbnail asset is from different project
PUT /api/v2/projects/i-bKtGfDlcmli-WBPv_A/thumbnail
{
  "thumbnail_asset_id": "jWCasdAF3340p7CKa2dM"
}
400
{
  "error": "Thumbnail asset must belong to the given project"
}
// Thumbnail asset is not an image
PUT /api/v2/projects/aRY1K_xfU3WE5cawv8Ol/thumbnail
{
  "thumbnail_asset_id": "lTQg8pXkYPibF8O3KTnD"
}
400
{
  "error": "Thumbnail asset must be an image"
}
// Successful request
PUT /api/v2/projects/oBhbDeN5wG29AnyZVKwv/thumbnail
{
  "thumbnail_asset_id": "CA-UabKLc5PsfXHbNv4c"
}
200
{
  "message": "Succesfully added asset CA-UabKLc5PsfXHbNv4c as projects thumbnail image"
}

Errors

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