DEVELOPER API
For conference organizers, we provide API access to remotely sync the SCHED* database with your existing event database.
Our API uses a simple REST method. We recommend using POST instead of GET. HTML data is not allowed for any fields unless clearly specified.
To populate the Event table, use the methods below by passing the appropriate field values.
EVENT: ADD URL: http://your_conference.sched.org/api/event/add
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| event_key | Yes | Must be a unique alpha-numeric string. E.g.: 123, PANEL4, ST45K etc. | 32 |
| name | Yes | Name of the event | 120 |
| event_start | Yes | Full date + time for start of event Format: YY-MM-DD HH:MM () | 40 |
| event_end | Yes | Full date + time when event ends Format: YY-MM-DD HH:MM () | 40 |
| event_type | Yes | Used to filter events | 32 |
| event_subtype | No | For additional filter/organizing events | 32 |
| description | No | Detailed description of the event Links (HTML Tag <a>) allowed. | 8kb |
| panelists | No | Detailed list of the panelists, artists, hosts Links (HTML Tag <a>) allowed. | 8kb |
| url | No | Unique external URL for this event | 250 |
| media_url | No | URL for media: audio/video/documents | 250 |
| venue | No | Building name / Company name etc. | 80 |
| address | No | Room # / Street Address | 250 |
| map | No | Direct URL for event's location / map | 250 |
| tags | No | Comma-separated words and phrases | 250 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/event/add?api_key=secret&event_key=kn1&name=Opening+Keynote&event_start=2008-06-12+10am&event_end=2008-06-12+12:15pm&event_type=keynote&venue=Center+Hall | |||
EVENT: MODIFY URL: http://your_conference.sched.org/api/event/mod
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| event_key | Yes | Must be a unique alpha-numeric string. E.g.: 123, PANEL4, ST45K etc. | 32 |
| name | No | Name of the event | 120 |
| event_start | No | Full date + time for start of event Format: YY-MM-DD HH:MM () | 40 |
| event_end | No | Full date + time when event ends Format: YY-MM-DD HH:MM () | 40 |
| event_type | No | Used to filter events | 32 |
| event_subtype | No | For additional filter/organizing events | 32 |
| description | No | Detailed description of the event Links (HTML Tag <a>) allowed. | 8kb |
| panelists | No | Detailed list of the panelists, artists, hosts Links (HTML Tag <a>) allowed. | 8kb |
| url | No | Unique external URL for this event | 250 |
| media_url | No | URL for media: audio/video/documents | 250 |
| venue | No | Building name / Company name etc. | 80 |
| address | No | Room # / Street Address | 250 |
| map | No | Direct URL for event's location / map | 250 |
| tags | No | Comma-separated words and phrases | 250 |
| active | No | Y = Event is active, N = Event is deactivated and hidden | 1 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/event/mod?api_key=secret&event_key=kn1&venue=Main+Auditorium | |||
EVENT: DELETE URL: http://your_conference.sched.org/api/event/del
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| event_key | Yes | Must be a unique alpha-numeric string. E.g.: 123, PANEL4, ST45K etc. | 32 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/event/del?api_key=secret&event_key=kn1 | |||
Note: The delete API only deactivates an event and hides it from the public schedule. This is the recommend way of handling cancelled events as any existing links to this event clearly display "[CANCELLED]" while still maintaining data integrity.
The following API methods let you retrieve data from the Event and User tables in CSV format.
EVENT: LIST URL: http://your_conference.sched.org/api/event/list
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/event/list?api_key=secret | |||
USER: LIST URL: http://your_conference.sched.org/api/user/list
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/user/list?api_key=secret | |||
USER: ACTIVE URL: http://your_conference.sched.org/api/user/active
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/user/active?api_key=secret | |||
USER: EVENTS URL: http://your_conference.sched.org/api/user/events
| Field | Required | Description | Max Length |
|---|---|---|---|
| api_key | Yes | Provided to you by us | 32 |
| Example GET Usage (all on one line) | |||
| http://your_conference.sched.org/api/user/events?api_key=secret | |||




