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

# growth_routine_update

Save an agreed growth routine with the current revision. Initial activation starts today; later changes take effect tomorrow and preserve history. This does not authorize posting, sending or a new schedule. 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
{
  "revision": 0,
  "timeZone": "Europe/London",
  "enabled": true,
  "habits": [
    {
      "id": "daily-social",
      "title": "Publish something useful",
      "kind": "social",
      "purpose": "Help the right people discover the product.",
      "doneWhen": "One useful post is published on the selected channel.",
      "intervalDays": 1,
      "startDate": "2099-01-01",
      "targetCount": 1,
      "owner": "together",
      "enabled": true
    }
  ],
  "requestId": "example-growth_routine_update-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": {
    "revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "habits": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,100}$"
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 160
          },
          "kind": {
            "type": "string",
            "enum": [
              "social",
              "engagement",
              "content",
              "email",
              "release",
              "conversion",
              "customer",
              "custom"
            ]
          },
          "purpose": {
            "type": "string",
            "minLength": 5,
            "maxLength": 600
          },
          "doneWhen": {
            "type": "string",
            "minLength": 5,
            "maxLength": 600
          },
          "intervalDays": {
            "type": "integer",
            "minimum": 1,
            "maximum": 365
          },
          "startDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "targetCount": {
            "default": 1,
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "owner": {
            "default": "together",
            "type": "string",
            "enum": [
              "agent",
              "human",
              "together"
            ]
          },
          "enabled": {
            "default": true,
            "type": "boolean"
          },
          "accountId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,100}$"
          }
        },
        "required": [
          "id",
          "title",
          "kind",
          "purpose",
          "doneWhen",
          "intervalDays",
          "startDate"
        ],
        "additionalProperties": false
      }
    },
    "enabled": {
      "type": "boolean"
    },
    "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": [
    "revision",
    "timeZone",
    "habits",
    "enabled"
  ],
  "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)