Skip to content
/
Update Event (v2)

Business Management (2.0.0)

Next-generation B2B API with improved design and consistency.

Base URL: https://api.alteg.io/api

🚀 Version Status

V2 is in active development. This API version is being actively developed and expanded. New features and improvements are released here first. We recommend using V2 for all new integrations.

Authentication

Requires both partner and user authorization:

Authorization: Bearer <partner_token>, User <user_token>

About v2

V2 endpoints offer improved request/response structures and consistent naming. This collection is actively growing as we modernize the API.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
License
Altegio API Agreement
Terms of Service
Languages
Servers
Mock server
https://developer.alteg.io/_mock/en/b2b-v2/openapi/
Production
https://api.alteg.io/api/v2/

Team Members

Team member and position management.

Operations

Events

Group events (activities) management.

Operations

Get Event (v2)

Request

Returns detailed information about a specific Event using v2 API.

Security
BearerPartnerUser
Path
location_idintegerrequired

Location (business) ID

event_idintegerrequired

Event ID

Headers
Acceptstringrequired

API version header

Default application/vnd.api.v2+json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/{location_id}/activities/{event_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>'

Responses

Event details retrieved successfully

Bodyapplication/json
dataobject

Event details (JSON:API format)

metaArray of objects
Response
application/json
{
  "data": {
    "type": "activity",
    "id": "10126531",
    "attributes": { … }
  },
  "meta": [
    {}
  ]
}

Update Event (v2)

Request

Updates an existing Event using v2 API.

Security
BearerPartnerUser
Path
location_idintegerrequired

Location (business) ID

event_idintegerrequired

Event ID

Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Content-Typestringrequired
Default application/json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

Bodyapplication/jsonrequired
staff_idintegerrequired

Team member ID

service_idintegerrequired

Service ID

resource_instance_idsArray of integersrequired

List of resource instance IDs (required, can be empty)

label_idsArray of integersrequired

List of category/tag IDs (required, can be empty)

datestring(date-time)required

Event date and time

lengthintegerrequired

Event duration in seconds

capacityintegerrequired

Number of available slots

technical_break_durationinteger or null

Technical break duration (multiples of 300, max 3600)

One of:

Technical break duration (multiples of 300, max 3600)

integer
commentstring

Event comment

colorstring

Event color (hex format)

instructionsstring

Instructions for the event

stream_linkstring

Stream link for online events

forceboolean

Skip resource availability check

Default false
curl -i -X PUT \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/{location_id}/activities/{event_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "staff_id": 0,
    "service_id": 0,
    "resource_instance_ids": [
      0
    ],
    "label_ids": [
      0
    ],
    "date": "2019-08-24T14:15:22Z",
    "length": 0,
    "technical_break_duration": 0,
    "capacity": 0,
    "comment": "string",
    "color": "string",
    "instructions": "string",
    "stream_link": "string",
    "force": false
  }'

Responses

Event updated successfully

Bodyapplication/json
dataobject

Updated event details (JSON:API format)

metaArray of objects
Response
application/json
{
  "data": {
    "type": "activity",
    "id": "10126531",
    "attributes": { … }
  },
  "meta": [
    {}
  ]
}

Delete Event (v2)

Request

Deletes an Event using v2 API.

Security
BearerPartnerUser
Path
location_idintegerrequired

Location (business) ID

event_idintegerrequired

Event ID

Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

curl -i -X DELETE \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/{location_id}/activities/{event_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>'

Responses

Event deleted successfully

Bodyapplication/json
Response
application/json
null

Tags

Client tagging system.

Operations