Introduction

event thing API

The event thing API lets VTCs manage events and invitations without doing the same work across several different platforms.

You can use it to create and import events, invite one or more VTCs, read invite responses, manage invite discussions and control who is allowed to invite your VTC.

Base URL 

https://api.eventthing.example/v1

The hostname above is a placeholder. Replace it with the production API hostname before publishing the docs.

What you can do

  • Read information about the VTC your token belongs to.
  • Create, import, update and delete events.
  • Invite one or more VTCs to an event.
  • List invites and filter them by status.
  • Read, accept and decline individual invites.
  • Remove an invite that your VTC previously sent.
  • Read and send messages in an invite discussion.
  • Block a user or an entire VTC from inviting your VTC.
  • Inspect your VTC's block list.
  • Read another VTC's public events.

Authentication

Every API request uses a Bearer token.

Authorization: Bearer YOUR_API_TOKEN

API tokens are scoped to a VTC. The token determines which VTC an action is performed for.