See Stacksync in action with a solution architect. Book a demo ↗
GeniesConversations

Genie conversations

Get a Genie conversation

GET
/v1/workspaces/{workspace_id}/genies/conversations/{genie_conversation_id}

One conversation: its messages and the customer-visible steps the Genie took. Internal steps and raw prompts are never returned.

Authorization

Authorizationstringheaderrequired

Bearer <key>, where <key> is a workspace API key or a user API key. See Authentication.

Path Parameters

workspace_id*integer

The workspace. List the ones your key can reach with GET /v1/workspaces.

genie_conversation_id*string

The Genie conversation.

Formatuuid

Query Parameters

region*Regions

Region of the genie: besg (Europe) or usnv (United States)

Value in"besg""usnv"

Response Body

OK

application/json
  1. response
conversation_id*Conversation Id
region*Regions
Value in"besg""usnv"
messages*array<>
steps*array<>
Get a Genie conversation
curl -X GET 'https://api.stacksync.com/v1/workspaces/0/genies/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08?region=besg'
{  "conversation_id": "<conversation_id>",  "region": "besg",  "messages": [    {      "message_id": "<message_id>",      "created_time": "<created_time>",      "channel": "<channel>",      "sender_role": "<sender_role>",      "sender_name": "<sender_name>",      "body": "<body>",      "attachments": [        {          "name": "<name>",          "mime_type": "<mime_type>",          "size_bytes": 0,          "file_id": "<file_id>"        }      ],      "approval": {        "approval_id": "<approval_id>",        "status": "<status>",        "module_id": "<module_id>",        "module_name": "<module_name>",        "channel_type": "<channel_type>",        "target": "<target>",        "instructions": "<instructions>",        "requested_at": "<requested_at>",        "decision_at": "<decision_at>",        "approver_name": "<approver_name>"      }    }  ],  "steps": [    {      "description": "<description>",      "execution_status": "<execution_status>",      "error_message": "<error_message>",      "log_type": "<log_type>",      "execution_log_id": "<execution_log_id>",      "started_time": "<started_time>",      "finished_time": "<finished_time>",      "duration_ms": 0    }  ]}