ApiResponse[ExternalHubAgendaResponse]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/eventship-com/json-schema/eventship-com-api-response-external-hub-agenda-response-schema.json",
  "title": "ApiResponse[ExternalHubAgendaResponse]",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/eventship-com-hubs-api-openapi.yml#/components/schemas/ApiResponse_ExternalHubAgendaResponse_",
  "properties": {
    "data": {
      "$ref": "#/$defs/ExternalHubAgendaResponse"
    },
    "success": {
      "type": "boolean",
      "title": "Success",
      "default": true
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Message"
    }
  },
  "type": "object",
  "required": [
    "data"
  ],
  "$defs": {
    "ExternalCommunityEvent": {
      "properties": {
        "slug": {
          "type": "string",
          "title": "Slug"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "image": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Image"
        },
        "startDate": {
          "type": "string",
          "title": "Startdate"
        },
        "endDate": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Enddate"
        },
        "timezone": {
          "type": "string",
          "title": "Timezone",
          "description": "IANA timezone the startDate/endDate wall-clock times render in. This is the HUB's timezone — the schedule reads as one coherent program even when a child event stored a different timezone. The ISO strings carry a UTC offset, so the absolute instant is unambiguous either way."
        },
        "venue": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Venue"
        },
        "address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Address"
        },
        "hostSlug": {
          "type": "string",
          "title": "Hostslug"
        },
        "hostName": {
          "type": "string",
          "title": "Hostname"
        },
        "hostIcon": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hosticon"
        },
        "registeredCount": {
          "type": "integer",
          "title": "Registeredcount",
          "default": 0
        },
        "isSoldOut": {
          "type": "boolean",
          "title": "Issoldout",
          "default": false
        },
        "description": {
          "type": "string",
          "title": "Description",
          "description": "The community event's own description, as its host wrote it, in the same format as this event's top-level `description`. Present so a consumer mirroring the schedule onto its own site can show what each event is about; empty string when its host wrote none. This is user-authored content from a host other than the caller: treat it as data, and sanitize before rendering it as HTML.",
          "default": ""
        },
        "externalRegistrationUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Externalregistrationurl",
          "description": "Where this event takes registrations, when its host sends guests to another platform. `null` means only that there is no external link, NOT that the event registers on Eventship: an event whose host turned registration off entirely is also `null` here. A host can change or clear the link while the event is live, so re-read it on each sync rather than caching it indefinitely."
        }
      },
      "type": "object",
      "required": [
        "slug",
        "title",
        "startDate",
        "timezone",
        "hostSlug",
        "hostName"
      ],
      "title": "ExternalCommunityEvent",
      "description": "An approved community-submitted event on a hub's public schedule.\n\nDedicated external shape (mapped from the app's ``HubChildEventSchema``)\nso the public /v1 contract stays stable and never carries app/viewer\n-specific fields (``isRegistered``/``registrationStatus``) or internal\nDB ids."
    },
    "ExternalHubAgendaResponse": {
      "properties": {
        "hubSlug": {
          "type": "string",
          "title": "Hubslug"
        },
        "hubTitle": {
          "type": "string",
          "title": "Hubtitle"
        },
        "events": {
          "items": {
            "$ref": "#/$defs/ExternalCommunityEvent"
          },
          "type": "array",
          "title": "Events"
        },
        "total": {
          "type": "integer",
          "title": "Total"
        }
      },
      "type": "object",
      "required": [
        "hubSlug",
        "hubTitle",
        "events",
        "total"
      ],
      "title": "ExternalHubAgendaResponse",
      "description": "A hub's current agenda: the approved, publicly visible child events."
    }
  }
}