Update Event

Update Event

curl --request PATCH \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "timezone": "<string>",
  "type": "<string>",
  "url": "<string>",
  "venueName": "<string>",
  "address": "<string>",
  "location": {},
  "visibility": "<string>",
  "capacity": 123,
  "allowMaybe": true,
  "guestListVisible": true,
  "metadata": {},
  "removeImageIds": [
    "<string>"
  ],
  "cover.options": "<string>",
  "gallery": [
    null
  ],
  "gallery.options": "<string>"
}
'

import requests

url = "https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId"

payload = {
    "title": "<string>",
    "description": "<string>",
    "startTime": "<string>",
    "endTime": "<string>",
    "timezone": "<string>",
    "type": "<string>",
    "url": "<string>",
    "venueName": "<string>",
    "address": "<string>",
    "location": {},
    "visibility": "<string>",
    "capacity": 123,
    "allowMaybe": True,
    "guestListVisible": True,
    "metadata": {},
    "removeImageIds": ["<string>"],
    "cover.options": "<string>",
    "gallery": [None],
    "gallery.options": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    description: '<string>',
    startTime: '<string>',
    endTime: '<string>',
    timezone: '<string>',
    type: '<string>',
    url: '<string>',
    venueName: '<string>',
    address: '<string>',
    location: {},
    visibility: '<string>',
    capacity: 123,
    allowMaybe: true,
    guestListVisible: true,
    metadata: {},
    removeImageIds: ['<string>'],
    'cover.options': '<string>',
    gallery: [null],
    'gallery.options': '<string>'
  })
};

fetch('https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'description' => '<string>',
    'startTime' => '<string>',
    'endTime' => '<string>',
    'timezone' => '<string>',
    'type' => '<string>',
    'url' => '<string>',
    'venueName' => '<string>',
    'address' => '<string>',
    'location' => [
        
    ],
    'visibility' => '<string>',
    'capacity' => 123,
    'allowMaybe' => true,
    'guestListVisible' => true,
    'metadata' => [
        
    ],
    'removeImageIds' => [
        '<string>'
    ],
    'cover.options' => '<string>',
    'gallery' => [
        null
    ],
    'gallery.options' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"startTime\": \"<string>\",\n  \"endTime\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"type\": \"<string>\",\n  \"url\": \"<string>\",\n  \"venueName\": \"<string>\",\n  \"address\": \"<string>\",\n  \"location\": {},\n  \"visibility\": \"<string>\",\n  \"capacity\": 123,\n  \"allowMaybe\": true,\n  \"guestListVisible\": true,\n  \"metadata\": {},\n  \"removeImageIds\": [\n    \"<string>\"\n  ],\n  \"cover.options\": \"<string>\",\n  \"gallery\": [\n    null\n  ],\n  \"gallery.options\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"startTime\": \"<string>\",\n  \"endTime\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"type\": \"<string>\",\n  \"url\": \"<string>\",\n  \"venueName\": \"<string>\",\n  \"address\": \"<string>\",\n  \"location\": {},\n  \"visibility\": \"<string>\",\n  \"capacity\": 123,\n  \"allowMaybe\": true,\n  \"guestListVisible\": true,\n  \"metadata\": {},\n  \"removeImageIds\": [\n    \"<string>\"\n  ],\n  \"cover.options\": \"<string>\",\n  \"gallery\": [\n    null\n  ],\n  \"gallery.options\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"startTime\": \"<string>\",\n  \"endTime\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"type\": \"<string>\",\n  \"url\": \"<string>\",\n  \"venueName\": \"<string>\",\n  \"address\": \"<string>\",\n  \"location\": {},\n  \"visibility\": \"<string>\",\n  \"capacity\": 123,\n  \"allowMaybe\": true,\n  \"guestListVisible\": true,\n  \"metadata\": {},\n  \"removeImageIds\": [\n    \"<string>\"\n  ],\n  \"cover.options\": \"<string>\",\n  \"gallery\": [\n    null\n  ],\n  \"gallery.options\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

PATCH

:projectId

api

events

:eventId

Update Event

curl --request PATCH \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "timezone": "<string>",
  "type": "<string>",
  "url": "<string>",
  "venueName": "<string>",
  "address": "<string>",
  "location": {},
  "visibility": "<string>",
  "capacity": 123,
  "allowMaybe": true,
  "guestListVisible": true,
  "metadata": {},
  "removeImageIds": [
    "<string>"
  ],
  "cover.options": "<string>",
  "gallery": [
    null
  ],
  "gallery.options": "<string>"
}
'

import requests

url = "https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId"

payload = {
    "title": "<string>",
    "description": "<string>",
    "startTime": "<string>",
    "endTime": "<string>",
    "timezone": "<string>",
    "type": "<string>",
    "url": "<string>",
    "venueName": "<string>",
    "address": "<string>",
    "location": {},
    "visibility": "<string>",
    "capacity": 123,
    "allowMaybe": True,
    "guestListVisible": True,
    "metadata": {},
    "removeImageIds": ["<string>"],
    "cover.options": "<string>",
    "gallery": [None],
    "gallery.options": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    description: '<string>',
    startTime: '<string>',
    endTime: '<string>',
    timezone: '<string>',
    type: '<string>',
    url: '<string>',
    venueName: '<string>',
    address: '<string>',
    location: {},
    visibility: '<string>',
    capacity: 123,
    allowMaybe: true,
    guestListVisible: true,
    metadata: {},
    removeImageIds: ['<string>'],
    'cover.options': '<string>',
    gallery: [null],
    'gallery.options': '<string>'
  })
};

fetch('https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'description' => '<string>',
    'startTime' => '<string>',
    'endTime' => '<string>',
    'timezone' => '<string>',
    'type' => '<string>',
    'url' => '<string>',
    'venueName' => '<string>',
    'address' => '<string>',
    'location' => [
        
    ],
    'visibility' => '<string>',
    'capacity' => 123,
    'allowMaybe' => true,
    'guestListVisible' => true,
    'metadata' => [
        
    ],
    'removeImageIds' => [
        '<string>'
    ],
    'cover.options' => '<string>',
    'gallery' => [
        null
    ],
    'gallery.options' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"startTime\": \"<string>\",\n  \"endTime\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"type\": \"<string>\",\n  \"url\": \"<string>\",\n  \"venueName\": \"<string>\",\n  \"address\": \"<string>\",\n  \"location\": {},\n  \"visibility\": \"<string>\",\n  \"capacity\": 123,\n  \"allowMaybe\": true,\n  \"guestListVisible\": true,\n  \"metadata\": {},\n  \"removeImageIds\": [\n    \"<string>\"\n  ],\n  \"cover.options\": \"<string>\",\n  \"gallery\": [\n    null\n  ],\n  \"gallery.options\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"startTime\": \"<string>\",\n  \"endTime\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"type\": \"<string>\",\n  \"url\": \"<string>\",\n  \"venueName\": \"<string>\",\n  \"address\": \"<string>\",\n  \"location\": {},\n  \"visibility\": \"<string>\",\n  \"capacity\": 123,\n  \"allowMaybe\": true,\n  \"guestListVisible\": true,\n  \"metadata\": {},\n  \"removeImageIds\": [\n    \"<string>\"\n  ],\n  \"cover.options\": \"<string>\",\n  \"gallery\": [\n    null\n  ],\n  \"gallery.options\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sublay.io/api/v6/:projectId/api/v7/events/:eventId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"startTime\": \"<string>\",\n  \"endTime\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"type\": \"<string>\",\n  \"url\": \"<string>\",\n  \"venueName\": \"<string>\",\n  \"address\": \"<string>\",\n  \"location\": {},\n  \"visibility\": \"<string>\",\n  \"capacity\": 123,\n  \"allowMaybe\": true,\n  \"guestListVisible\": true,\n  \"metadata\": {},\n  \"removeImageIds\": [\n    \"<string>\"\n  ],\n  \"cover.options\": \"<string>\",\n  \"gallery\": [\n    null\n  ],\n  \"gallery.options\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Updates an event. Host-only — the caller must be in hostIds (service/master keys bypass this). Every provided field is updated; omitted fields are left untouched. Type-conditional location validation is re-applied when type is present. hostIds, status, and spaceId are not editable here — manage hosts via the host endpoints, cancel via Cancel Event; the space is immutable. Images can be curated in one request: a new cover replaces the existing cover, gallery files are appended, and removeImageIds deletes existing event images by File ID. Any image operation requires the files-images bundle. When a time field (startTime/endTime/timezone) or a location field (location/url/venueName/address) actually changes, an event-updated notification is fanned out to all going/maybe RSVPs (best-effort, requires the notifications bundle).

Path Parameters

string

required

UUID of the event to update.

Body Parameters

string

Event title. 1–300 characters.

string

New description.

string

New ISO start datetime.

string

New ISO end datetime.

string

New IANA timezone.

string

"online", "physical", or "hybrid". Re-triggers location validation.

string

Join/stream URL.

string

Venue name.

string

Street address.

{ latitude: number; longitude: number }

New coordinates. On multipart requests, send as a JSON string.

string

"public", "members", or "invite".

number

New capacity (positive integer).

boolean

Whether "maybe" RSVPs are allowed.

boolean

Whether non-hosts can view the guest list.

object

Arbitrary key-value data. Up to 1 MB.

string[]

File IDs of existing event images to remove (gallery photos and/or the current cover). Each must belong to this event. On multipart requests, send as a JSON string.

file

New cover image (replaces the current cover). Multipart file field. Requires cover.options.

string

JSON-stringified image-processing options for the new cover.

file[]

Gallery images to append (up to 10). Multipart file field. Requires gallery.options.

string

JSON-stringified image-processing options for the appended gallery images.

Response

Returns the updated Event object.

Error Responses

Not Found — 404

{ "error": "Event not found", "code": "event/not-found" }

Forbidden (not a host) — 403

{ "error": "Only a host of this event may update it.", "code": "event/forbidden" }

files-images Bundle Required — 403

{ "error": "Event cover/gallery images require the files-images bundle. Enable it for this project.", "code": "event/files-images-bundle-required" }

Invalid removeImageIds — 400

{ "error": "Some removeImageIds do not belong to this event.", "code": "event/invalid-remove-image-ids" }

Overview

Auth Endpoints

OAuth Endpoints

User Endpoints

User Follow Operations

User Connection Operations

Follow Endpoints

Connection Endpoints

Entity Endpoints

Comment Endpoints

Chat — Conversations

Chat — Members

Chat — Messages

Collection Endpoints

App Notification Endpoints

Push Notification Endpoints

Report Endpoints

Search Endpoints

Space Endpoints

Space — Membership

Space — Rules

Space — Moderation

Space — Chat

Event Endpoints

Storage Endpoints

Utils

Crypto

Path Parameters

Body Parameters

Response

Error Responses

​Path Parameters

​Body Parameters

​Response

​Error Responses

Path Parameters

Body Parameters

Response

Error Responses