Ideas

Update idea

Changes only the fields you send. media_ids and label_ids replace the whole list. Moving the idea to another stage with idea_stage_id puts it at the end of that stage. The idea must keep a title, a body or media.

put/ideas/{idea}

Request

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

Request body

titlestring nullable
bodystring nullable
idea_stage_idstring uuid nullable

Stage of this workspace. null is Unassigned.

media_idsstring[]

Media to attach, by id: the id of a media item of a post or idea of this workspace, or the media_id of a signed upload. A file taken from a post or idea is copied with a new id; an unclaimed signed upload is attached as is and keeps its id.

label_idsstring[]

Labels of this workspace.

Response

The updated 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.