Content Management API > Manual tags

List all manually created upload tags

The results are sorted by name and paginated by default.

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:

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

1
GET https://site-api.datocms.com/upload-tags HTTP/1.1
2
Authorization: Bearer YOUR-API-TOKEN
3
Accept: application/json
4
X-Api-Version: 3

1
curl -g 'https://site-api.datocms.com/upload-tags' \
2
   \
3
  -H "Authorization: Bearer YOUR-API-TOKEN" \
4
  -H "Accept: application/json" \
5
  -H "X-Api-Version: 3"

1
await fetch("https://site-api.datocms.com/upload-tags", {
2
  headers: {
3
    Authorization: "Bearer YOUR-API-TOKEN",
4
    Accept: "application/json",
5
    "X-Api-Version": "3",
6
  },
7
});

1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
Cache-Control: cache-control: max-age=0, private, must-revalidate
4
X-RateLimit-Limit: 30
5
X-RateLimit-Remaining: 28
6

7
{
8
  "data": [
9
    {
10
      "type": "upload_tag",
11
      "id": "42",
12
      "attributes": {
13
        "name": "Pictures of me"
14
      }
15
    }
16
  ],
17
  "meta": {
18
    "total_count": 20
19
  }
20
}

Did this doc help you?

Need help?

Explore our forum, contact support, or connect with our sales team . You can also chat live with other users in our Slack channel.