Skip to content
/
Delete Position (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

Update Position (v2)

Request

Update an existing staff position. Title and salon_ids are required in the request body.

Security
BearerPartnerUser
Path
company_idintegerrequired

Company (location) ID

position_idintegerrequired

Position ID

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

Bearer {partner_token}, User {user_token}

Bodyapplication/jsonrequired
position_idintegerrequired

Position ID (must match path parameter)

Example: 42
titlestring[ 1 .. 100 ] charactersrequired

Position name

Example: "Senior Stylist Updated"
salon_idsArray of integersnon-emptyrequired

IDs of salons where this position is available

Example: [1,2,3,4]
descriptionstring<= 1000 characters

Position description (optional)

Example: "Updated description"
curl -i -X PUT \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/companies/{company_id}/positions/{position_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "position_id": 42,
    "title": "Senior Stylist Updated",
    "description": "Updated description",
    "salon_ids": [
      1,
      2,
      3,
      4
    ]
  }'

Responses

Position updated successfully (no content)

Response
No content

Delete Position (v2)

Request

Delete a staff position.

Security
BearerPartnerUser
Path
company_idintegerrequired

Company (location) ID

position_idintegerrequired

Position 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/{company_id}/positions/{position_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>'

Responses

Position deleted successfully (no content)

Response
No content

Events

Group events (activities) management.

Operations

Tags

Client tagging system.

Operations