Tool

Get an idea

Read an idea's full content by its id: the Markdown body, properties, the posts embedded in the body, uploaded attachments and the posts made from it. Read it before drafting a post from it or updating it.

POSTtools.readFree

POST/openapi/v1/tools/get_idea

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/get_idea \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<id>"}'

The MCP tool is named cuekoo_get_idea. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.read.

Name	Type	Required
`id`	`string`	Required

Response

Name	Type	Required	Description
`attachments`	`object[] \| null`	Required
`attachments[].kind`	`string`	Required
`attachments[].media_id`	`string`	Required
`attachments[].status`	`string`	Required
`attachments[].url`	`string`	Required
`embeds`	`object[] \| null`	Required
`embeds[].platform`	`string`	Required
`embeds[].post_id`	`string`	Required
`embeds[].url`	`string`	Required
`idea`	`object`	Required
`idea.archived`	`boolean`	Required
`idea.assignee`	`object \| null`	Required
`idea.assignee.display_name`	`string`	Required
`idea.assignee.id`	`string`	Required
`idea.body`	`string`	Required	Markdown; media:<id> images and videos, a post link alone on a line is an embed
`idea.created_at`	`string`	Required
`idea.due_date`	`string \| null`	Required
`idea.group`	`object`	Required
`idea.group.id`	`string`	Required
`idea.group.is_done`	`boolean`	Required
`idea.group.name`	`string`	Required
`idea.id`	`string`	Required
`idea.platforms`	`string[] \| null`	Required
`idea.post_count`	`integer`	Required
`idea.tags`	`object[] \| null`	Required
`idea.tags[].color`	`string`	Required
`idea.tags[].id`	`string`	Required
`idea.tags[].name`	`string`	Required
`idea.title`	`string`	Required
`idea.updated_at`	`string`	Required
`idea.version`	`integer`	Required	Pass this version to update_idea
`posts`	`object[] \| null`	Required
`posts[].caption`	`string`	Required	The first 200 characters
`posts[].channel_username`	`string`	Required
`posts[].id`	`string`	Required
`posts[].outcome`	`string`	Required
`posts[].platform`	`string`	Required
`posts[].scheduled_at`	`string \| null`	Required
`posts[].state`	`string`	Required
`posts[].url`	`string`	Required

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

This Tool is free. It does not reserve or spend credits.