Capture ideas

Every workspace has an Ideas board: ordered columns (by default Backlog, In Progress, Done) holding ideas with a title and optional notes. Reading needs the posts:read scope and changes need posts:write.

List the board

curl https://api.schedulin.app/v0/ideas \
  -H "x-api-key: $SCHEDULIN_API_KEY"

{
  "columns": [
    { "id": "col_1", "title": "Backlog", "order": 0, "isDone": false },
    { "id": "col_2", "title": "In Progress", "order": 1, "isDone": false },
    { "id": "col_3", "title": "Done", "order": 2, "isDone": true }
  ],
  "ideas": [
    {
      "id": "idea_42",
      "title": "Behind-the-scenes reel",
      "description": "Film the packing process",
      "columnId": "col_1",
      "order": 0,
      "completedAt": null,
      "createdAt": "2026-10-01T14:03:00.000Z",
      "updatedAt": "2026-10-01T14:03:00.000Z"
    }
  ]
}

Ideas are ordered by column, then by order (0 = top). The last column is the Done column.

Add an idea

POST /v0/ideas adds an idea to the bottom of columnId, or the first column when you leave it out. If the workspace has never opened its board, one is created with the default columns.

curl -X POST https://api.schedulin.app/v0/ideas \
  -H "x-api-key: $SCHEDULIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Carousel: 5 packing tips", "description": "Use the August photos" }'

const idea = await client.ideas.create({ title: "Carousel: 5 packing tips" });

idea = client.ideas.create(title="Carousel: 5 packing tips")

Edit or move an idea

PATCH /v0/ideas/{id} changes title or description (null clears it). With columnId it moves the idea to the bottom of that column. Moving it into the Done column sets completedAt, and moving it back out clears it.

curl -X PATCH https://api.schedulin.app/v0/ideas/idea_42 \
  -H "x-api-key: $SCHEDULIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "columnId": "col_3" }'

await client.ideas.update({ id: "idea_42", columnId: "col_3" });

client.ideas.update("idea_42", column_id="col_3")

Delete an idea

curl -X DELETE https://api.schedulin.app/v0/ideas/idea_42 \
  -H "x-api-key: $SCHEDULIN_API_KEY"

Deleting is permanent. Ideas and columns from another workspace return 404.