Content Management API > Manual tags

List all manually created upload tags

The results are sorted by name and paginated by default.

Query parameters

filterobject

Attributes to filter tags

querystring

Textual query to match.

Example:

"foobar"

pageobject

Parameters to control offset-based pagination

offsetinteger

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

Example:

limitinteger

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
}