convert_idea_to_draft

Convert idea to draft

Atomically create or return the idea's existing draft. To schedule it, next call schedule_post with the returned post_id and post_version.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:content
Workspace requirement: Authorized workspace and current membership required

Draft creation permission or an owned workspace profile.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "idea_id": {
      "description": "Idea id.",
      "minimum": 1,
      "type": "integer"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "idea_id"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "created": {
      "description": "Created.",
      "type": "boolean"
    },
    "idea_id": {
      "description": "Idea id.",
      "minimum": 1,
      "type": "integer"
    },
    "next_step": {
      "description": "Next step.",
      "type": "string"
    },
    "post_id": {
      "description": "Public post sqid.",
      "maxLength": 32,
      "minLength": 1,
      "type": "string"
    },
    "post_version": {
      "description": "Post version.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "idea_id",
    "post_id",
    "created",
    "next_step",
    "post_version"
  ],
  "type": "object"
}

Example arguments

{
  "idea_id": 381,
  "team_id": 42
}

Example result

{
  "created": true,
  "idea_id": 381,
  "next_step": "Call schedule_post with post_id, scheduled_on, expected_version, and optionally account_id.",
  "post_id": "R8m3Nk2V",
  "post_version": 1
}

Errors and retry

Requires current workspace membership; conversion also requires draft creation permission or an owned profile. Unknown and cross-workspace source/idea IDs return not found. Source creation accepts public HTTPS HTML only (1 MB maximum); fetch failures appear asynchronously in status=failed and error. AI usage is tracked and mcp:ai creation is limited to 30 calls per user per hour; no additional MCP AI quota is enforced.

Reads are safe to retry and pending/processing sources should be polled with get_content_source. Before retrying source creation after an ambiguous response, list sources to avoid duplicate jobs. Idea conversion is atomic and returns the existing draft on retry; read state before retrying deletion.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

services.repurposing.convert_idea_to_draft