Skip to content

Remove a placement

DELETE
/admin/featured/{id}

Removes one placement, from the rail or the promo band, by its placement id: the id in the lists, not the subject’s id. The asset, collection or team itself isn’t changed. You need system.admin. An unknown id gets 404.

id
required
string format: uuid

The placement’s id, as listed by GET /admin/featured or GET /admin/featured/promo.

Removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed