> ## Documentation Index > Fetch the complete documentation index at: https://docs.superu.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get agent version > Fetches one version for an agent by version ID. ## OpenAPI ````yaml /api-reference/openapi.json post /agent/version/get openapi: 3.1.0 info: title: SuperU API description: >- Comprehensive API reference for SuperU voice agents, calls, tools, contacts, audiences, and knowledge bases. version: 1.0.0 servers: - url: https://voip-middlware.superu.ai description: Production security: - superUApiKey: [] tags: - name: Calls description: Create and analyze calls. - name: Agents description: Create, list, import, update, and delete agents. - name: Agent Versions description: Manage versions for existing agents. - name: Phone Numbers description: Fetch phone numbers available in your account. - name: Call Logs description: Retrieve call history with filters. - name: Tools description: Create and manage callable tools. - name: Folders description: Organize agents into folders. - name: Contacts description: Create and list contacts. - name: Audiences description: Create and manage audiences and contacts. - name: Knowledge Base description: Upload and manage knowledge bases. - name: Campaigns description: Create and manage outbound campaigns with automated workflows. paths: /agent/version/get: post: tags: - Agent Versions summary: Get agent version description: Fetches one version for an agent by version ID. operationId: getAgentVersion requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AgentVersionGetRequest' example: agent_id: 04cf74f7-019b-4c3d-883c-610a42b32bc4 version: 1.0.0 description: Request body for Get agent version. responses: '200': description: Version retrieved content: application/json: schema: $ref: '#/components/schemas/GenericResponse' example: version_id: 69c228b11e62cb42009fe445 agent_id: 04cf74f7-019b-4c3d-883c-610a42b32bc4 version: 1.0.1 assistant_config: id: 04cf74f7-019b-4c3d-883c-610a42b32bc4 orgId: 1d23cc8c-8ccb-4a19-a1e8-d2dc72e8848d name: Acme Dental Clinic - AI Receptionist voice: model: eleven_turbo_v2_5 voiceId: EXAVITQu4vr4xnSDxMaL provider: 11labs model: model: openai/gpt-oss-120b provider: groq messages: - role: system content: >- You are Emma, the warm and professional AI receptionist for Acme Dental Clinic... firstMessage: >- Thank you for calling Acme Dental Clinic! This is Emma. How can I help you today? transcriber: model: nova-2 language: en provider: deepgram analysisPlan: summaryPlan: messages: - role: system content: >- Create a concise call summary and structured details... messagePlan: idleMessages: - Are you there? - Can you hear me? - Should I continue? idleMessageMaxSpokenCount: 2 idleTimeoutSeconds: 5 server: url: https://voip-middlware.superu.ai/vapi/webhook timeoutSeconds: 20 knowledge_base: {} tools: [] composio_app: {} call_forwarding: null created_at: '2026-03-24 06:01:21' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' '501': $ref: '#/components/responses/NotImplemented' x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \\ --url https://voip-middlware.superu.ai/agent/version/get \\ --header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\ --data '{ "agent_id": "04cf74f7-019b-4c3d-883c-610a42b32bc4", "version": "69f884d50c4e5a2dc72277d4" }' - lang: python label: Python source: |- from superu import SuperU client = SuperU("YOUR_SUPERU_API_KEY") payload = { "agent_id": "04cf74f7-019b-4c3d-883c-610a42b32bc4", "version": "69f884d50c4e5a2dc72277d4" } response = client.agents.get_version(**payload) print(response) components: schemas: AgentVersionGetRequest: allOf: - type: object required: - agent_id - version properties: agent_id: type: string description: Agent ID example: 04cf74f7-019b-4c3d-883c-610a42b32bc4 version: type: string description: Version ID example: 69f884d50c4e5a2dc72277d4 description: Agent Version Get Request schema. GenericResponse: type: object properties: status: type: string description: Indicates if the request was successful. example: success message: type: string description: A descriptive message about the result of the request. example: Request completed successfully data: type: object additionalProperties: true description: The payload of the response, if any. additionalProperties: true description: A generic response schema for successful API calls. ErrorResponse: type: object required: - message properties: status: type: string example: error description: Status value. message: type: string example: Invalid request payload description: Message value. error: type: string example: Bad Request description: Error value. code: type: string example: BAD_REQUEST description: Code value. additionalProperties: true description: Error Response schema. responses: BadRequest: description: Bad Request - invalid parameters or payload. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: BAD_REQUEST message: Request validation failed. Unauthorized: description: Unauthorized - missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: UNAUTHORIZED message: Invalid or missing superU-Api-Key. NotFound: description: Not Found - requested resource does not exist. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: NOT_FOUND message: Resource not found. InternalServerError: description: Internal Server Error - unexpected backend error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: INTERNAL_SERVER_ERROR message: An unexpected server error occurred. NotImplemented: description: >- Not Implemented - this action is not available in the current deployment. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: NOT_IMPLEMENTED message: This endpoint is not implemented for your workspace. securitySchemes: superUApiKey: type: apiKey in: header name: superU-Api-Key description: Your SuperU API key. ````