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.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/ai/generators"{ "data": [ { "id": "string", "description": "string", "inputSchema": {}, "outputSchema": {}, "policy": "structured.fast", "stream": true, "agentVisible": true, "examples": [ { "input": null, "output": null } ] } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}List the featured AI models
Returns the curated model catalog the picker offers, each entry carrying its label, icon, relative allowance cost multiplier, speed and intelligence ratings, and whether it accepts image input. No authentication: this operation carries no auth middleware and the catalog is a static, workspace-independent list.
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.