# 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](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
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

```json
{
  "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

```json
"string"
```

---

API reference: https://doc.fours.com/api/
