Records

Create a session

Creates a session on an event owned by the key's organization and fires the session.added trigger. A session must be accepted before it can be scheduled. Supply an accepted-category statusId from this event when assigning a time.

post/api/v1/sessions

Request

  • Base URL: https://api.agendaforge.app
  • URL: https://api.agendaforge.app/api/v1/sessions
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring

Optional key for safe retries, retained for 24 hours. Repeating the same request on the same endpoint returns the original response and sets Idempotent-Replay: true. Reusing the key on a different endpoint returns 409.

Request body

eventIdstring required

The event the session belongs to; must be owned by the key's organization.

titlestring required
statusIdstring

A session status id from this event. A session must be accepted before it can be scheduled.

typestring

keynote | talk | panel | workshop | lightning | break | networking | social | placeholder | other. Defaults to "talk".

descriptionstring
durationnumber

Minutes; falls back to the type's default duration when omitted.

startTimestring

ISO-8601 UTC timestamp.

endTimestring

ISO-8601 UTC timestamp.

maxAttendeesnumber
isPublicboolean
tagsstring[]

Response

The created session.

idstring
eventIdstring
eventNamestring
eventNumbernumber nullable
orgIdstring
titlestring
descriptionstring nullable
typestring
statusstring
trackIdstring nullable
trackNamestring nullable
roomIdstring nullable
roomNamestring nullable
startTimestring nullable
endTimestring nullable
durationnumber

Minutes.

maxAttendeesnumber nullable
tagsstring[]
isPublicboolean
isTentativeboolean
parentSessionIdstring nullable
customFieldsobject nullable
sourcestring nullable
createdAtstring

ISO-8601 UTC timestamp.

Changes

No recorded changes to this operation across all 1 revision of this API.