category

Returns a single token category by its slug. Use it to render a category detail page header (name, description) before fetching the category’s tokens with categoryTokens. To list all categories, use categories.

Returns

Category

See Category

Show Properties

String!

The category id — a stable slug (also the value stored on tokens).

String!

The display name. For example, Artificial Intelligence.

String

An optional short name/abbreviation for compact surfaces (pills, badges). For example, AI. Null when unset — the API does not fall back to name; clients decide whether to.

String!

The URL slug (same value as id).

String

A short description of the category.

CategoryType!

Whether the category is canonical or narrative. See CategoryType

CategoryStatus!

The lifecycle status of the category. See CategoryStatus

String

The parent category id, for hierarchical categories.

Int

The number of tokens currently assigned to the category. Null when the count has not been computed yet.

String

deprecated

The category icon URL.

This field is deprecated. Categories no longer carry imagery. Will be null.

String

deprecated

The category banner image URL.

This field is deprecated. Categories no longer carry imagery. Will be null.

Arguments

String!

required

The category slug.

Example

Test this query in the Explorer →

{
  category(slug: "artificial-intelligence") {
    id
    name
    shortName
    slug
    description
    status
    parentId
  }
}

Usage Guidelines

The slug is the same value as the category id and is the value stored on tokens.
Returns null when no category matches the slug.

⌘I

API Documentation

Queries

Mutations

Subscriptions

Types

Returns

Arguments

Example

Usage Guidelines

​Returns

​Arguments

​Example

​Usage Guidelines

Returns

Arguments

Example

Usage Guidelines