Pterodactyldocs
Admin A P I

List tags

Returns a paginated list of tags.

GET/api/admin/tags
AuthorizationBearer <token>

Application API requests require an application API token, or a client API token, that belongs to a root administrator. Admin API requests require a client API token that belongs to a root administrator, and reject application API tokens. Client API requests require a client API token.

In: header

Query Parameters

filter[name]?string

Filter tags by name.

filter[slug]?string

Filter tags by slug.

sort?string

Sort tags by id, name, or slug. Prefix with a hyphen for descending order.

page?integer

Page number to return.

per_page?integer

Results to return per page.

include?string

Comma-separated relationships to include. Supports "eggs" and "nodes".

Value in

  • "eggs"
  • "nodes"
  • "eggs,nodes"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/admin/tags?filter%5Bname%5D=Minecraft&filter%5Bslug%5D=minecraft&sort=name&page=1&per_page=50&include=eggs"
{  "object": "list",  "data": [    {      "object": "tag",      "attributes": {        "id": 510,        "name": "fugiat sunt",        "slug": "fugiat-sunt",        "color": "#54db8e",        "is_predefined": false,        "legacy_nest_id": 1,        "eggs_count": 0,        "nodes_count": 0,        "created_at": "2026-09-22T14:45:25+00:00",        "updated_at": "2026-09-22T14:45:25+00:00"      },      "meta": {        "resource": "https://panel.example.com/api/admin/tags/1"      }    }  ],  "meta": {    "pagination": {      "total": 1,      "count": 1,      "per_page": 50,      "current_page": 1,      "total_pages": 1,      "links": {        "property1": "string",        "property2": "string"      }    }  }}