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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
orgId | path | string | yes | Organization ID |
eventId | path | string | yes | Event ID |
Request Body
Required. Content-Type: application/json · Schema: PartnerEventUpdate
PartnerEventUpdate fields:
| Field | Type | Required | Description |
|---|---|---|---|
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:
| Field | Type | Required | Description |
|---|---|---|---|
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.