action twilio_fetch_call_recording {
  label: "FetchCallRecording"
  description: "Fetch an instance of a recording for a call"
  provider: twilio
  method: GET
  path: "/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json"
  encoding: json
  input: {
    type: "object"
    properties: {
      AccountSid: {
        type: "string"
      }
      CallSid: {
        type: "string"
      }
      Sid: {
        type: "string"
      }
    }
    required: ["AccountSid", "CallSid", "Sid"]
    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 Recording resource."
      }
      api_version: {
        type: "string"
        description: "The API version used to make the recording."
      }
      call_sid: {
        type: "string"
        description: "The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording resource is associated with."
      }
      channels: {
        type: "integer"
        description: "The number of channels in the final recording file.  Can be: `1`, or `2`. Separating a two leg call into two separate channels of the recording file is supported in [Dial](https://www.twilio.com/docs/voice/twiml/dial#attributes-record) and [Outbound Rest API](https://www.twilio.com/docs/voice/make-calls) record options."
      }
      conference_sid: {
        type: "string"
        description: "The Conference SID that identifies the conference associated with the recording, if a conference recording."
      }
      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."
      }
      duration: {
        type: "string"
        description: "The length of the recording in seconds."
      }
      encryption_details: {
        description: "How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature."
        type: "object"
      }
      error_code: {
        type: "integer"
        description: "The error code that describes why the recording is `absent`. The error code is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). This value is null if the recording `status` is not `absent`."
      }
      price: {
        type: "number"
        description: "The one-time cost of creating the recording in the `price_unit` currency."
      }
      price_unit: {
        type: "string"
        format: "currency"
        description: "The currency used in the `price` property. Example: `USD`."
      }
      sid: {
        type: "string"
        description: "The unique string that that we created to identify the Recording resource."
      }
      source: {
        type: "string"
        enum: ["DialVerb", "Conference", "OutboundAPI", "Trunking", "RecordVerb", "StartCallRecordingAPI", "StartConferenceRecordingAPI"]
      }
      start_time: {
        type: "string"
        format: "date-time-rfc-2822"
        description: "The start time of the recording in GMT and in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format."
      }
      status: {
        type: "string"
        enum: ["in-progress", "paused", "stopped", "processing", "completed", "absent"]
      }
      track: {
        type: "string"
        description: "The recorded track. Can be: `inbound`, `outbound`, or `both`."
      }
      uri: {
        type: "string"
        description: "The URI of the resource, relative to `https://api.twilio.com`."
      }
    }
  }
}