Skip to content

Remove a tag from an asset

DELETE
/assets/{id}/tags/{tag}

Removes one tag from an asset. The tag in the path has to match the stored tag exactly, including case and spaces.

The answer is 204 whether or not the asset had that tag, and the asset isn’t looked up, so an asset that doesn’t exist or is in the trash also gets 204; the 404 listed below isn’t used. Removing a tag doesn’t update the asset’s similarity results.

You need to be signed in, and any account can remove tags from any asset: ownership and edit rights aren’t checked. An id that isn’t a UUID gets a plain-text 400, and a server error a plain-text 500.

id
required
string format: uuid

The asset’s id.

tag
required
string

The tag to remove, exactly as stored.

Done; also returned when the asset didn’t have the tag.

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"
}

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed