Convova
API reference

Sessions

The schedule — each session with its people, orgs, and tags.

List sessions (schedule)

GET
/events/{slug}/sessions

The schedule (visible only), ordered by start time. Each session nests its tags, contributors, and organizations.

Path Parameters

slug*string

The event's unique slug.

Query Parameters

offset?integer

Number of items to skip. Passing offset or limit switches the response to paginated mode.

Range0 <= value
limit?integer

Max items to return (1–100). Without it, a capped full list is returned and pagination is null.

Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/events/string/sessions"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "eventId": "d6703cc8-9e79-415d-ac03-a4dc7f6ab43c",      "title": "string",      "description": "string",      "startTime": "2019-08-24T14:15:22Z",      "endTime": "2019-08-24T14:15:22Z",      "visible": true,      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "tags": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "eventId": "d6703cc8-9e79-415d-ac03-a4dc7f6ab43c",          "name": "string",          "color": "string",          "sortOrder": 0        }      ],      "contributors": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "title": "string",          "organization": "string",          "avatarUrl": "http://example.com"        }      ],      "organizations": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "logoUrl": "http://example.com"        }      ]    }  ],  "error": null,  "pagination": {    "offset": 0,    "limit": 0,    "total": 0,    "hasMore": true  }}

Get a session

GET
/events/{slug}/sessions/{sessionId}

A single visible session with its nested tags, contributors, and organizations.

Path Parameters

slug*string

The event's unique slug.

sessionId*string

The session's id.

Formatuuid

Response Body

application/json

application/json

curl -X GET "https://example.com/events/string/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "eventId": "d6703cc8-9e79-415d-ac03-a4dc7f6ab43c",    "title": "string",    "description": "string",    "startTime": "2019-08-24T14:15:22Z",    "endTime": "2019-08-24T14:15:22Z",    "visible": true,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "tags": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "eventId": "d6703cc8-9e79-415d-ac03-a4dc7f6ab43c",        "name": "string",        "color": "string",        "sortOrder": 0      }    ],    "contributors": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "title": "string",        "organization": "string",        "avatarUrl": "http://example.com"      }    ],    "organizations": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "logoUrl": "http://example.com"      }    ]  },  "error": null,  "pagination": {    "offset": 0,    "limit": 0,    "total": 0,    "hasMore": true  }}