Agenda Sessions Query

Overview

Agenda Sessions are individual items in an event's schedule.

Agenda Sessions may be "bookmarked" by an attendee to be placed on their personal schedule.

Bookmarked Agenda Sessions may be accessed as part of the attendee record.

Arguments

• gatheringId: (Int!)

The gathering identifier for which agenda sessions are requested.

• filters: (Filter)
• createdAfter: (Date!) Returns resources created at or after the specified datetime (inclusive). Datetime must be in ISO 8601 format.
• createdBefore: (Date!) Returns resources created at or before the specified datetime (inclusive). Datetime must be in ISO 8601 format.
• updatedAfter: (Date!) Returns resources updated at or after the specified datetime (inclusive). Datetime must be in ISO 8601 format.
• updatedBefore: (Date!) Returns resources updated at or before the specified datetime (inclusive). Datetime must be in ISO 8601 format.

CURL Request

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer abcyourauthenticationtoken123' -d '{agendaSessions(gatheringId: 232) {name startsAt endsAt}}'

Nested Relationships

To request relationships, include the nested relationships and the associated attributes. This query will return the name, id, and externalId for each agenda session, as well as related links and speakers associated with the agenda session, including the id, name, and url for those sessions.

Query Example

{
  agendaSessions(gatheringId: 232) {
    name
    startsAt
    id
    externalId
    createdAt
    updatedAt
    relatedLinks {
      id
      name
      url
    }
    speakers {
      id
      firstName
      lastName
    }
  }
}

CURL Request (Nested Relationships)

curl -X POST https://api.certaintouchpoint.com/graphql -H 'Content-Type: application/graphql' -H 'Authorization: Bearer abcyourauthenticationtoken123' -d '{ agendaSessions(gatheringId: 232) { name startsAt id externalId relatedLinks { id name url }}}'

AgendaSessionParams

Attributes

• id (String) Touchpoint assigned id of the agenda session.
• name (String) The name of the agenda session as it appears on the public agenda.
• description (String) Text description of the event. No character limit.
• startsAt (Datetime) The start date and time of the agenda session in UTC.
• endsAt (Datetime) The end date and time of the agenda session in UTC.
• parentAgendaSessionId (Id) For sub-sessions, this is the id of the parent session.
• externalId (String) The unique ID of the agenda session from it's source (i.e., the agenda session id in your system). Not displayed.
• externalSource (String) External data source of the agenda session. If you have created this agenda session in the Touchpoint system, Touchpoint will define the externalSource. Not displayed.
• generateCheckInCode (String) If true, Touchpoint will set the checkInType to "code" for this agenda session and generate a code automatically.
• checkInCode (String) If the checkInType includes "code", this is the relevant code
• checkInType (String) Current options: unverified, scan, code, time_bounded, code_and_time_bounded, none
• timeZone (String) Typically the gathering is the source of the time zone, but if the agenda session has a different time zone, include it here.
• speakers ([SpeakerParams]) Speaker id. Note that Speaker params are structured [{ id: 23213 }]
• createdAt: (Date!) Timestamp indicating when the resource was created. Returned in ISO 8601 UTC format.
• updatedAt: (Date!) Timestamp indicating when the resource was last updated. Returned in ISO 8601 UTC format.

Related UI

Related articles:

• Agenda Feature Settings and Management
• createAgendaSession
• Attendees Query
• Checkin Query
• Gatherings Query