Get One Partner Event

GET https://api.suger.cloud/ai/org/{orgId}/prm/event/{eventId}

Return one partner event this organization owns, or one shared with it by an organization whose partner program it belongs to, with its schedule, location or meeting link, sharing (`visibilityType` and `shareTargetIds`) and RSVP settings. `eventId` is the `id` of a row from ListPartnerEvents. Answers 404 when the event does not exist or is not shared with this organization.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
eventId path string yes Event ID

Responses

200 — Event

Content-Type: application/json · Schema: PartnerEventView

PartnerEventView fields:

FieldTypeRequiredDescription
attendingCount integer no
capacity integer no Max attendees as a head count of attending partner_event_rsvp rows; NULL = uncapped. Only meaningful when is_rsvp_enabled=true — handler must reject capacity when RSVP is disabled and enforce the limit transactionally on write.
createTime string no Creation timestamp
creatorOrgName string no
description string no Freeform event description
endDatetime string no Event end (UTC)
id string no ID of the ent. Unique event identifier (UUID)
isRsvpEnabled boolean no Whether partners can RSVP to this event
lastUpdateTime string no Last update timestamp
location string no Freeform physical address/venue for in-person/hybrid events; NULL = online-only. Online vs in_person vs hybrid is derived from which of meeting_url/location are set.
meetingUrl string no Join link for online/hybrid events; NULL = no online component
organizationId string no Host ISV org that created the event (tenant isolation).
shareTargetIds array<string> no
startDatetime string no Event start (UTC)
status string no draft, published, cancelled. Lifecycle only — 'past' is computed from end_datetime, not stored.
timezone string no IANA tz name, e.g. America/Vancouver
title string no Event display name
type string no webinar, training, in_person, general.
viewerRsvpStatus string no
visibilityType string no all (every partner — no partner_event_visibility rows), specific (target_type=partner), tier (target_type=tier)

404 — Event not found

Content-Type: application/json

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/prm/event/{eventId}' \
  -H "Authorization: Bearer $SUGER_TOKEN"

Response — 200

{
  "attendingCount": 1,
  "capacity": 1,
  "createTime": "2026-01-31T12:00:00Z",
  "creatorOrgName": "Acme Corp",
  "description": "string",
  "endDatetime": "2026-01-31T12:00:00Z",
  "id": "01H0000000000000000000",
  "isRsvpEnabled": true,
  "lastUpdateTime": "2026-01-31T12:00:00Z",
  "location": "string",
  "meetingUrl": "https://example.com",
  "organizationId": "01H0000000000000000000"
}

Error — 404

"string"

View as Markdown · API reference overview

Spotted something wrong or out of date on this page? Tell us and we'll correct it.