Ideas

Move idea

Moves an idea to a stage (or to Unassigned with idea_stage_id: null) and sets the order of that stage. idea_ids is the full order of the target stage after the move: every idea already in it plus the moved idea, each once. When the list does not match the ideas in that stage (someone changed the board), the request returns 422 on idea_ids and nothing moves.

put/ideas/{idea}/move

Request

  • Base URL: https://app.trypost.it/api
  • URL: https://app.trypost.it/api/ideas/{idea}/move
  • Auth: HTTP bearer

Request body

idea_stage_idstring uuid nullable

Target stage. null or omitted is Unassigned.

idea_idsstring[] required

Full order of the target stage, including the moved idea.

Response

The moved idea.

idstring uuid
idea_stage_idstring uuid nullable

Stage (board column) of the idea. null is Unassigned.

titlestring nullable
bodystring nullable
positioninteger

Order within its stage, starting at 0.

created_atstring

UTC, format Y-m-d H:i:s.

updated_atstring

UTC, format Y-m-d H:i:s.

Example response

{
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "launch.jpg",
      "size": 482113,
      "meta": {
        "width": 1080,
        "height": 1350,
        "alt_text": "Product launch banner"
      }
    }
  ],
  "labels": [
    {
      "color": "#2563EB",
      "created_at": "2026-09-01 10:00:00",
      "updated_at": "2026-09-01 10:00:00"
    }
  ],
  "created_at": "2026-10-07 18:20:00",
  "updated_at": "2026-10-07 18:20:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.