Create template

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

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

API Reference

Workspaces

Agents

Contacts

Templates

Calls

Create template

Body Parameters

​Body Parameters

Body Parameters