List call recordings

v1.0.0

List all call recordings for a meeting.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: meeting:read, call_recording:read.

Input

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "A cursor for pagination. Use the `next_cursor` from the previous response to get the next page of results."
    },
    "limit": {
      "type": "integer",
      "description": "The maximum number of results to return. Defaults to 50 with a maximum of 200."
    },
    "meeting_id": {
      "type": "string",
      "format": "uuid",
      "description": "The ID of the meeting to list call recordings for."
    }
  },
  "required": [
    "meeting_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Success",
  "required": [
    "data",
    "pagination"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "status",
          "web_url",
          "created_by_actor",
          "created_at"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "description": "The timestamp of when the call recording was created."
          },
          "created_by_actor": {
            "type": "object",
            "description": "The actor that created this call recording.",
            "properties": {
              "id": {
                "type": "string",
                "description": "An ID to identify the actor."
              },
              "type": {
                "type": "string",
                "description": "The type of actor. [Read more information on actor types here](/docs/actors).",
                "enum": [
                  "api-token",
                  "workspace-member",
                  "system",
                  "app"
                ]
              }
            }
          },
          "id": {
            "type": "object",
            "required": [
              "workspace_id",
              "meeting_id",
              "call_recording_id"
            ],
            "properties": {
              "call_recording_id": {
                "type": "string",
                "format": "uuid",
                "description": "The call recording ID of the call recording."
              },
              "meeting_id": {
                "type": "string",
                "format": "uuid",
                "description": "The ID of the meeting associated with this call recording."
              },
              "workspace_id": {
                "type": "string",
                "format": "uuid",
                "description": "The ID of the workspace this call recording belongs to."
              }
            }
          },
          "status": {
            "type": "string",
            "description": "The status of the call recording. When a call recording is first created, it will have a status of `PROCESSING`. Once the recording is ready, it will transition to `COMPLETED`. If the recording fails for any reason, the status will be `FAILED`.",
            "enum": [
              "processing",
              "completed",
              "failed"
            ]
          },
          "web_url": {
            "type": "string",
            "format": "uri",
            "description": "A URL that links directly to the call recording in the Attio web application."
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "next_cursor"
      ],
      "properties": {
        "next_cursor": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}