Genies

Create a genie

The configuration's defaults are the web app's (every tool on); the description is written by Stacksync from the instructions. Send a configuration made by the genies setup wizard (genies.stacksync.com .../genies/wizard/generate-config) after filling the connection of each skill.

post/v1/workspaces/{workspace_id}/genies

Request

  • Base URL
    https://api.stacksync.com
  • URL
    https://api.stacksync.com/v1/workspaces/{workspace_id}/genies
  • Auth
    HTTP bearer

Path parameters

workspace_idinteger required

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

Query parameters

region'besg' | 'usnv' required

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

Headers

Idempotency-Keystring nullable

Makes the create retry-safe for 24 hours: a retry with the same key answers the resource the first call created, with the Idempotent-Replayed: true header, and creates nothing. 1 to 255 visible ASCII characters. The same key with a different request answers 422; while the first call still runs, 409.

Request body

namestring required

Unique among the workspace's genies of the region

folder_idstring uuid nullable

The folder to create it in; the root when absent

is_shared_with_workspaceboolean

Whether every member of the workspace sees it

validate_onlyboolean

Run every check of the write and answer 204 without writing: a refused write answers the error the write would

Response

Created

genie_idstring required
namestring required
region'besg' | 'usnv' required
folder_idstring nullable
statusstring nullable
public_access_rightsstring nullable
is_shared_with_workspaceboolean nullable
has_api_keyboolean required

Whether an LLM API key of yours is stored (the key itself is never returned)

created_timestring date-time nullable
last_modified_timestring date-time nullable

Changes

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