Genies
List Genies
The Genies of the workspace in one region, newest first.
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.
limit?LimitMaximum number of items returned, at most 200
1 <= value <= 20050offset?OffsetNumber of items skipped before the first one returned
0 <= value0region*RegionsRegion to list: besg or usnv
"besg""usnv"folder_id?|Only the genies of this folder; every genie of the workspace when absent
nullsearch?|Only genies whose name contains this text
nullOK
application/json- response
data*array<>has_more*Has MoreWhether more items follow this page: request the next one with offset + limit
limit*Limitoffset*Offsetcurl -X GET 'https://api.stacksync.com/v1/workspaces/0/genies?region=besg'{ "data": [ { "genie_id": "<genie_id>", "name": "<name>", "status": "<status>", "region": "besg", "apps": [ "<apps>" ], "folder_id": "<folder_id>", "last_modified_time": "2027-01-15T09:00:00Z" } ], "has_more": false, "limit": 0, "offset": 0}POSTRun a Genie and wait for the result
Sends a message to a Genie and answers once the Genie has finished with it, so the reply is in the same response. A Genie that calls several tools can take minutes; keep the connection open or use Run a Genie and poll instead. Omit genie_id to let the workspace's Genie dispatcher pick the Genie; pass conversation_id to continue an earlier conversation. The answer has the same shape as Get a Genie run.
GETList Genie logs
A Genie's logs by conversation: per message, what it was asked, what it answered, the tools it called and the tokens and cost used.