URL Expired

The URL for this request expired after 30 days.

video_id

string

required

The video ID to retrieve

``200 OK.

object

callbackId

string

Use callback ID to link videos back to the initial request. For example, if you are making a personalized video for a customer, you could enter the customer's email as a callback ID. This way, you can tell who the video is for, once its generated..

createdAt

integer

UNIX timestamp representing the time video was created.

ctaSettings

object

Settings for a call-to-action button.

label

string

required

Label for a call-to-action button.

url

string

required

^(?:(?:(?:https?|ftp):)?//)?(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+(?:[a-z\u00a1-\uffff]{2,}\.?))(?::\d{2,5})?(?:[/?#]\S*)?$

URL to navigate to, when the call-to-action button is clicked.

description

string

Description of the video to be shown on the share page.

test

boolean

Defaults to false

Test videos are free and not counted towards your quota. If you create a video in the “test” mode, we will overlay a watermark over your video.

download

string

duration

string

id

uuid

lastUpdatedAt

integer

status

string

enum

complete``deleted``error``in_progress``rejected``approved

thumbnail

object | null

image

string | null

Defaults to null

gif

string | null

Defaults to null

title

string

Title of the video to be shown on the share page.

visibility

string

enum

Defaults to private

Public videos will be visible to anyone with a share URL.

Private videos can only be downloaded via a time-limited download link. See Retrieve a video for details.

Visibility can be changed also once the video is created via Update a video.

private``public

``400 Bad Request.

``403 Forbidden - Wrong API key.

``404 Video ID was not found.

``default Unexpected Server error.

Updated2 months ago

ShellNodeRubyPHPPython

xxxxxxxxxx

curl --request GET \

--url https://api.synthesia.io/v2/videos/video_id \

--header 'accept: application/json'

xxxxxxxxxx

{

"callbackId": "string",

"createdAt": 0,

"ctaSettings": {

"label": [\
\
      "Learn More",\
\
      "Sign up"\
\
    ],

"url": [\
\
      "https://example.com",\
\
      "https://signup.example.com"\
\
    ]

},

"description": "",

"test": false,

"download": "string",

"duration": "string",

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"lastUpdatedAt": 0,

"status": "complete",

"thumbnail": {

"image": "string",

"gif": "string"

},

"title": "",

"visibility": "private"

}

Updated2 months ago