Sessions

Update session

Update session metadata (title, notes, tags, favorite, action_items). At least one field is required. Requires the sessions:write scope.

Action items round-trip. Pass a full action_items array to replace the list. Each item needs text; id, source, assignee, due_date, and completed are optional. Items with a known id preserve their original created_at, source and source_start. Omit id for new items and the server assigns one.

due_date is stored as an ISO calendar date (YYYY-MM-DD). Send ISO, or natural language such as "Friday", "next Tuesday" or "April 25" and the server normalizes it relative to today; null or "" clears it, and an unparseable value is rejected with 400 invalid_request. When a known item's text or normalized due_date changes, the server stamps user_edited_at (epoch ms) so Wave's extraction pipeline leaves hand-edited items alone.

For optimistic concurrency on action_items, send If-Match: <action_items_version>; the request is rejected with 409 conflict if another writer has bumped the version in between. Skip the header to force-overwrite.

patch/v1/sessions/{id}

Request

  • Base URL: https://api.wave.co
  • URL: https://api.wave.co/v1/sessions/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Session ID

Example:sess_01HX4R7MT8PQZ6VCN9ABYF2KJM

Headers

If-Matchstring

Expected current action_items_version (optional). Returns 409 if it disagrees.

Example:2

Request body

titlestring
notesstring
tagsstring[]
favoriteboolean

Example request

{
  "tags": [
    "work",
    "roadmap"
  ],
  "favorite": true,
  "action_items": [
    {
      "text": "Send legal the draft spec by Friday",
      "assignee": "JR",
      "due_date": "2025-04-25"
    },
    {
      "text": "Mock up the new placement UI",
      "assignee": "Sam"
    }
  ]
}

Response

Session updated

idstring required
updated_fieldsstring[] required
updated_atstring required
action_items_versionnumber

Example response

{
  "id": "sess_01HX4R7MT8PQZ6VCN9ABYF2KJM",
  "updated_fields": [
    "tags",
    "favorite",
    "action_items"
  ],
  "updated_at": "2025-04-21T17:14:08.120Z",
  "action_items_version": 3
}

Changes

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