# Validate Bot Configuration

Validate a meeting bot configuration without actually creating or starting the bot.
This endpoint accepts the same parameters as the Create Bot endpoint and performs
all validation checks including meeting URL format, authenticated account validity,
and configuration parameters.

Use this endpoint to verify your bot configuration before deploying, or to validate
user input in your application before scheduling a bot.

Endpoint: POST /bot/validate
Version: v1
Security: bearerAuth

## Request fields (application/json):

  - `transcription_model` (string, required)
    The transcription model to use for transcribing the audio.
Refer to [your billing page](https://platform.skribby.io?to=billing) for cost and availability per model.
    Enum: "none", "whisper", "assembly-ai-realtime", "deepgram", "deepgram-v3", "assembly-ai", "speechmatics", "rev-ai", "elevenlabs", "deepgram-realtime", "deepgram-realtime-v3", "speechmatics-realtime", "soniox", "soniox-realtime", "gladia", "gladia-realtime", "salad"

  - `transcription_credentials` (string)
    Optional credential identifier issued by the Skribby platform when bringing your own API key for the selected transcription model.

  - `service` (string, required)
    The service the bot needs to join:
- gmeet - Google Meet
- teams - Microsoft Teams
- zoom - Zoom
    Enum: "gmeet", "teams", "zoom"

  - `meeting_url` (string, required)
    The URL to the meeting itself which the bot will use to join

  - `bot_name` (string, required)
    The name of the bot that'll join the meeting

  - `bot_avatar_file` (string)
    Binary image file for bot avatar. 
Ideally should be in 16:9 aspect ratio.

  - `bot_avatar_url` (string)
    URL to an image that will be used as the bot's avatar.
This will be ignored if bot_avatar_file is provided.

  - `lang` (string)
    Language of the meeting. Optional but can improve transcription accuracy.
When using deepgram-realtime, this parameter is highly recommended.

Refer to the [Bot Language](/concepts/bot-language) page for more information.

  - `video` (boolean)
    Whether video should also be recorded during the meeting.  
Refer to [your billing page](https://platform.skribby.io?to=billing) for cost implications and availability.

  - `webhook_url` (string)
    URL to receive live updates on bot status changes, participant changes, etc.
Refer to the [Webhooks](#webhooks) section for details on webhook format and available events.

  - `store_recording_for_1_year` (boolean)
    Audio recordings are stored for 1 week by default. This addon extends storage to 1 year.  
Refer to [your billing page](https://platform.skribby.io?to=billing) for cost implications and availability.

  - `scheduled_start_time` (integer)
    Unix timestamp for when the bot should join the meeting. If not provided,
the bot will attempt to join immediately.

  - `profanity_filter` (boolean)
    Whether the transcription should censor profanity.
Only available on select models. Refer to [your billing page](https://platform.skribby.io?to=billing) for availability per model.

  - `initial_chat_message` (string)
    Whenever the bot joins the meeting, it'll send this message to the chat.

  - `stop_options` (object)
    Define if and when the bot should stop on certain conditions.

  - `stop_options.time_limit` (integer)
    Maximum time in minutes that the bot may be active. Hard limit is 4 hours (240 minutes).

  - `stop_options.waiting_room_timeout` (integer)
    Minutes the bot will wait in the meeting waiting room before stopping if it is not admitted.
> ⚠️ Charge Warning: Going beyond 10 minutes incurs charges for not admitted bots. Additional fees equal your base price * (waiting_room_timeout - 10). Refer to [your billing page](https://platform.skribby.io?to=billing) for current base pricing.

  - `stop_options.last_person_detection` (integer)
    Minimum time in minutes the bot will spent alone in the meeting (once everyone left) before the bot will stop. Setting this to 0 disables this functionality.

  - `stop_options.silence_detection` (integer)
    Minimum time in minutes the bot will wait for any sounds before the bot will stop. This is useful for when there are other bots in the call and therefor the last_person_detection fails. Setting this to 0 disables this functionality.

  - `authentication` (object)
    Authentication credentials for joining private meetings.  
Refer to the [Bot Authentication](/concepts/bot-authentication) page for more information.

  - `authentication.account_id` (string)
    ID of the authenticated account created [via the dashboard](https://platform.skribby.io?to=authenticated-accounts).
Used for Google Meet and Microsoft Teams authentication.

  - `authentication.zoom_zak_token` (string)
    ZAK Token for Zoom authentication.

  - `authentication.always_authenticate` (boolean)
    By default, bots try to join as guests first. Set to true to force authentication.

  - `custom_vocabulary` (array)
    Provide certain words or phrases to improve transcription. Only supported on certain models, refer to [your billing page](https://platform.skribby.io?to=billing) to view availability per model.

  - `realtime_audio` (boolean)
    Enable realtime audio streaming addon via a separate WebSocket connection.
Refer to [your billing page](https://platform.skribby.io?to=billing) for cost implications and availability.

  - `time_limit` (integer)
    Use time_limit on stop_options.

## Response 200 fields (application/json):

  - `message` (string)

## Response 400 fields (application/json):

  - `message` (string)
    Error message

  - `errors` (object)
    Error code

  - `errors.transcription_model` (array)
    List of errors per parameter

## Response 401 fields (application/json):

  - `message` (string)
    Error message