> ## Documentation Index > Fetch the complete documentation index at: https://docs.member.dev/llms.txt > Use this file to discover all available pages before exploring further. # Admin Cancel Event > Cancel a hub event as the team principal. Idempotent -- re-cancelling an already-cancelled event is a no-op. Emits hub_event.cancelled. This endpoint takes no request body: unlike the member-facing cancel endpoint it never carries an organiser note to attendees. ## OpenAPI ````yaml /openapi/mio-openapi.json post /api/v1/admin/teams/{team_id}/hubs/{hub_id}/events/{event_id}/cancel openapi: 3.1.0 info: description: >- Production API reference for Membership.io. Use the authored guides for workflows and the generated endpoint pages for exact parameters and schemas. title: Membership.io API version: 0.1.0 servers: - description: Production url: https://api.member.dev security: - bearerAuth: [] paths: /api/v1/admin/teams/{team_id}/hubs/{hub_id}/events/{event_id}/cancel: post: tags: - hub-events-admin summary: Admin Cancel Event description: |- Cancel a hub event as the team principal. Idempotent -- re-cancelling an already-cancelled event is a no-op. Emits hub_event.cancelled. This endpoint takes no request body: unlike the member-facing cancel endpoint it never carries an organiser note to attendees. operationId: >- hub_events_admin.post_hub_events_admin_post_admin_teams_by_team_id_hubs_by_hub_id_events_by_event_id_cancel parameters: - in: path name: team_id required: true schema: title: Team Id type: string - in: path name: hub_id required: true schema: title: Hub Id type: string - in: path name: event_id required: true schema: title: Event Id type: string responses: '200': content: application/vnd.api+json: schema: $ref: '#/components/schemas/HubEventResponse' description: Successful Response '422': content: application/vnd.api+json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error components: schemas: HubEventResponse: additionalProperties: false properties: data: $ref: '#/components/schemas/HubEventResource' required: - data title: HubEventResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object HubEventResource: additionalProperties: false properties: attributes: $ref: '#/components/schemas/HubEventAttributes' id: title: Id type: string links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' type: const: hub_events default: hub_events title: Type type: string required: - id - attributes title: HubEventResource type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object HubEventAttributes: additionalProperties: false properties: announced_at: anyOf: - format: date-time type: string - type: 'null' description: >- When members were told this event exists, or null. Visible only to hub staff; always null for everyone else. Null also for an event that was never announced -- including events created before announcements shipped -- so a client renders the announcement chip if and only if this is present. title: Announced At announced_loudly: anyOf: - type: boolean - type: 'null' description: >- Whether that announcement went out as a broadcast. Only ever non-null alongside announced_at, and only for hub staff. It records what was actually sent, so it does not change if the host later flips the broadcast switch. title: Announced Loudly attendee_list_visible: title: Attendee List Visible type: boolean attendee_sample_contact_ids: default: [] items: type: string title: Attendee Sample Contact Ids type: array broadcast: description: >- Whether this event's announcement goes out as a broadcast. Not a mute switch -- see the create endpoint's field of the same name. title: Broadcast type: boolean capacity: anyOf: - type: integer - type: 'null' title: Capacity cover_image_url: anyOf: - type: string - type: 'null' title: Cover Image Url cover_media_id: anyOf: - type: string - type: 'null' description: >- Soft ref to the bound Media row, or null when no media-backed cover is set. When non-null, cover_url is derived from this media rather than cover_image_url. See PATCH .../events/{id}'s cover_media_id field for the one-shot bind/clear limitation. title: Cover Media Id cover_url: anyOf: - type: string - type: 'null' description: >- Derived, read-only display URL for the event cover -- resolved fresh on every read, never independently settable. A freshly (re-)signed URL when cover_media_id is bound and resolvable, else the raw cover_image_url value, else null. title: Cover Url cover_url_expires_at: anyOf: - format: date-time type: string - type: 'null' description: >- Expiry timestamp sealed into the signed cover_url, or null when cover_url is unsigned (a raw cover_image_url fallback) or itself null. title: Cover Url Expires At created_at: format: date-time title: Created At type: string description: anyOf: - type: string - type: 'null' title: Description ends_at: format: date-time title: Ends At type: string going_count: title: Going Count type: integer google_calendar_url: title: Google Calendar Url type: string host_contact_id: title: Host Contact Id type: string host_contact_ids: items: type: string maxItems: 3 minItems: 1 title: Host Contact Ids type: array hub_id: title: Hub Id type: string is_full: title: Is Full type: boolean location_address: anyOf: - type: string - type: 'null' title: Location Address location_type: enum: - url - address title: Location Type type: string location_url: anyOf: - type: string - type: 'null' title: Location Url my_rsvp_status: anyOf: - enum: - going - not_going - maybe type: string - type: 'null' title: My Rsvp Status rsvp_tag_id: anyOf: - type: string - type: 'null' title: Rsvp Tag Id segment_id: anyOf: - type: string - type: 'null' title: Segment Id starts_at: format: date-time title: Starts At type: string status: enum: - scheduled - cancelled title: Status type: string team_id: title: Team Id type: string timezone: title: Timezone type: string title: title: Title type: string updated_at: format: date-time title: Updated At type: string visibility: enum: - all_members - segment title: Visibility type: string required: - hub_id - team_id - title - description - cover_image_url - cover_media_id - cover_url - cover_url_expires_at - starts_at - ends_at - timezone - location_type - location_url - location_address - capacity - host_contact_id - host_contact_ids - visibility - segment_id - rsvp_tag_id - attendee_list_visible - status - going_count - is_full - google_calendar_url - my_rsvp_status - broadcast - announced_at - announced_loudly - created_at - updated_at title: HubEventAttributes type: object JsonApiLinks: properties: self: anyOf: - type: string - type: 'null' title: Self title: JsonApiLinks type: object securitySchemes: bearerAuth: bearerFormat: JWT or mio_sk API key description: >- Send platform JWTs, contact JWTs, or team API keys as `Authorization: Bearer `. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.