Delete Event

Delete an Event

Permanently removes an event from your community. The event and its associated feed post are marked as deleted (they no longer appear in listings).

Authentication uses an API key issued by Networked.

HTTP Method

DELETE

Endpoint

https://api.networked.co/events

Headers

Name	Type	Required	Description
x-api-key	string	Yes	Secret API key provided by Networked. Required for authentication.
spaceId	string	No	Space ID when the event belongs to a Space. If omitted, the community tied to your API key is used.

Query Parameters

Parameters are sent in the URL query string, not in a request body.

Name	Type	Required	Description
eventId	string	Yes	ID of the event to delete (from Create Event or Get Events).
recurrenceOption	number	Conditional	Required for recurring events. Controls how much of the series is deleted. See Deleting recurring events. Omit for single (non-recurring) events.

Example URL:

DELETE https://api.networked.co/events?eventId=6855529c7000000012**2dd01&recurrenceOption=0

Non-recurring events

If the event is not part of a recurring series, send only eventId. The event and its feed post are deleted.

DELETE /events?eventId=6855529c7000000012**2dd01

Deleting recurring events

When the event is part of a recurring series, you must send recurrenceOption to choose the scope—same choices as Delete recurring event in the Networked app.

recurrenceOption

Value	UI label	What is deleted
0	This event	Only the occurrence identified by `eventId`. Other dates in the series remain.
1	This and following events	This occurrence and every later occurrence in the same series (same or later `startTime`). Earlier dates remain.
2	All events	Every occurrence in the series, including past and future dates.

When to use each value:

Your goal	recurrenceOption
Remove one date from the series	`0`
Remove this date and all future dates	`1`
Cancel the entire recurring series	`2`
Single (non-recurring) event	Omit (only `eventId`)

Sample request (single event)

DELETE https://api.networked.co/events?eventId=6855529c7000000012**2dd01

Headers:

x-api-key: your-api-key-here

Sample request (recurring — this event only)

DELETE https://api.networked.co/events?eventId=6855529c7000000012**2dd01&recurrenceOption=0

Sample request (recurring — this and following events)

DELETE https://api.networked.co/events?eventId=6855529c7000000012**2dd01&recurrenceOption=1

Sample request (recurring — all events in series)

DELETE https://api.networked.co/events?eventId=6855529c7000000012**2dd01&recurrenceOption=2

Sample Response

{
  "data": "Success",
  "error": false,
  "message": "Success"
}

Response Interface

interface DeleteEventResponse {
  data: string;
  error: boolean;
  message: string;
}

Response Field Descriptions

Field	Type	Description
data	string	Success message when the delete completes.
error	boolean	`false` indicates the API call was successful.
message	string	Human-readable result of the request.

Reference

Standard Response Codes Reference

Create Event (POST /events)

Update Event (PUT /events) — uses the same recurrenceOption values when editing a series

Get Events (GET /events) — obtain eventId

Notes

Only the event creator can delete an event. Requests from other users return an authorization error.

Use a valid API key for the community that owns the event.

For recurring events, always send recurrenceOption (0, 1, or 2). For a one-time event, only eventId is required.

recurrenceOption uses the same numeric values as Edit Event (0 = this event, 1 = this and following, 2 = all events).

Rate limits apply to API key requests. Retry with backoff if you receive a rate-limit response.

Delete an Event#

Authentication uses an API key issued by Networked.#

HTTP Method#

Endpoint#

Headers#

Query Parameters#

Non-recurring events#

Deleting recurring events#

recurrenceOption#

Sample request (single event)#

Sample request (recurring — this event only)#

Sample request (recurring — this and following events)#

Sample request (recurring — all events in series)#

Sample Response#

Response Interface#

Response Field Descriptions#

Reference#

Notes#

Request

Responses