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

# Create an Agent from a template

> Applies a reseller template to the selected Agent account, creates staging and live Agent configurations, and publishes the result. Supply values for the template's declared fields and verify the returned live configuration before using it.




## OpenAPI

````yaml post /api/v2/createAgentFromTemplate
openapi: 3.0.0
info:
  version: 2.0.0
  title: Vida API
  description: Vida API Documentation
servers:
  - url: https://api.vida.dev
    description: Vida Production
    variables:
      baseUrl:
        default: api.vida.dev
        description: Production API Root
security: []
tags:
  - name: Agents
  - name: Inbound Email
    description: Control which senders may create inbound email work for an Agent.
  - name: Features
    description: Inspect capabilities available within an account hierarchy.
  - name: Conversation Logs
    description: Query conversation activity and calculate account-level metrics.
  - name: Computer Agents
    description: Set up, configure, inspect, and manage Vida Computer Agents.
  - name: Computer Agent Sessions
    description: View and reset Computer Agent sessions.
  - name: Accounts
  - name: Agent Templates
    description: Create, manage, and apply reusable Agent configurations.
paths:
  /api/v2/createAgentFromTemplate:
    post:
      tags:
        - Agent Templates
      summary: Create an Agent from a template
      description: >
        Applies a reseller template to the selected Agent account, creates
        staging and live Agent configurations, and publishes the result. Supply
        values for the template's declared fields and verify the returned live
        configuration before using it.
      operationId: legacyPostAgents
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - templateId
              properties:
                templateId:
                  type: string
                  description: Template to apply.
                templateFields:
                  type: array
                  description: Values for the template's declared onboarding fields.
                  items:
                    type: object
                    additionalProperties: true
                timezone:
                  type: string
                  description: IANA timezone for the new Agent.
                agentVoice:
                  type: string
                  description: Voice identifier selected from the Agent voice catalog.
      responses:
        '201':
          description: Agent created and published from the template
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  stagingAgent:
                    type: object
                    additionalProperties: true
                  defaultAgent:
                    type: object
                    additionalProperties: true
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````