Talks¶

Resource description¶

The talk resource is the same as the submission resource, but will limit the returned submissions to talks that already have a slot on the current schedule. It contains the following public fields:

Field	Type	Description
code	string	A unique, alphanumeric identifier, also used in URLs
speakers	list	A list of speaker objects, e.g. `[{"name": "Jane", "code": "ABCDEF", "biography": ""}]`
created	string	The time of submission creation as an ISO-8601 formatted datetime. Available if the requesting user has organiser permission.
title	string	The submission’s title
submission_type	string	The submission type (e.g. “talk”, “workshop”)
submission_type_id	number	ID of the submission type
track	string	The track this talk belongs to (e.g. “security”, “design”, or `null`)
track_id	number	ID of the track this talk belongs to (e.g. “security”, “design”, or `null`)
state	string	The submission’s state, one of “submitted”, “accepted”, “rejected”, “confirmed”
abstract	string	The abstract, a short note of the submission’s content
description	string	The description, a more expansive description of the submission’s content
duration	number	The talk’s duration in minutes, or `null`
do_not_record	boolean	Indicates if the speaker consent to recordings of their talk
is_featured	boolean	Indicates if the talk is show in the schedule preview / sneak peek
content_locale	string	The language the submission is in, e.g. “en” or “de”
slot	object	An object with the scheduling details, e.g. `{"start": …, "end": …, "room": "R101", "room_id": 12}` if they exist. This will not be present til after the schedule is released.
slot_count	number	How often this submission may be scheduled.
answers	list	The question answers given by the speakers. Available if the requesting user has organiser permissions, and if the `questions` query parameter is passed.
notes	string	Notes the speaker left for the organisers. Available if the requesting user has organiser permissions.
internal_notes	string	Notes the organisers left on the submission. Available if the requesting user has organiser permissions.
tags	list	The tags attached to the current submission, as a list of strings. Available if the requesting user has organiser or reviewer permissions.
tag_ids	list	The tags attached to the current submission, as a list of IDs. Available if the requesting user has organiser or reviewer permissions.

Added in version 1.1.0: The resources field for file uploads was added in pretalx v1.1.0.

Added in version 2.2.0: The tags field was added in pretalx v2.2.0.

Added in version 3.0.0: The track_id, tag_ids and submission_type_id fields were added, as well as the room_id field in the slot object.

Changed in version 3.0.0: The answers field was turned off by default in pretalx v3.0.0. Pass the questions query parameter to see questions, and pass questions=all to get the previous behaviour.

Endpoints¶

GET /api/events/{event}/talks¶

Returns a list of all scheduled submissions the authenticated user/token has access to, or all confirmed, publicly scheduled submissions for unauthenticated users. For a list of all submissions regardless of their state, authenticated users may choose to use the /api/events/{event}/submissions endpoint instead.

Example request:

GET /api/events/sampleconf/talks HTTP/1.1
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "code": "ABCDE",
      "speakers": [{"name": "Jane", "code": "DEFAB", "biography": ""}],
      "title": "A talk",
      "submission_type": "talk",
      "submission_type_id": 12,
      "state": "confirmed",
      "abstract": "A good talk.",
      "description": "I will expand upon the properties of the talk, primarily its high quality.",
      "duration": 30,
      "do_not_record": true,
      "is_featured": false,
      "content_locale": "en",
      "slot": {
        "start": "2017-12-27T10:00:00Z",
        "end": "2017-12-27T10:30:00Z",
        "room": "R101",
        "room_id": 12
      }
    },
    "answers": [
      {
        "id": 1,
        "question": {"id": 1, "question": {"en": "How much do you like green, on a scale from 1-10?"}, "required": false, "target": "submission", "options": []},
        "answer": "11",
        "answer_file": null,
        "submission": "ABCDE",
        "person": null,
        "options": []
      }
     ],
     "notes": "Please make sure you give me red M&Ms",
     "internal_notes": "Absolutely no M&Ms, but cool proposal otherwise!",
     "tags": ["science"],
     "tag_ids": [5]
  ]
}

Parameters:

event – The slug field of the event to fetch

Query Parameters:

page – The page number in case of a multi-page result set, default is 1
q – Search through submissions by title and speaker name
submission_type – Filter submissions by submission type
state – Filter submission by state
questions – Pass a comma separated list of question IDs to load, or the string ‘all’ to return all answers.

GET /api/events/(event)/talks/{code}¶

Returns information on one event, identified by its slug.

Example request:

GET /api/events/sampleconf/talks/ABCDE HTTP/1.1
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABCDE",
  "speakers": [{"name": "Jane", "code": "DEFAB", "biography": ""}],
  "title": "A talk",
  "submission_type": "talk",
  "submission_type_id": 12,
  "state": "confirmed",
  "abstract": "A good talk.",
  "description": "I will expand upon the properties of the talk, primarily its high quality.",
  "duration": 30,
  "do_not_record": true,
  "is_featured": false,
  "content_locale": "en",
  "slot": {
    "start": "2017-12-27T10:00:00Z",
    "end": "2017-12-27T10:30:00Z",
    "room": "R101",
    "room_id": 12
  },
  "answers": [
    {
      "id": 1,
      "question": {"id": 1, "question": {"en": "How much do you like green, on a scale from 1-10?"}, "required": false, "target": "submission", "options": []},
      "answer": "11",
      "answer_file": null,
      "submission": "ABCDE",
      "person": null,
      "options": []
    }
   ],
   "notes": "Please make sure you give me red M&Ms",
   "internal_notes": "Absolutely no M&Ms, but cool proposal otherwise!",
   "tags": ["science"],
   "tag_ids": [5]
}

Parameters:

event – The slug field of the event to fetch
code – The code field of the submission to fetch

Query Parameters:

questions – Pass a comma separated list of question IDs to load, or the string ‘all’ to return all answers.

Status Codes:

200 OK – no error
401 Unauthorized – Authentication failure
403 Forbidden – The requested event does not exist or you have no permission to view it.