Skip to content
Docs

API & Automation

Generate Enterprise lets external systems trigger its AI over HTTP. Account-level API Keys trigger workflows (and the HTTP trigger of workflows built in the Workflow Builder), while an individual agent’s API Access provides a dedicated endpoint for running that one agent. Both authenticate with an X-API-Key header. Generate does not publish a general-purpose REST API beyond these trigger surfaces.

What are API Keys in Generate?

Section titled “What are API Keys in Generate?”

API Keys are managed under Settings → API Keys — “Manage API keys used to trigger workflows from external systems.” Each key shows a Name, masked Prefix (wfk_…), Last used time, and Status (Active or Revoked). There is a single key type — no separate scopes — and a key is “authorized on every workflow you own and every workflow shared with you.” The token is shown only once at creation; revoking a key immediately disables every caller using it.

How do you trigger a single agent over HTTP?

Section titled “How do you trigger a single agent over HTTP?”

Enable API Access on the agent. Generate then exposes a public endpoint POST /api/v1/triggers/agent/{agentId}, authenticated with the X-API-Key header. It accepts either JSON or multipart (JSON body plus file uploads) and runs synchronously, returning the answer, citations, and conversation id.

Terminal window
curl -X POST "https://<your-domain>/api/v1/triggers/agent/{agentId}" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Summarize the latest release." }'

How do you trigger a workflow over HTTP?

Section titled “How do you trigger a workflow over HTTP?”

Add an HTTP Trigger node to a workflow to expose POST /api/v1/triggers/{workflowId} (authenticated with X-API-Key; a key is auto-provisioned and managed in Settings → API Keys). The node defines typed input variables (String, Number, Boolean, URL, Object); the request runs synchronously and returns whatever the workflow’s HTTP Response node produces. The builder’s Test Endpoint panel provides ready-made cURL, TypeScript, and Python examples.

Can agents run automatically on a schedule?

Section titled “Can agents run automatically on a schedule?”

Yes — scheduled jobs run an agent one-time or on a recurring cron schedule (see Agents and Workflow Builder).

Sources and references

Section titled “Sources and references”
  • Full customer documentation: account/api-keys and features/agents/api-access on the Generate Enterprise docs site.