Events

Update an event

Changed on

Events can only be updated by the organization that owns them. Ownership is determined by the event's reserved tags.

The updated event must be assigned at least one of the organization's reserved tags. Otherwise all reserved tags of the event are preserved by implicitly re-adding them.

put/events/{id}

Request

  • Base URL
    https://api.ofdb.io/v0
  • URL
    https://api.ofdb.io/v0/events/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

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

Successfully updated the event

Changes

  • b2a47c048e83Revision changes
    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      removed from the request property oneOf list

    • breaking

      removed from the request property oneOf list

    • breaking

      the request property type changed from integer to no type, and format from int64 to no format

    • info

      the request optional property became not read-only

  • bca9ebb2d24aRevision changes
    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      the request property type changed from string to no type

    • breaking

      the request property type changed from string to no type

    • info

      the request property's minLength was decreased from 3 to 0