Skip to main content
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"
    }'

{
  "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

​
workspaceId
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.
​
templateType
string
required
Type of template to create. One of agent, workflow, or workspace.
​
agentId
string
Agent ID to create template from. Required when templateType is "agent".
​
workflowId
string
Workflow ID to create template from. Required when templateType is "workflow".
​
name
string
required
Template name (1-255 characters).
​
description
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"
    }'

{
  "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"
}