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

# Translate a first message

> Translates an agent's default first message into each target language, keeping {{variables}} as written. Fails as a whole if any language fails, so callers never get a partial set.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/llm/translate-first-message
openapi: 3.0.0
info:
  title: Zeptar API
  description: >-
    The Zeptar API is organized around REST. All requests and responses are
    JSON. Endpoints are scoped to the authenticated user’s active organization
    unless the path specifies an organization explicitly.
  version: v1
  contact: {}
servers:
  - url: https://api.zeptar.com
    description: Production
  - url: http://localhost:3001
    description: Local development
security: []
tags:
  - name: dashboard
    description: Workspace analytics dashboard
  - name: api-keys
    description: Create, list, update, and revoke API keys
  - name: request-log
    description: Browse, filter, and export the history of authenticated API requests
  - name: voices
    description: Voices available for speech synthesis
  - name: llm
    description: Large language models available for agents
  - name: convai/agents
    description: CRUD on conversational AI agents
  - name: convai/conversations
    description: Start a preview conversation against an agent
  - name: conversations
    description: Browse conversation history, transcripts, tags, and analysis
  - name: organizations
    description: List and look up workspaces (organizations)
  - name: organizations/members
    description: Add and remove members from an org
  - name: me
    description: The current authenticated user
  - name: me/workspace-invitations
    description: Pending workspace invites for the current user
paths:
  /v1/llm/translate-first-message:
    post:
      tags:
        - llm
      summary: Translate a first message
      description: >-
        Translates an agent's default first message into each target language,
        keeping {{variables}} as written. Fails as a whole if any language
        fails, so callers never get a partial set.
      operationId: LlmController_translateFirstMessage
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TranslateFirstMessageDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TranslateFirstMessageResponseDto'
      security:
        - cookie: []
        - apiKey: []
components:
  schemas:
    TranslateFirstMessageDto:
      type: object
      properties:
        text:
          type: string
          description: >-
            The default first message to translate. {{variables}} are kept as
            written.
          example: Hello {{name}}! How can I help you today?
          maxLength: 2000
        source_language:
          type: string
          description: >-
            Language code the text is written in; "multi" detects it from the
            text.
          example: en
        target_languages:
          description: Language codes to translate into.
          example:
            - de
            - fr
          type: array
          items:
            type: string
      required:
        - text
        - source_language
        - target_languages
    TranslateFirstMessageResponseDto:
      type: object
      properties:
        translations:
          type: object
          description: Language code → translated first message, one per target.
          additionalProperties:
            type: string
          example:
            de: Hallo {{name}}! Wie kann ich dir heute helfen?
      required:
        - translations
  securitySchemes:
    cookie:
      type: apiKey
      in: cookie
      name: better-auth.session_token
      description: >-
        Session cookie set by `auth.api.signInEmail` (or the OAuth flow).
        Forwarded automatically by the browser; copy via `document.cookie` for
        server-to-server calls during development.
    apiKey:
      scheme: bearer
      bearerFormat: zsk_…
      type: http
      description: >-
        API key issued via `POST /v1/api-keys`. Prefix is `zsk_`. Pass as
        `Authorization: Bearer zsk_…`. Scopes are enforced per key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.