Genie conversations
List Genie conversations
The Genie conversations of a workspace in one region, newest activity first, in cursor pages.
Authorization
AuthorizationstringheaderrequiredBearer <key>, where <key> is a workspace API key or a user API key. See Authentication.
workspace_id*integerThe workspace. List the ones your key can reach with GET /v1/workspaces.
region*RegionsData region of the resources: besg (Europe) or usnv (United States), as GET /v1/regions lists them.
"besg""usnv"genie_id?|Only the conversations of this genie
nulllimit?LimitMaximum number of conversations returned, at most 100
1 <= value <= 10050cursor?|next_cursor of the previous page
nullOK
application/json- response
data*array<>has_more*Has Morenext_cursor?|Pass it as cursor for the next page
nullcurl -X GET 'https://api.stacksync.com/v1/workspaces/0/genies/conversations?region=besg'{ "data": [ { "conversation_id": "<conversation_id>", "genie_id": "<genie_id>", "genie_name": "<genie_name>", "name": "<name>", "status": "<status>", "status_label": "<status_label>", "last_activity_time": "<last_activity_time>", "message_count": 0, "step_count": 0 } ], "has_more": false, "next_cursor": "<next_cursor>"}POSTSet a Genie access grant
Gives a user or a group a role on a Genie (operator uses it, editor changes it, owner manages its access), changes it, or removes it (role null). Who may change access is decided per genie, as in the web app: an owner of the genie, or a workspace admin adding an owner. A genie always keeps one owner.
GETGet a Genie conversation
One conversation: its messages and the customer-visible steps the Genie took. Internal steps and raw prompts are never returned.