End Users_getEndUsers_Response_200

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ada/main/json-schema/ada-end-users-get-end-users-response-200-schema.json",
  "title": "End Users_getEndUsers_Response_200",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ada-end-users-api-openapi.yml#/components/schemas/End_Users_getEndUsers_Response_200",
  "oneOf": [
    {
      "$ref": "#/$defs/EndUser"
    },
    {
      "$ref": "#/$defs/EndUsers"
    }
  ],
  "$defs": {
    "CursorPaginationMetadata": {
      "type": "object",
      "properties": {
        "next_page_url": {
          "type": "string",
          "format": "url",
          "description": "Link to the next page of data using a cursor value"
        }
      },
      "description": "Metadata returned with the results including but not limited to a link to the next page of data",
      "title": "CursorPaginationMetadata"
    },
    "EndUser": {
      "type": "object",
      "properties": {
        "end_user_id": {
          "type": "string",
          "description": "The unique Ada-generated id for the end user"
        },
        "external_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Caller-supplied identifier that links this end user to your own system (for example a CRM contact ID or a phone number). Unique per AI Agent. Null if not set. Maximum 36 characters; values are case-insensitive. Available for custom channel integrations only (V1)."
        },
        "profile": {
          "$ref": "#/$defs/EndUserProfile",
          "description": "The end user's profile information"
        },
        "created_at": {
          "type": "string",
          "description": "The date and time the end user was created"
        },
        "updated_at": {
          "type": "string",
          "description": "The date and time the end user was updated"
        }
      },
      "title": "EndUser"
    },
    "EndUserProfile": {
      "type": "object",
      "properties": {
        "first_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The end user's first name"
        },
        "last_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The end user's last name"
        },
        "display_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The end user's display name"
        },
        "avatar": {
          "type": [
            "string",
            "null"
          ],
          "description": "URL to the end user's avatar image"
        },
        "email": {
          "type": [
            "string",
            "null"
          ],
          "description": "The end user's email address"
        },
        "language": {
          "type": [
            "string",
            "null"
          ],
          "description": "The end user's language in BCP 47 format"
        },
        "metadata": {
          "type": "object",
          "additionalProperties": {
            "description": "Any type"
          },
          "description": "A dictionary of arbitrary key, value pairs assigned to the end user                      - `metadata` keys may only be of type: `string`                      - `metadata` values may only be one of type: `string`, `boolean`, or `integer`"
        },
        "system_properties": {
          "$ref": "#/$defs/EndUserProfileSystemProperties",
          "description": "Read-only profile information set by Ada"
        }
      },
      "description": "The end user's profile information",
      "title": "EndUserProfile"
    },
    "EndUserProfileSystemProperties": {
      "type": "object",
      "properties": {
        "sunshine_user_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The Sunshine Conversations user id for the end user"
        }
      },
      "description": "Read-only profile information set by Ada",
      "title": "EndUserProfileSystemProperties"
    },
    "EndUsers": {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/EndUser"
          },
          "description": "The list of end user profiles"
        },
        "meta": {
          "$ref": "#/$defs/CursorPaginationMetadata"
        }
      },
      "title": "EndUsers"
    }
  }
}