> ## Documentation Index > Fetch the complete documentation index at: https://docs.deepslate.eu/llms.txt > Use this file to discover all available pages before exploring further. # Create Assistant > Creates a new assistant within the specified organization with the given configuration, including extensions and call event hooks. ## OpenAPI ````yaml POST /api/v1/vendors/{vendorId}/organizations/{organizationId}/assistants openapi: 3.1.0 info: title: Deepslate description: OpenAPI specification of the public Deepslate API version: v1.0 servers: - url: https://app.deepslate.eu description: Generated server url security: [] tags: - name: SIP Credentials Management description: API endpoints for managing SIP Credentials within an Organization - name: Assistant Management description: API endpoints for managing Assistants within an Organization - name: SIP Numbers Management description: API endpoints for managing SIP Numbers within an Organization - name: Agent Task Management description: API endpoints for retrieving Agent Tasks - name: Organization Management description: API endpoints for managing Organizations - name: Agent Management description: API endpoints for managing Agents within an Organization - name: LLM Generation Strategy Management description: >- API endpoints for managing LLM Generation Strategies within an Organization paths: /api/v1/vendors/{vendorId}/organizations/{organizationId}/assistants: post: tags: - Assistant Management summary: Create Assistant description: >- Creates a new assistant within the specified organization with the given configuration, including extensions and call event hooks. operationId: createAssistant parameters: - name: vendorId in: path description: ID of the Vendor (UUID) required: true schema: type: string example: a1b2c3d4-e5f6-7890-1234-567890abcdef - name: organizationId in: path description: ID of the Organization (UUID) required: true schema: type: string example: f0e9d8c7-b6a5-4321-fedc-ba9876543210 requestBody: description: Assistant creation data content: application/json: schema: $ref: '#/components/schemas/AssistantCreate' required: true responses: '200': description: Assistant successfully created content: application/json: schema: $ref: '#/components/schemas/AssistantDetailsResponse' '400': description: Bad Request - Invalid input data '401': description: Unauthorized '403': description: Forbidden - User does not have permission '404': description: Organization or Vendor not found components: schemas: AssistantCreate: type: object description: Data required to create a new Assistant properties: name: type: string description: Name of the assistant. example: Help Desk Assistant systemPromptGreeting: type: string description: Initial greeting message from the assistant. example: Hello! How can I help you with our products today? systemPrompt: type: string description: Main system prompt defining the assistant's role and behavior. example: >- You are a customer support assistant for ACME Gadgets. Be polite, helpful, and concise. Escalate complex issues to a human agent if necessary. telephoneNumberId: type: string description: ID of the telephone number assigned to this assistant (UUID). example: 11223344-5566-7788-9900-aabbccddeeff llmAudioContentGenerationStrategyId: type: string description: >- ID of the LLM Audio Content Generation Strategy used by the assistant (UUID). example: abcdef01-2345-6789-abcd-ef0123456789 extensions: type: array description: List of LLM extensions configured for this assistant. items: $ref: '#/components/schemas/AssistantCreateLlmExtension' callEventHooks: type: array description: List of Call Event Hooks configured for this assistant. items: $ref: '#/components/schemas/AssistantCreateCallEventHook' required: - callEventHooks - extensions - llmAudioContentGenerationStrategyId - name - systemPrompt - systemPromptGreeting AssistantDetailsResponse: type: object description: Standard API response wrapper properties: success: type: boolean description: Indicates if the request was successful example: true message: type: string description: Human-readable message data: $ref: '#/components/schemas/AssistantDetails' description: Payload data object timestamp: type: string format: date-time description: Response timestamp in ISO-8601 format example: '2025-04-17T14:23:30Z' traceId: type: string description: Correlation or trace ID required: - success - timestamp AssistantCreateLlmExtension: type: object description: Configuration for an LLM Extension (without ID, as it's being created) properties: type: type: string description: Type identifier for the LLM extension. example: kb_search_v2 parameters: type: object additionalProperties: type: object description: >- Specific parameters for this extension instance (structure depends on the extension type). example: kb_url: https://kb.example.com/api max_results: 3 required: - parameters - type AssistantCreateCallEventHook: type: object description: Configuration for a Call Event Hook (without ID, as it's being created) properties: type: type: string description: Type identifier for the call event hook. example: webhook_transcript_ready_v1 parameters: type: object additionalProperties: type: string description: >- Specific parameters for this hook instance (structure depends on the hook type). example: target_url: https://my.internal.service/transcript secret_key: s3cr3t_tr4nscr1pt required: - parameters - type AssistantDetails: type: object description: Detailed view of an Assistant's configuration. properties: id: type: string description: Unique identifier of the assistant (UUID). example: 550e8400-e29b-41d4-a716-446655440000 name: type: string description: Name of the assistant. example: Help Desk Assistant systemPrompt: type: string description: Main system prompt defining the assistant's role and behavior. example: >- You are a customer support assistant for ACME Gadgets. Be polite, helpful, and concise. Escalate complex issues to a human agent if necessary. llmAudioContentGenerationStrategyId: type: string description: >- ID of the LLM Audio Content Generation Strategy used by the assistant (UUID). example: abcdef01-2345-6789-abcd-ef0123456789 telephoneNumberId: type: string description: ID of the telephone number assigned to this assistant (UUID). example: 11223344-5566-7788-9900-aabbccddeeff extensions: type: array description: List of LLM extensions configured for this assistant. items: $ref: '#/components/schemas/AssistantDetailsLlmExtension' callEventHooks: type: array description: List of Call Event Hooks configured for this assistant. items: $ref: '#/components/schemas/AssistantDetailsCallEventHook' systemPromptGreeting: type: string description: Initial greeting message from the assistant. example: Hello! How can I help you with our products today? required: - callEventHooks - extensions - id - llmAudioContentGenerationStrategyId - name - systemPrompt - systemPromptGreeting AssistantDetailsLlmExtension: type: object description: Configuration details for an existing LLM Extension. properties: id: type: string description: Unique identifier of the LLM extension instance (UUID). example: deadbeef-cafe-babe-feed-faceabadb001 name: type: string description: Name of the LLM extension. example: Knowledge Base Search type: type: string description: Type identifier for the LLM extension. example: kb_search_v2 parameters: type: object additionalProperties: type: object description: >- Specific parameters for this extension instance (structure depends on the extension type). Null values may be present. example: kb_url: https://kb.example.com/api max_results: 3 auth_token: null required: - id - name - parameters - type AssistantDetailsCallEventHook: type: object description: Configuration details for an existing Call Event Hook. properties: id: type: string description: Unique identifier of the call event hook instance (UUID). example: b00bface-1337-badd-cafe-d00df00dcafe type: type: string description: Type identifier for the call event hook. example: webhook_transcript_ready_v1 parameters: type: object additionalProperties: type: string description: >- Specific parameters for this hook instance (structure depends on the hook type). example: target_url: https://my.internal.service/transcript secret_key: s3cr3t_tr4nscr1pt required: - id - parameters - type ````