Skip to content
/
Create Position

Create Position

Request

Create a Position for Team Members at the specified Location.

Security
BearerPartnerUser
Path
company_idintegerrequired

Location ID

Headers
Acceptstringrequired

Required B2B v2 response media type. Use application/vnd.api.v2+json. A charset parameter is also accepted.

Default:"application/vnd.api.v2+json"
Example:application/vnd.api.v2+json
Content-Typestringrequired

Request media type

Value:"application/json"
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

Bodyapplication/jsonrequired
titlestring, [ 1 .. 100 ] charactersrequired

Position title

descriptionstring, <= 1000 characters

Position description

curl -i -X POST \
  'https://developer.alteg.io/_mock/en/b2b-v2/openapi/locations/{company_id}/positions' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Senior Stylist",
    "description": "Senior hair stylist with color specialization"
  }'

Responses

Position created successfully

Bodyapplication/json
dataobject(Position Resource)required
metaArray of objectsrequired
Response
{
  "data": {
    "type": "position",
    "id": "42",
    "attributes": { … }
  },
  "meta": []
}