See Stacksync in action with a solution architect. Book a demo ↗
StacksyncDocs
StacksyncCommunityBook a demoContact Support
HomeTwo-way syncAgentic WorkflowsGeniesEnterprise OSMCPEDIConnectorsSecurity and Other ResourcesChangelogDevelopersAPI Reference
GeniesConversations

Genie conversations

Get a Genie browser session

GET
/v1/workspaces/{workspace_id}/genies/conversations/{genie_conversation_id}/browser-sessions/{session_id}

A browser session a Genie opened in a conversation: its status and, while live, its live view.

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
session_id*string

The browser session, as the conversation's steps name it.

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
session_id*Session Id
status?|
Defaultnull
live_view_url?|

Absent once the live browser has expired

Defaultnull
expires_at?|
Defaultnull
Get a Genie browser session
curl -X GET 'https://api.stacksync.com/v1/workspaces/0/genies/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/browser-sessions/string?region=besg'
{  "session_id": "<session_id>",  "status": "<status>",  "live_view_url": "<live_view_url>",  "expires_at": "<expires_at>"}

GETGet a Genie tool execution

One tool run of a conversation (a step's execution_log_id): how the tool was called and what came back.

GETGet a Genie run

Returns the state of a run started with Run a Genie and, once the Genie has answered, its latest reply. Pass the region the run answer carried: the conversation is read from that data region. While the Genie works, status is processing and there is no result; completed carries the reply in result and its id in message_id; failed means the run could not finish.