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

    mergeLabels

    Fold one label into another across the whole workspace; asynchronous and irreversible — every creator carrying it ends up on the target, and the source label is deleted.

    MCP: mergeLabels

    Arguments

    intoLabelName String! required
    The existing label that absorbs it, exactly as the labels query returns it. It must already exist; the same label in any spelling is refused (use renameLabel to respell). A blank name is rejected.
    labelName String! required
    The label to fold in, exactly as the labels query returns it. It stops existing once the merge completes. Matching ignores case and surrounding whitespace. A blank name is rejected.

    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.

    operationId ID
    The merge_labels operation that runs this merge; poll it with operation(id:). Null when userErrors is non-empty. A label operation tracks progress with status, total and processed only — its record-derived counts are always 0 and its item-id lists always empty.
    scheduled Boolean!
    True when the merge is scheduled; operationId is then set. False when userErrors is non-empty. The merge is asynchronous.
    userErrors [UserError!]!
    Errors that refused the request, on the input at fault: a blank name, a label that does not exist or is being deleted, a label already being merged, the same label on both sides, a label stored under several spellings, or no user to attribute the merge to. Empty on success.