Create Event | Taktoria API

{
  "id": "id",
  "organizationId": "organizationId",
  "title": "title",
  "code": "code",
  "status": "DRAFT",
  "settings": {
    "allowAnonymous": true,
    "moderationEnabled": true,
    "allowUpvotes": true,
    "allowReplies": true,
    "profanityFilter": true
  },
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "description": "description",
  "startsAt": "2024-01-15T09:30:00Z",
  "endsAt": "2024-01-15T09:30:00Z",
  "questionsOpenAt": "2024-01-15T09:30:00Z",
  "questionsCloseAt": "2024-01-15T09:30:00Z",
  "timeZone": "timeZone",
  "instructions": "instructions",
  "capacityAtEvent": 1,
  "overageParticipants": 1,
  "questionCount": 1,
  "participantCount": 1,
  "host": {
    "id": "id",
    "name": "name",
    "email": "email",
    "image": "image"
  },
  "archivedAt": "2024-01-15T09:30:00Z"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

titlestringRequired

descriptionstringOptional

codestringOptional

Left out, one is generated. Given, it must be free in this workspace.

passcodestringOptional

statusenumOptional

What the doors are doing. startsAt and endsAt are informational: this is what actually opens them, because a meeting that starts late should not lock the room out of its own Q&A.

startsAtstringOptional

endsAtstringOptional

questionsOpenAtstringOptional

questionsCloseAtstringOptional

timeZonestringOptional

instructionsstringOptional

allowAnonymousbooleanOptional

moderationEnabledbooleanOptional

allowUpvotesbooleanOptional

allowRepliesbooleanOptional

profanityFilterbooleanOptional

Response

This endpoint returns an object.

idstring

organizationIdstring

titlestring

codestring

The short code the room types. Unique inside the workspace rather than globally, so two workspaces can each hold the memorable one their host wants.

statusenum

What the doors are doing. startsAt and endsAt are informational: this is what actually opens them, because a meeting that starts late should not lock the room out of its own Q&A.

settingsobject

createdAtdatetime

updatedAtdatetime

descriptionstringOptional

startsAtdatetimeOptional

endsAtdatetimeOptional

questionsOpenAtdatetimeOptional

When questions may be asked, if that is not simply "while live".

questionsCloseAtdatetimeOptional

timeZonestringOptional

IANA zone the event’s times are written in, such as Europe/Berlin.

instructionsstringOptional

capacityAtEventintegerOptional

What the workspace was paying for per event when this one was settled. Absent until then: it is copied onto the event so that raising the plan later cannot rewrite an invoice already sent.

overageParticipantsintegerOptional

questionCountintegerOptional

participantCountintegerOptional

hostobjectOptional

A person in a Taktoria organization.

archivedAtdatetimeOptional

Errors

402

Subscription Required Error

409

Conflict Error

422

Validation Error