Hubspot Conversations Actor Collection Structure

{
  "type": "object",
  "description": "Paginated collection of actors",
  "name": "ActorCollection",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of actor records",
      "items": {
        "type": "object",
        "description": "Represents a participant in a conversation (visitor, agent, or bot).",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the actor"
          },
          "actorId": {
            "type": "string",
            "description": "Actor ID reference"
          },
          "name": {
            "type": "string",
            "description": "Display name of the actor"
          },
          "email": {
            "type": "email",
            "description": "Email address of the actor"
          },
          "type": {
            "type": "string",
            "description": "Type of actor (e.g., VISITOR, AGENT, BOT)"
          }
        },
        "required": [
          "id"
        ]
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination information for list responses.",
      "properties": {
        "next": {
          "type": "object",
          "description": "Pagination cursor information for retrieving the next page.",
          "properties": {
            "after": {
              "type": "string",
              "description": "Cursor token for the next page"
            },
            "link": {
              "type": "string",
              "description": "API link to the next page"
            }
          }
        }
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "https://json-structure.org/draft/2020-12/schema"
}