Edit a Partner Event

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

Change one of this organization's events: fields you leave out stay as they are. Set `status` to published, or to cancelled to call the event off (it then takes no new RSVPs). Sending `shareTargetIds` replaces who the event is shared with, read with `visibilityType`; when you change `visibilityType`, send `shareTargetIds` with it (`[]` for `all`), or the old targets stay and partners may stop seeing the event. `capacity` cannot go below the number already attending (409 EVENT_CAPACITY_BELOW_ATTENDANCE). `eventId` is the event's `id` from ListPartnerEvents; only the organization that owns the event can change it.

Parameters

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

Request Body

Required. Content-Type: application/json · Schema: PartnerEventUpdate

PartnerEventUpdate fields:

FieldTypeRequiredDescription
capacity integer no
description string no
endDatetime string no
isRsvpEnabled boolean no
location string no
meetingUrl string no
shareTargetIds array<string> no ShareTargetIDs, when non-nil, replaces the event's visibility rows wholesale (interpreted per VisibilityType). Nil leaves sharing untouched.
startDatetime string no
status string no
timezone string no
title string no
type string no
visibilityType string no

Responses

200 — Updated 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)

400 — Validation error

Content-Type: application/json

404 — Event not found

Content-Type: application/json

Example

The request bodies are this operation's documented examples; the response and error bodies are generated from its schema. Substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X PATCH 'https://api.suger.cloud/ai/org/{orgId}/prm/event/{eventId}' \
  -H "Authorization: Bearer $SUGER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "status": "published"
}'

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 — 400

"string"

View as Markdown · API reference overview

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