Documentation version: 2026-10-23.6
Canonical: https://docs.creator.gg/tools/growth_task_record.md

# growth_task_record

Record prepared, scheduled, blocked or completed work with a claimToken. Social/email resource IDs are verified through the provider; unavailable proof remains unconfirmed. Without a provider ID, completed work is labeled agent-reported. Evidence cannot complete the wrong day or be reused. Reuse the same requestId when retrying an uncertain operation.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: changes workspace data. requestId is required by the service (8–128 characters); reuse it only for the same action and arguments.


## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "taskId": "1:daily-social:2099-01-01",
  "claimToken": "crgc_example_not_a_real_token",
  "state": "prepared",
  "note": "Draft and asset are ready for human review.",
  "count": 1,
  "requestId": "example-growth_task_record-001"
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "taskId": {
      "type": "string",
      "maxLength": 160
    },
    "claimToken": {
      "type": "string",
      "maxLength": 160
    },
    "state": {
      "type": "string",
      "enum": [
        "done",
        "prepared",
        "scheduled",
        "blocked"
      ]
    },
    "note": {
      "type": "string",
      "minLength": 5,
      "maxLength": 1000
    },
    "count": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "resourceId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$"
    },
    "occurredAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "requestId": {
      "description": "Required by the Creator Platform service for mutations: a stable 8–128 character identifier. Reuse on retries; change for a new action.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
    }
  },
  "required": [
    "taskId",
    "state",
    "note"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [growth-routine](https://docs.creator.gg/guides/growth-routine.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)