Archive API docs
esc
    Jump to
    Getting started Token, first query, response Explorer Run queries in the browser items The connection most integrations start with Changelog Additions and deprecations

    Narrow by kind with a prefix — q: queries, m: mutations, t: types, g: guides, f: fields and arguments.

    Jump to examples ↓
    Mutation

    bulkAddLabelsToCreators

    Assign labels to up to 1,000 creators in the background; returns an operationId to poll with operation(id:).

    MCP: bulkAddLabelsToCreators

    Arguments

    creatorIds [ID!]! required
    Creator ids to label, as returned by searchCreators or creator. At least 1 and at most 1000. An id that does not resolve in this workspace is skipped and returned in skippedCreatorIds; the rest are scheduled.
    labelNames [String!]! required
    Label names to assign. At least 1 and at most 50, each at most 100 characters. Matching ignores case and surrounding whitespace; a name that matches no label creates it.

    Returns

    Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

    acceptedCount Int!
    Number of distinct creators scheduled.
    operationId ID
    The background operation; poll it with operation(id:) and its per-creator outcomes with operationRecords. Null when scheduled is false.
    scheduled Boolean!
    True when an operation was scheduled. False when userErrors is non-empty or when no creator id resolved in this workspace.
    skippedCreatorIds [ID!]!
    Submitted creator ids that do not resolve in this workspace and were not scheduled.
    userErrors [UserError!]!
    Errors that refused the whole request: an empty or oversized list, a blank or over-long name, a label being deleted, too many label bulk operations already in flight, or a workspace with no user to attribute the operation to. Empty on success.