RecordingObject

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/webex/json-schema/webex-recording-object-schema.json",
  "title": "RecordingObject",
  "description": "Recording details",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/webex-converged-recordings-api-openapi.yml#/components/schemas/RecordingObject",
  "type": "object",
  "required": [
    "id",
    "topic",
    "createTime",
    "timeRecorded",
    "format",
    "serviceType",
    "durationSeconds",
    "sizeBytes",
    "status",
    "ownerId",
    "ownerEmail",
    "ownerType",
    "storageRegion"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "A unique identifier for the recording."
    },
    "topic": {
      "type": "string",
      "description": "The recording's topic."
    },
    "createTime": {
      "type": "string",
      "description": "The date and time recording was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) compliant format. Please note that it's not the time the record button was clicked in meeting but the time the recording file was generated offline."
    },
    "timeRecorded": {
      "type": "string",
      "description": "The date and time recording started in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) compliant format. It indicates when the record button was clicked in the meeting."
    },
    "format": {
      "type": "string",
      "enum": [
        "MP3"
      ],
      "description": " * `MP3` - Recording file format is MP3.\n"
    },
    "serviceType": {
      "type": "string",
      "enum": [
        "calling",
        "customerAssist"
      ],
      "description": " * `calling` - Recording service type is Webex Call.\n * `customerAssist` - Call Recordings of a Customer Assist Queue.\n"
    },
    "durationSeconds": {
      "type": "number",
      "description": "The duration of the recording, in seconds."
    },
    "sizeBytes": {
      "type": "number",
      "description": "The size of the recording file, in bytes."
    },
    "status": {
      "type": "string",
      "enum": [
        "available",
        "deleted"
      ],
      "description": " * `available` - Recording is available.\n * `deleted` - Recording has been moved into recycle bin.\n"
    },
    "ownerId": {
      "type": "string",
      "description": "Webex UUID for recording owner/host."
    },
    "ownerEmail": {
      "type": "string",
      "description": "Webex email for recording owner/host."
    },
    "ownerType": {
      "type": "string",
      "enum": [
        "user",
        "place",
        "virtualLine",
        "callQueue"
      ],
      "description": " * `user` - Recording belongs to a user.\n * `place` - Recording belongs to a workspace device.\n * `virtualLine` - Recording belongs to a workspace device.\n"
    },
    "storageRegion": {
      "type": "string",
      "description": "Storage location for recording within Webex datacenters."
    },
    "serviceData": {
      "type": "object",
      "properties": {
        "locationId": {
          "type": "string",
          "description": "Webex calling location for recording user."
        },
        "callSessionId": {
          "type": "string",
          "description": "Call ID for which recording was done."
        }
      },
      "description": "Fields relevant to each service Type."
    }
  }
}