Tool

Move a saved post

Move a post saved in Inspo to another collection, or out of any collection with an empty collection_id.

POSTtools.writeFree

POST/openapi/v1/tools/update_inspo

Call it

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

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

Arguments

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

Name	Type	Required	Description
`collection_id`	`string`	Required	The collection to move the post to; an empty string takes it out of any
`id`	`string`	Required

Response

Name	Type	Required	Description
`post`	`object`	Required
`post.caption`	`string`	Required
`post.collection_id`	`string \| null`	Required
`post.comments`	`integer \| null`	Required
`post.cover_url`	`string`	Required
`post.creator_handle`	`string`	Required
`post.id`	`string`	Required
`post.likes`	`integer \| null`	Required
`post.outlier_score`	`number \| null`	Required
`post.platform`	`string`	Required
`post.pool_post_id`	`string \| null`	Required
`post.post_id`	`string`	Required
`post.published_at`	`string \| null`	Required
`post.saved_at`	`string`	Required
`post.source`	`string`	Required
`post.url`	`string`	Required
`post.views`	`integer \| null`	Required	At save; never refreshed

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.