Skip to main content
POST
Import Template Pack
Import a template pack to create or update a digital employee. If no target_agent_id is provided, a new host agent is created automatically to receive the imported employee.
Run Preview Template Import first to validate the pack and check for conflicts before executing the import.

Code Examples

Headers

Include your API key in the Authorization header as a Bearer token on every request.
integer
required
ID of the workspace. Required for all Digital Employees API requests.

Request Body

object
required
The template pack payload obtained from Export Template Pack.
integer
ID of the agent to import into. If omitted, a new host agent is created automatically.
string
How to handle naming conflicts with existing employees. Options:
  • skip — keep existing employees, skip conflicting imports (default)
  • rename — auto-rename imported employees to avoid conflicts
  • overwrite — replace existing employees with imported configuration

Response

Returns the import result object describing the employees created, updated, or skipped.

Errors

  • 422 with reason: digital_employee_template_import_blocked — the pack contains blocking issues that prevent import. Inspect the blocking_issues array in the response for details.
  • 422 — invalid pack structure or missing required fields.