Write

update_stack

Renames a stack (section heading) on a creator's outline.

Parameters

Name	Type	Required	Description
outlineId	string	—	The numeric Payload document ID of the outline to update. Omit to target the authenticated creator's own outline.
stackId	string	Yes	The ID of the stack (section) to rename. Must already exist in the outline — use list_cards or get_profile to discover valid stack IDs.
title	string	Yes	The new display title for the stack. Must be 1–200 characters.

Response

Field	Type	What it means
outlineId	string	The Payload document ID of the outline that was updated.
updated	object	Echo of what changed. Contains stackId (the stack that was renamed) and title (the new title that was applied).
updated.stackId	string	The ID of the stack that was renamed.
updated.title	string	The new title that is now live on the stack.

Example

Request

json

{
  "stackId": "stack_abc123",
  "title": "Wedding & Editorial Work"
}

Response

json

{
  "outlineId": "42",
  "updated": {
    "stackId": "stack_abc123",
    "title": "Wedding & Editorial Work"
  }
}

When to use

Call this during the curate or optimize phase when the creator wants to relabel a section after reviewing the full profile shape — for example, renaming a generic “Work” stack to something more specific like “Bridal & Editorial” once the card content is locked in. Also use it immediately after add_stack if the auto-generated title needs to be corrected.

Gotchas

Watch out

stackId must match an existing stack in the outline — a NOT_FOUND error is returned (not a silent no-op) if it doesn't match. Call list_cards first to confirm valid IDs.
title has a hard max of 200 characters and must be at least 1 character — an empty string will fail Zod validation before hitting the tool.
outlineId defaults to the authenticated user's own outline; passing another creator's ID will be rejected by ownership validation inside resolveOutlineDoc.
The tool only renames the stack title — it does not reorder stacks or change any cards within the stack. Use reorder_cards or update_card for those operations.

← All tools ← MCP Guide