Skip to content
API reference
/
User management
/
/
Update user roles

User Management API (v2)

Download OpenAPI description
UsersApi.json
UsersApi.yaml
Languages
Servers
Staging URL
https://apis.spotnana.com/
Spotnana mock server
https://developer.spotnana.com/_mock/openapi/usersapi/

Users

APIs to onboard and manage users.

Operations

Update user membership info

Request

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
membershipInfosArray of objects(LoyaltyInfo)
isLoyaltyBlockedboolean

Whether user is blocked to use loyalty programs. This is a read only field.

Example: false
curl -i -X PUT \
  https://apis.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/membership-info \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "membershipInfos": [
      {
        "appliedTo": [
          "TAJ"
        ],
        "id": "firstId",
        "issuedBy": "firstIssuedBy",
        "type": "AIR",
        "linked": false
      }
    ],
    "isLoyaltyBlocked": false
  }'

Responses

No Content

Response
No content

Update user roles

Request

This endpoint updates user roles.

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
rolesArray of objects(RoleConfig)required
roles[].​roleTypestring(RoleTypeEnum)
Enum"COMPANY_ADMIN""COMPANY_TRAVEL_ARRANGER""TRAVEL_ARRANGER""COMPANY_REPORT_ADMIN""TMC_ADMIN""TMC_AGENT""GLOBAL_ADMIN""GLOBAL_AGENT"
roles[].​metadataTravelArrangerMetadataV2 (object) or CompanyRoleInfo (object) or TmcRoleInfo (object)(RoleMetadataV2)
One of:
roles[].​roleMetadataobject(RoleMeta)Deprecated
curl -i -X PUT \
  https://apis.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/roles \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "roles": [
      {
        "roleType": "COMPANY_ADMIN",
        "roleMetadata": {
          "travelArrangerMetadata": {
            "arrangerFor": [
              {
                "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
                "sendConfirmationEmail": false,
                "sendFlightStatsNotificationEmail": false
              }
            ]
          }
        },
        "metadata": {
          "roleType": "TRAVEL_ARRANGER",
          "arrangerFor": [
            {
              "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
              "sendConfirmationEmail": false,
              "sendFlightStatsNotificationEmail": false
            }
          ]
        }
      }
    ]
  }'

Responses

No Content

Response
No content

Get user roles

Request

This endpoint gets user roles.

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
curl -i -X GET \
  https://apis.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/roles \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
rolesArray of objects(RoleConfig)required
roles[].​roleTypestring(RoleTypeEnum)
Enum"COMPANY_ADMIN""COMPANY_TRAVEL_ARRANGER""TRAVEL_ARRANGER""COMPANY_REPORT_ADMIN""TMC_ADMIN""TMC_AGENT""GLOBAL_ADMIN""GLOBAL_AGENT"
roles[].​metadataTravelArrangerMetadataV2 (object) or CompanyRoleInfo (object) or TmcRoleInfo (object)(RoleMetadataV2)
One of:
roles[].​roleMetadataobject(RoleMeta)Deprecated
Response
application/json
{
  "roles": [
    { … }
  ]
}
Copyright © 2025 Spotnana Technology, Inc.