SnozeDevelopers
API referenceAi

List the AI generators available in a workspace

Returns the descriptor for every registered one-shot generator that the generate operation can run. Requires an authenticated caller who is a member of the workspace.

GET
/v1/workspaces/{workspaceId}/ai/generators

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Response Body

Success

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/ai/generators'
Example Response
{  "data": [    {      "id": "string",      "description": "string",      "inputSchema": {},      "outputSchema": {},      "policy": "structured.fast",      "stream": true,      "agentVisible": true,      "examples": [        {          "input": null,          "output": null        }      ]    }  ]}

List the featured AI models

Returns enabled models from the published admin catalog, with display, capability, and minimum-plan configuration. Public and workspace-independent.

Run an AI generator and return its structured result

Runs the named generator as a single non-streaming model call with a schema-constrained output, allowing one repair attempt when the model misses the schema, and returns the decoded result with token usage. Requires a workspace member with the `ai:write` permission, and the call consumes the workspace AI allowance: a workspace that has reached its limit is refused before the model is called. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.