Skip to content
Cohost API

Create a new instance

POST
/events/{seriesId}/instances

Creates a sparse instance in subcollection with only overrides stored

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
seriesId
required
string

The series parent event ID

Request Body required

Section titled “Request Body required ”
object
start
required

Instance start date (ISO 8601)

string format: date-time
end
required

Instance end date (ISO 8601)

string format: date-time
Example
{
  "start": "2025-03-15T19:00:00Z",
  "end": "2025-03-15T22:00:00Z",
  "name": "Friday Night Special",
  "price": 9500
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Instance created successfully

object
status
string
Example
ok
data
object
id

Created instance ID

string

400

Section titled “400 ”

Bad request - validation failed

object
status
string
Example
error
message
string
Example
An error occurred
error
string

403

Section titled “403 ”

Forbidden - insufficient permissions

object
status
string
Example
error
message
string
Example
An error occurred
error
string

404

Section titled “404 ”

Parent series not found

object
status
string
Example
error
message
string
Example
An error occurred
error
string