Show examples in:
Javascript HTTP
Endpoint info
Available examples
Content Management API > Manual tags

List all manually created upload tags

Query parameters

filter object

Attributes to filter tags

query string

Textual query to match.

Example: "foobar"
page object

Parameters to control offset-based pagination

offset integer

The (zero-based) offset of the first entity returned in the collection (defaults to 0)

Example: 200
limit integer

The maximum number of entities to return (defaults to 50, maximum is 500)

Returns

Returns an array of resource objects of type upload_tag.

Examples

GET https://site-api.datocms.com/upload-tags HTTP/1.1
Authorization: Bearer YOUR-API-TOKEN
Accept: application/json
X-Api-Version: 3
Terminal window
curl -g 'https://site-api.datocms.com/upload-tags' \
\
-H "Authorization: Bearer YOUR-API-TOKEN" \
-H "Accept: application/json" \
-H "X-Api-Version: 3"
await fetch("https://site-api.datocms.com/upload-tags", {
headers: {
Authorization: "Bearer YOUR-API-TOKEN",
Accept: "application/json",
"X-Api-Version": "3",
},
});
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: cache-control: max-age=0, private, must-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
{
"data": [
{
"type": "upload_tag",
"id": "42",
"attributes": {
"name": "Pictures of me"
}
}
],
"meta": {
"total_count": 20
}
}