---
title: "Get an agentic video"
method: GET
path: "/agentic-videos/{id}"
tags: ["Agentic Videos"]
---

# Get an agentic video

`GET /agentic-videos/{id}`

Retrieve a single agentic video and the agent generated from it (when one exists).

## Path parameters

- `id` string, required

## Response `200`

Agentic video retrieved

- GetAgenticVideoResponseDto — Response returned by `GET /agentic-videos/{video_id}`.
  - `video` AgenticVideo, required
    - `video_id` string, required — Unique identifier of the agentic video.
    - `name` string, required — Display name of the agentic video.
    - `video_url` string — CDN URL of the processed video, available once processing reaches `ready`.
    - `thumbnail_url` string — CDN URL of the video thumbnail, available once one has been generated.
    - `duration` number, double — Duration of the source video, in seconds.
    - `language` string — Detected spoken language of the video, as an IETF BCP-47 language tag.
    - `status` 'created' | 'started' | 'ready' | 'done' | 'error', required — Processing status of an agentic video. - `created` — the video was accepted and is queued for processing. - `started` — the video is being processed. - `ready` — the agent has been created and is initializing. - `done` — the agent is active and the agentic video is fully available to viewers. - `error` — processing failed; see the `error` field for details.
    - `error` AgenticVideoError
      - `code` 'youtube_not_supported' | 'ingest_failed' | 'moderation_failed' | 'transcription_failed' | 'agent_creation_failed', required
      - `message` string
    - `agent_id` string — ID of the agent generated from this video, present once the agent has been created.
    - `show_agent_on_video_end` boolean, required — Whether the agent automatically appears when the video finishes playing.
    - `greetings` AgenticVideoGreetings — Greetings spoken by the agent at specific moments in the agentic-video flow.
      - `on_click` string — Greeting when the viewer first clicks ASK.
      - `on_video_end` string — Greeting when the video ends and the agent auto-appears.
    - `background` PresenterBackground
      - `color` string — Background color of the Avatar.
      - `source_url` string — Image URL used as the Avatar background.
    - `bubble_text` string — Text shown in the call-to-action bubble that invites viewers to start chatting.
    - `created_by` string, required — ID of the user who created the agentic video.
    - `created_at` string, required — Creation timestamp (ISO-8601).
    - `modified_at` string, required — Timestamp of the last update (ISO-8601).
  - `agent` Agent, required
    - `id` string, required — Id of agent
    - `preview_description` string — Description of the agent
    - `presenter` union
      - TalkAgentPresenter
        - `type` 'talk', required — Presenter type
        - `voice` union
          - object
            - `type` 'microsoft', required
            - `voice_id` string, required — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigMicrosoft
              - …
            - `language` string — Voice customization options. To save the language of the selected agent voice
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
          - object
            - `type` 'elevenlabs', required
            - `voice_id` string — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigElevenlabs
              - …
            - `model_id` string — The model id from the list of available models. https://elevenlabs.io/docs/speech-synthesis/models.
            - `language` string — Voice customization options. To save the language of the selected voice
            - `access` 'public' | 'premium' | 'private' | 'external-private'
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
          - object
            - `voice_id` string, required — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigMicrosoft
              - …
            - `language` string — Voice customization options. To save the language of the selected agent voice
            - `type` 'azure-openai', required
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
        - `source_url` string, required — Image URL used to create the avatar.
        - `thumbnail` string, required — Preview image URL for the avatar.
        - `stitch` boolean — Controls the output framing.<br/> `true` - Original image framing `false` - Close-up framing
      - ClipAgentPresenter
        - `type` 'clip', required — Presenter type
        - `voice` union
          - object
            - `type` 'microsoft', required
            - `voice_id` string, required — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigMicrosoft
              - …
            - `language` string — Voice customization options. To save the language of the selected agent voice
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
          - object
            - `type` 'elevenlabs', required
            - `voice_id` string — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigElevenlabs
              - …
            - `model_id` string — The model id from the list of available models. https://elevenlabs.io/docs/speech-synthesis/models.
            - `language` string — Voice customization options. To save the language of the selected voice
            - `access` 'public' | 'premium' | 'private' | 'external-private'
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
          - object
            - `voice_id` string, required — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigMicrosoft
              - …
            - `language` string — Voice customization options. To save the language of the selected agent voice
            - `type` 'azure-openai', required
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
        - `presenter_id` string, required — ID of the video avatar used by the Agent. <br> Retrieved from the GET/ presenters endpoint.
        - `background` PresenterBackground
          - `color` string — Background color of the Avatar.
          - `source_url` string — Image URL used as the Avatar background.
      - ExpressiveAgentPresenter
        - `type` 'expressive', required — Presenter type
        - `voice` union
          - object
            - `type` 'microsoft', required
            - `voice_id` string, required — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigMicrosoft
              - …
            - `language` string — Voice customization options. To save the language of the selected agent voice
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
          - object
            - `type` 'elevenlabs', required
            - `voice_id` string — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigElevenlabs
              - …
            - `model_id` string — The model id from the list of available models. https://elevenlabs.io/docs/speech-synthesis/models.
            - `language` string — Voice customization options. To save the language of the selected voice
            - `access` 'public' | 'premium' | 'private' | 'external-private'
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
          - object
            - `voice_id` string, required — Voice ID selected from the list of available voices.</br>Retrieve available options from the GET /voices endpoint.
            - `voice_config` VoiceConfigMicrosoft
              - …
            - `language` string — Voice customization options. To save the language of the selected agent voice
            - `type` 'azure-openai', required
            - `ssml` boolean — When true, the agent's text is sent to the TTS provider as SSML without escaping (caller-authored SSML); otherwise special characters are escaped. Only supported for Microsoft voices.
        - `presenter_id` string, required — Id of avatar that will be shown for user
        - `background` PresenterBackground
          - `color` string — Background color of the Avatar.
          - `source_url` string — Image URL used as the Avatar background.
        - `view_mode` 'standard' | 'zoom-in'
    - `llm` union
      - OpenAILLM
        - `provider` 'openai' — Large Language Model provider.
        - `instructions` string — Defines what the Agent does and how it should behave.
        - `template` 'rag-grounded' | 'rag-ungrounded' | 'assistant'
        - `prompt_customization` PromptCustomization
          - `role` string — Role the Agent assumes when responding.
          - `personality` string — Personality traits reflected in the Agent’s responses.
          - `topics_to_avoid` string[] — List of topics the Agent should avoid discussing.
          - `max_response_length` number, double — Approximate maximum response length, in words. Default: 75
          - `knowledge_source` 'base_knowledge' | 'documents' — Defines how the Agent receives knowledge.</br> - base_knowledge — Uses inline knowledge from prompt_knowledge - documents — Uses knowledge_id (RAG) (Default: documents)
          - `prompt_knowledge` string — Defines the factual knowledge the Agent uses to answer questions.
        - `temperature` number, double — Controls how predictable or creative the Agent’s responses are. Default values by template: RAG-Grounded: 0.1 RAG-Ungrounded: 0.5 Assistant: 0.5
        - `model` 'gpt-4o-global' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5.4-mini' | 'gpt-5.4-nano' — OpenAI LLM models
      - GoogleLLM
        - `provider` 'google' — Large Language Model provider.
        - `instructions` string — Defines what the Agent does and how it should behave.
        - `template` 'rag-grounded' | 'rag-ungrounded' | 'assistant'
        - `prompt_customization` PromptCustomization
          - `role` string — Role the Agent assumes when responding.
          - `personality` string — Personality traits reflected in the Agent’s responses.
          - `topics_to_avoid` string[] — List of topics the Agent should avoid discussing.
          - `max_response_length` number, double — Approximate maximum response length, in words. Default: 75
          - `knowledge_source` 'base_knowledge' | 'documents' — Defines how the Agent receives knowledge.</br> - base_knowledge — Uses inline knowledge from prompt_knowledge - documents — Uses knowledge_id (RAG) (Default: documents)
          - `prompt_knowledge` string — Defines the factual knowledge the Agent uses to answer questions.
        - `temperature` number, double — Controls how predictable or creative the Agent’s responses are. Default values by template: RAG-Grounded: 0.1 RAG-Ungrounded: 0.5 Assistant: 0.5
        - `model` 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3-flash' — Google LLM models
      - OpenAIExternalLLM — OpenAI External LLM
        - `instructions` string — Defines what the Agent does and how it should behave.
        - `template` 'rag-grounded' | 'rag-ungrounded' | 'assistant'
        - `prompt_customization` PromptCustomization
          - `role` string — Role the Agent assumes when responding.
          - `personality` string — Personality traits reflected in the Agent’s responses.
          - `topics_to_avoid` string[] — List of topics the Agent should avoid discussing.
          - `max_response_length` number, double — Approximate maximum response length, in words. Default: 75
          - `knowledge_source` 'base_knowledge' | 'documents' — Defines how the Agent receives knowledge.</br> - base_knowledge — Uses inline knowledge from prompt_knowledge - documents — Uses knowledge_id (RAG) (Default: documents)
          - `prompt_knowledge` string — Defines the factual knowledge the Agent uses to answer questions.
        - `temperature` number, double — Controls how predictable or creative the Agent’s responses are. Default values by template: RAG-Grounded: 0.1 RAG-Ungrounded: 0.5 Assistant: 0.5
        - `secretId` string — ID of the stored secret containing the external OpenAI API key
      - AzureOpenAIExternalLLM — Azure OpenAI External LLM
        - `instructions` string — Defines what the Agent does and how it should behave.
        - `template` 'rag-grounded' | 'rag-ungrounded' | 'assistant'
        - `prompt_customization` PromptCustomization
          - `role` string — Role the Agent assumes when responding.
          - `personality` string — Personality traits reflected in the Agent’s responses.
          - `topics_to_avoid` string[] — List of topics the Agent should avoid discussing.
          - `max_response_length` number, double — Approximate maximum response length, in words. Default: 75
          - `knowledge_source` 'base_knowledge' | 'documents' — Defines how the Agent receives knowledge.</br> - base_knowledge — Uses inline knowledge from prompt_knowledge - documents — Uses knowledge_id (RAG) (Default: documents)
          - `prompt_knowledge` string — Defines the factual knowledge the Agent uses to answer questions.
        - `temperature` number, double — Controls how predictable or creative the Agent’s responses are. Default values by template: RAG-Grounded: 0.1 RAG-Ungrounded: 0.5 Assistant: 0.5
        - `secretId` string — ID of the stored secret containing the external OpenAI API key
      - DIdLLM
        - `provider` 'd-id' — Large Language Model provider.
        - `instructions` string — Defines what the Agent does and how it should behave.
        - `template` 'rag-grounded' | 'rag-ungrounded' | 'assistant'
        - `prompt_customization` PromptCustomization
          - `role` string — Role the Agent assumes when responding.
          - `personality` string — Personality traits reflected in the Agent’s responses.
          - `topics_to_avoid` string[] — List of topics the Agent should avoid discussing.
          - `max_response_length` number, double — Approximate maximum response length, in words. Default: 75
          - `knowledge_source` 'base_knowledge' | 'documents' — Defines how the Agent receives knowledge.</br> - base_knowledge — Uses inline knowledge from prompt_knowledge - documents — Uses knowledge_id (RAG) (Default: documents)
          - `prompt_knowledge` string — Defines the factual knowledge the Agent uses to answer questions.
        - `temperature` number, double — Controls how predictable or creative the Agent’s responses are. Default values by template: RAG-Grounded: 0.1 RAG-Ungrounded: 0.5 Assistant: 0.5
        - `model` 'gpt-oss-120b' — D-ID LLM models
      - AutoLLM — Auto LLM — backend resolves the default provider and model.
        - `provider` 'auto', required — Large Language Model provider.
        - `instructions` string — Defines what the Agent does and how it should behave.
        - `template` 'rag-grounded' | 'rag-ungrounded' | 'assistant'
        - `prompt_customization` PromptCustomization
          - `role` string — Role the Agent assumes when responding.
          - `personality` string — Personality traits reflected in the Agent’s responses.
          - `topics_to_avoid` string[] — List of topics the Agent should avoid discussing.
          - `max_response_length` number, double — Approximate maximum response length, in words. Default: 75
          - `knowledge_source` 'base_knowledge' | 'documents' — Defines how the Agent receives knowledge.</br> - base_knowledge — Uses inline knowledge from prompt_knowledge - documents — Uses knowledge_id (RAG) (Default: documents)
          - `prompt_knowledge` string — Defines the factual knowledge the Agent uses to answer questions.
        - `temperature` number, double — Controls how predictable or creative the Agent’s responses are. Default values by template: RAG-Grounded: 0.1 RAG-Ungrounded: 0.5 Assistant: 0.5
    - `provider` 'd-id-agents' — The provider of the agent
    - `knowledge` Knowledge
      - `id` string, required
      - `provider` 'pinecone'
      - `starter_message` string[] — List of messages to be showen as chat starter questions for the user to ask
      - `base_knowledge` string — Prompt based textual knowledge
    - `starter_message` string[] — List of messages to be showen as chat starter questions for the user to ask
    - `greetings` string[] — Greeting messages for the agent One greeting is randomly displayed at the start of the chat
    - `error` object — Error object in case of errors
      - `details` string
      - `description` string, required
      - `kind` string, required
    - `user_data` string
    - `embed` boolean — Wether to embed the agent
    - `triggers` AgentTriggersConfig — Agent triggers configuration with event-specific settings
      - `chat/end` EventTriggerConfig — Configuration for a specific trigger event
        - `webhooks` WebhookConfig[] — Webhooks to execute immediately when event fires
          - `url` string, required — a valid url that starts with http or https with regex
          - `headers` object — Additional headers to include
          - `auth` Auth, nullable — Authentication configuration for tools and webhooks (processed/stored)
            - `secret_id` string, required
        - `tools` ToolItem[] — Tools to make available to the LLM for this event
          - `tool_id` string, required — Tool id reference.
          - `static_values` RecordStringJSONValue — Construct a type with a set of properties K of type T
        - `prompt_instructions` string — Event-specific prompt instructions for the LLM
        - `tool_choice` 'auto' | 'required' — Tool choice strategy for LLM function calling
    - `client_key` string — Auto-generated scoped client key for the agent
    - `pronunciation_dictionary` PronunciationDictionaryConfig — Pronunciation dictionary configuration applied to the agent's speech.
      - `id` string, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/d-id/apis/realtime-endpoints.md) · [All operations](https://skmtc.net/d-id/apis/realtime-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-id/realtime-endpoints/versions/2f2425e1b6b6/schema)