v1

latestOpenAPI 3.0.3AGPLv32026-07-17448054.1 KB

Events

Create a new event

Creating new events is only allowed for registered organizations by authorizing themselves with an API token. These organizations must own reserved tags.

One or more reserved tags have to be provided upon creation. Otherwise all of the organization's reserved tags are added implicitly to the event.

post/events

Request body

idstring

Identifier of a resource

titlestring

descriptionstring

startinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

endinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

created_atinteger

Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps

created_bystring

The email address of the user who is responsible for the content. This information is only available for authorized organizations.

latnumber double

Geographic latitude (in degrees)

lngnumber double

Geographic longitude (in degrees)

streetstring

zipstring

citystring

countrystring

statestring

emailstring

An e-mail address.

telephonestring

tagsTag[]

homepagestring

registration'email' | 'telephone' | 'homepage'

Type of registration

organizerstring

image_urlstring

image_link_urlstring

Example request

{
  "id": "7cee99c287094a94acbdcf29ffff2e85",
  "title": "A great event",
  "description": "Detailed description of the event",
  "start": 1547403509,
  "end": 1547403509,
  "created_at": 1547403509000,
  "lat": 37.2,
  "lng": 120.7,
  "email": "john.smith@example.com",
  "telephone": "001 123456789",
  "tags": [
    "organic",
    "non-profit"
  ],
  "homepage": "https://www.slowtec.de/",
  "registration": "telephone",
  "image_url": "https://www.slowtec.de/",
  "image_link_url": "https://www.slowtec.de/"
}

Response

Created a new event

string required

The ID of the created event