action twilio_fetch_participant {
  label: "FetchParticipant"
  description: "Fetch an instance of a participant"
  provider: twilio
  method: GET
  path: "/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}.json"
  encoding: json
  input: {
    type: "object"
    properties: {
      AccountSid: {
        type: "string"
      }
      CallSid: {
        type: "string"
      }
      ConferenceSid: {
        type: "string"
      }
    }
    required: ["AccountSid", "CallSid", "ConferenceSid"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      account_sid: {
        type: "string"
        description: "The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Participant resource."
      }
      call_sid: {
        type: "string"
        description: "The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Participant resource is associated with."
      }
      call_sid_to_coach: {
        type: "string"
        description: "The SID of the participant who is being `coached`. The participant being coached is the only participant who can hear the participant who is `coaching`."
      }
      coaching: {
        type: "boolean"
        description: "Whether the participant is coaching another call. Can be: `true` or `false`. If not present, defaults to `false` unless `call_sid_to_coach` is defined. If `true`, `call_sid_to_coach` must be defined."
      }
      conference_sid: {
        type: "string"
        description: "The SID of the conference the participant is in."
      }
      date_created: {
        type: "string"
        format: "date-time-rfc-2822"
        description: "The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."
      }
      date_updated: {
        type: "string"
        format: "date-time-rfc-2822"
        description: "The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."
      }
      end_conference_on_exit: {
        type: "boolean"
        description: "Whether the conference ends when the participant leaves. Can be: `true` or `false` and the default is `false`. If `true`, the conference ends and all other participants drop out when the participant leaves."
      }
      hold: {
        type: "boolean"
        description: "Whether the participant is on hold. Can be `true` or `false`."
      }
      label: {
        type: "string"
        description: "The user-specified label of this participant, if one was given when the participant was created. This may be used to fetch, update or delete the participant."
      }
      muted: {
        type: "boolean"
        description: "Whether the participant is muted. Can be `true` or `false`."
      }
      start_conference_on_enter: {
        type: "boolean"
        description: "Whether the conference starts when the participant joins the conference, if it has not already started. Can be: `true` or `false` and the default is `true`. If `false` and the conference has not started, the participant is muted and hears background music until another participant starts the conference."
      }
      status: {
        type: "string"
        enum: ["queued", "connecting", "ringing", "connected", "complete", "failed"]
      }
      uri: {
        type: "string"
        description: "The URI of the resource, relative to `https://api.twilio.com`."
      }
    }
  }
}