UniventsAPIPrograms
Create a program occurrence
Adds a dated occurrence to a program. The actor must be an owner or admin of the event.
POST
/programs/{program_id}/occurrencesAdds a dated occurrence to a program. The actor must be an owner or admin of the event.
Authorization
bearerAuth AuthorizationBearer <token>
JWT issued by IdentityX, signed with Ed25519
In: header
Path Parameters
program_id*string
Program ID.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for occurrence creation. Mirrors models.CreateProgramOccurrenceRequest.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/programs/497f6eca-6276-4993-bfeb-53cbbbba6f08/occurrences" \ -H "Content-Type: application/json" \ -d '{ "starts_at": "2026-05-04T09:00:00Z", "ends_at": "2026-05-04T10:30:00Z", "max_capacity": 200 }'{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"pagination": {
"page": 1,
"limit": 1,
"total": 0,
"has_next": true,
"has_prev": true,
"next_page": 0,
"prev_page": 0
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string",
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"program_id": "70c1146b-e933-4cb2-a789-bbca5312b517",
"edition_id": "aeda7fca-56fe-426a-8c37-1876faaaf005",
"starts_at": "2019-08-24T14:15:22Z",
"ends_at": "2019-08-24T14:15:22Z",
"max_capacity": 0,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}