Write

set_submission_status

Sets or updates the public handle (slug) for an Outli.ne profile.

Parameters

Name	Type	Required	Description
outlineId	string	—	The numeric ID of the outline to update. Omit to target the authenticated creator's own outline. Pass explicitly only when a creator owns multiple outlines and you need a specific one.
handle	string	Yes	The new public handle (slug) for the profile. Must meet formatting rules (lowercase, alphanumeric, dashes) and be unique.

Response

Field	Type	What it means
outlineId	string	The numeric ID (as a string) of the outline that was updated.
handle	string	The public handle that was saved to the outline.
publicUrl	string	The URL where the profile will be accessible once published (e.g., https://outli.ne/maya).

Example

Request

json

{
  "handle": "maya-chen"
}

Response

json

{
  "outlineId": "42",
  "handle": "maya-chen",
  "publicUrl": "https://outli.ne/maya-chen"
}

When to use

Call this tool when a creator wants to set their unique Outli.ne handle, or when preparing an outline for publishing, as a handle is required before a profile can go public.

Watch out

outlineId defaults to the authenticated creator's own outline — omitting it is the common case and is safe
The tool enforces uniqueness globally across all tenants. If a handle is taken, the call returns a `VALIDATION_ERROR`.
The handle will be validated for length and allowed characters (e.g., no spaces).
IDOR is enforced inside resolveOutlineDoc; passing another user's outlineId returns NOT_FOUND, not FORBIDDEN, to avoid confirming existence

← All tools ← MCP Guide