action callfire_get_call_recording {
  label: "Get call recording by id"
  description: "Returns metadata of recording of a particular call. Metadata contains a link to a MP3 recording"
  provider: callfire
  method: GET
  path: "/calls/recordings/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      fields: {
        type: "string"
      }
      id: {
        type: "integer"
        format: "int64"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Represents a recording of a voice call"
    properties: {
      callId: {
        type: "integer"
        format: "int64"
        description: "An id of a call action"
      }
      campaignId: {
        type: "integer"
        format: "int64"
        description: "Contains broadcast id if call was sent as a part of voice broadcast"
      }
      created: {
        type: "integer"
        format: "int64"
        description: "The time when the given resource was created, formatted in unix time milliseconds (read only). Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT"
      }
      hash: {
        type: "string"
        description: "A unique string hash identifier of a recording"
      }
      id: {
        type: "integer"
        format: "int64"
        description: "An id of a call recording"
      }
      lengthInBytes: {
        type: "integer"
        format: "int64"
        description: "A size of a recording file in bytes"
      }
      lengthInSeconds: {
        type: "integer"
        format: "int32"
        description: "Duration of a recording in seconds"
      }
      mp3Url: {
        type: "string"
        description: "A public URL of a call recording"
      }
      name: {
        type: "string"
        description: "A name of a recording"
      }
      state: {
        type: "string"
        description: "Current state of a recording, available values: RECORDING - recording is in progress, READY - recording is ready, ERROR - error has occurred and recording can be broken"
        enum: ["RECORDING", "READY", "ERROR"]
      }
    }
  }
}