RErecall
bot

Pin Participant

Changed on

Pin or unpin a participant's video. Note: This is only applicable for 'video_separate_h264' streams

The base rate limit for this endpoint is:

  • 300 requests per min per workspace
post/api/v1/bot/{id}/pin_participant/

Request

  • Base URL
    https://us-east-1.recall.ai
  • URL
    https://us-east-1.recall.ai/api/v1/bot/{id}/pin_participant/
  • Auth
    API key in header Authorization

Path parameters

idstring uuid required

A UUID string identifying this bot.

Request body

idinteger

The ID of the participant to pin. If not specified, the bot will unpin any currently pinned participant.

Response

idstring uuid required
bot_namestring

The name of the bot that will be displayed in the call. (Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)

join_atstring date-time nullable

The time at which the bot will join the call, formatted in ISO 8601. This field can only be read from scheduled bots that have not yet joined a call.

metadataobject

Changes

  • b72a4beeaeb3Revision changes
    • info

      added the optional property /////////////// to the response with the status

    • info

      added the optional property ///////////////// to the response with the status

  • 04ea13759f97Revision changes
    • info

      added the required property ///////////////// to the response with the status