curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "agent",
"agentId": "456e4567-e89b-12d3-a456-426614174000",
"name": "Customer Onboarding Agent",
"description": "A voice agent template for onboarding"
}'
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "workflow",
"workflowId": "456e4567-e89b-12d3-a456-426614174000",
"name": "Lead Qualification Workflow"
}'
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "workspace",
"name": "Sales Team Starter",
"description": "Full workspace setup — agents, workflows, custom fields, and tags"
}'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Customer Onboarding Agent",
"description": "A voice agent template for onboarding",
"templateType": "agent",
"visibility": "private",
"schemaVersion": "1.0.0",
"snapshotSizeBytes": 15240,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
Templates
Create template
Create a new template from an agent, workflow, or entire workspace via the Nedzo REST API. Snapshots configuration for sharing or reuse.
POST
/
templates
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "agent",
"agentId": "456e4567-e89b-12d3-a456-426614174000",
"name": "Customer Onboarding Agent",
"description": "A voice agent template for onboarding"
}'
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "workflow",
"workflowId": "456e4567-e89b-12d3-a456-426614174000",
"name": "Lead Qualification Workflow"
}'
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "workspace",
"name": "Sales Team Starter",
"description": "Full workspace setup — agents, workflows, custom fields, and tags"
}'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Customer Onboarding Agent",
"description": "A voice agent template for onboarding",
"templateType": "agent",
"visibility": "private",
"schemaVersion": "1.0.0",
"snapshotSizeBytes": 15240,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
Create a new template. Specify
templateType as "agent", "workflow", or "workspace". For agent/workflow provide the corresponding agentId/workflowId. For workspace, the entire workspace is snapshotted (all agents, workflows, custom fields, and tags; contacts and conversations are excluded).
workspaceId is required for account-scoped API keys and inferred from the key for workspace-scoped keys. See Workspace ID and Request Scope.Body Parameters
string
Source workspace. For
agent/workflow templates: the workspace containing the source entity. For workspace templates: the workspace to snapshot. Required for account-scoped API keys, inferred from workspace-scoped keys if omitted.string
required
Type of template to create. One of
agent, workflow, or workspace.string
Agent ID to create template from. Required when
templateType is "agent".string
Workflow ID to create template from. Required when
templateType is "workflow".string
required
Template name (1-255 characters).
string
Template description (max 1000 characters).
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "agent",
"agentId": "456e4567-e89b-12d3-a456-426614174000",
"name": "Customer Onboarding Agent",
"description": "A voice agent template for onboarding"
}'
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "workflow",
"workflowId": "456e4567-e89b-12d3-a456-426614174000",
"name": "Lead Qualification Workflow"
}'
curl -X POST "https://api.nedzo.ai/v1/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"templateType": "workspace",
"name": "Sales Team Starter",
"description": "Full workspace setup — agents, workflows, custom fields, and tags"
}'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Customer Onboarding Agent",
"description": "A voice agent template for onboarding",
"templateType": "agent",
"visibility": "private",
"schemaVersion": "1.0.0",
"snapshotSizeBytes": 15240,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
Was this page helpful?
