Actions31
- Agent Actions
- Attachment Actions
- Comment Actions
- Config Actions
- Dartboard Actions
- Doc Actions
- Folder Actions
- Help Center Article Actions
- Skill Actions
- Task Actions
- View Actions
Agent → Create Agent
AI-generatedSummary
Create a new agent in the workspace.
Inputs
- item (required) — JSON payload for the new agent; includes at least instructions and optionally forwarding and local fields.
- requestOptions — HTTP request configuration for creating the agent; controls batching, SSL verification, proxy, and timeout.
- batching — Batch settings for throttling requests; includes batchSize (number) and batchInterval (ms).
- allowUnauthorizedCerts — If true, SSL certificate validation errors are ignored.
- proxy — HTTP proxy URL to use for the request.
- timeout — Request timeout in milliseconds.
Output shape
agent object
Returns the created agent details (including generated ID and full properties). No pagination; on error the response body contains error information.
Examples
Example 1: Create a new agent with minimal payload and batch processing enabled.
item={"instructions":{},"forwarding":{"workflows":[{}]},"local":{}}; requestOptions={{batching:{batch:{batchSize:10,batchInterval:0}}}}; other options use defaults.
Example 2: Create an agent via a corporate proxy while skipping SSL verification.
item as above; proxy="http://proxy.example.com:3128"; allowUnauthorizedCerts=true; timeout=15000; batching left default.