Get Call Screen Recording
Redirect to the screen the person shared: one 1 fps H.264 file.
Only agents with vision_input.screenshare.record produce one. It covers the
whole call rather than only the shared stretches — the parts where nobody was
sharing are black — so its timeline lines up with the audio and the
transcript second for second, and a turn’s offset into it is the same
arithmetic as into the recording.
Like the audio, the redirect goes to object storage, expires within the hour
and supports Range. A 404 says why there is nothing to play, and
screen_recording.state on the call answers the same question without a
round trip — including not_shared, which means screen recording was on and
nobody ever shared, as opposed to none, which means it was off.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
serve as a file named call-{id}-screen.mp4 rather than inline
Response
The video, once the redirect above has been followed
The response is of type file.