Delete facility requests

Delete several booking requests at once. Provide ids, or explicitly set include to false with an event or parent filter to delete every request matching the filters; without one of those the request is rejected with 400, as is an empty body. With the Full Write Facilities permission you can delete any request; otherwise only callers who can administer the associated event can: events writers at its campuses within their calendar limit, and the event's admins (organizers, administrators of its group, group members with the Events flag). While multi-campus or multi-org limits apply, a selection by ids or by filtering on event deletes the requests of each event you administer at any location, whatever the selected campus lens, and the others keep the campus filter; a holder deletes at campuses where they hold it, and at a venue only while holding it across the venue's whole scope or running the request's event. Explicit ids that include a request at a venue the holder cannot delete answer 403 with no_campus_rows_record_delete_desc while multi-org is on and every_campus_record_delete_desc while it is off, and nothing is deleted; include false leaves such requests in place. The response reports how many were deleted and how many of the requests the caller can see were left in place.

Required permission: Full Write Facilities

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int32
≥ 1

The id of an event. Returns the requests made for it. For an occurrence of a repeating event, returns the requests for the whole series.

int32
≥ 1

The id of a repeating event. Returns the requests made for its occurrences.

date-time

Return requests whose booking starts on or after this date.

date-time

Return requests whose booking starts on or before this date.

string

Use future to return only requests that have not ended yet, or past for ones that have.

string

Return requests for rooms whose names contain the given words.

string

Return requests for items whose names contain the given words.

string

Return requests made by a person whose first or last name contains the given text.

string

Return requests whose setup notes contain the given text.

Body Params

The ids of the requests to delete

ids
array of doubles | null

The ids the operation applies to: an include list by default, or an exclude list when include is false. For deletes, required unless include is false.

ids
boolean | null

Whether ids is an include list (true, default) or an exclude list (false). Setting include to false with no ids applies the operation to every record matching the query filters.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json