# clearCreatorCustomAttribute

Mutation

Remove one custom attribute value from up to 1,000 creators. Up to 40 creators are written in the request; more run as a background operation.

Available to agents as MCP tool `clearCreatorCustomAttribute` — see [Write tools](/api/v2/docs/mcp/write-tools#clear-creator-custom-attribute).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `creatorIds` | `[ID!]!` | Yes | — | Creator ids, as returned by `searchCreators` or `creator`. At least 1 and at most 1000. If any id does not resolve in this workspace, the whole call is refused with one userErrors entry per unknown id under `creatorIds`; nothing is written. |
| `key` | `String!` | Yes | — | The creator custom attribute key, as listed by `customAttributeSchemas(entity: CREATOR)`. The `labels` key and read-only keys are refused. |

## Returns

| Name | Type | Description |
| --- | --- | --- |
| `acceptedCount` | `Int!` | Number of distinct creators the call covers. 0 when userErrors is non-empty. |
| `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 the write runs as a background operation. False when it was written in the request or userErrors is non-empty. |
| `updatedCount` | `Int!` | Number of creators written in the request. 0 when the write was scheduled or refused. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | Errors that refused the whole request: an empty or oversized list, an unknown creator id, an unknown or read-only key, a value the key does not accept, too many bulk operations in flight, or a workspace with no user to attribute the write to. Empty on success. |

## Examples

### Clear a creator custom attribute

Remove one custom attribute value from a creator.

```graphql
mutation ClearCreatorCustomAttributeDefault($creatorIds: [ID!]!, $key: String!) {
  clearCreatorCustomAttribute(creatorIds: $creatorIds, key: $key) {
    scheduled
    operationId
    acceptedCount
    updatedCount
    userErrors {
      field
      message
    }
  }
}
```

Variables:

```json
{
  "creatorIds": [
    "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0"
  ],
  "key": "full_name"
}
```

Response — HTTP 200:

```json
{
  "data": {
    "clearCreatorCustomAttribute": {
      "scheduled": false,
      "operationId": null,
      "acceptedCount": 1,
      "updatedCount": 1,
      "userErrors": []
    }
  }
}
```