> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Import template

> Import a public or private template into a workspace via the Nedzo REST API. The import is queued and returns an importId to track the job.

Import a template into a workspace. The import is queued for processing and completes quickly; the returned `importId` identifies the job.

Public templates can be imported by any account. Private templates can only be imported by the owning account.

<Tip>
  `workspaceId` is always required for this endpoint — it identifies the target workspace to import into and cannot be inferred from the API key. See [Workspace ID and Request Scope](/authentication#workspace-id-and-request-scope).
</Tip>

## Body Parameters

<ParamField body="workspaceId" type="string" required>
  Target workspace to import the template into.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.nedzo.ai/v1/templates/123e4567-e89b-12d3-a456-426614174000/import" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"workspaceId": "789e4567-e89b-12d3-a456-426614174000"}'
  ```
</RequestExample>

<ResponseExample>
  ```json Response (201) theme={null}
  {
    "importId": "abc12345-e89b-12d3-a456-426614174000",
    "status": "queued",
    "validation": {
      "valid": true,
      "itemCounts": {
        "agents": 1,
        "workflows": 0,
        "customFields": 0,
        "tags": 0
      },
      "warnings": [],
      "errors": []
    },
    "message": "Import queued successfully."
  }
  ```
</ResponseExample>