Switch Active Profile

Switch the active customer profile for the current session to a different profile owned by the same user account.

PUT /api/public/coworkers/profiles/current

Switch Active Profile

cURL

curl --request PUT \
  --url https://spaces.nexudus.com/api/public/coworkers/profiles/current \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "WasSuccessful": true,
  "Value": {},
  "Status": 123,
  "Message": {},
  "Errors": "<any>",
  "401 Unauthorized": {},
  "404 Not Found": {}
}

Switch Active Profile

Changes the active customer profile for the current session. A single user account can have multiple customer profiles (individual, company, or profiles at different locations). This endpoint sets the specified profile as the default, so subsequent authenticated requests operate in that profile’s context.

Authentication

Requires a valid customer bearer token.

Query Parameters

coworkerId · number · required

The numeric identifier of the profile to switch to. Obtain valid profile IDs from GET /api/public/coworkers/profiles — use a Profiles[].Id value where Profiles[].Active is true.

Response

The portal typically discards the response body and re-fetches GET /api/public/coworkers/profiles after a successful switch to update the session state.

Returns an ActionConfirmation envelope.

WasSuccessful · boolean

true when the profile was switched successfully.

Value · string | null

Usually null on success.

Status · number

HTTP-style status code mirrored in the body. 200 on success.

Message · string | null

Human-readable message. Usually null on success.

Errors · any

Validation errors. null on success.

Example Response

{
  "WasSuccessful": true,
  "Value": null,
  "Status": 200,
  "Message": null,
  "Errors": null
}

TypeScript Integration

import endpoints from '@/api/endpoints'

await httpClient.put(endpoints.coworkers.setCurrentProfile(coworkerId))

// Re-fetch profiles to update UI
await refetchProfiles()

Usage in Portal

Context	Source file
Account switcher in the navigation dropdown	src/components/NavBar/AccountDropdown.tsx
Virtual Office profile mismatch alert	src/views/virtual-offices/components/VirtualOfficeProfileMismatchAlert.tsx

Error Responses

401 Unauthorized · error

The bearer token is missing, expired, or invalid.

404 Not Found · error

No profile with the given coworkerId exists or it does not belong to this user account.

Related Endpoints

Method	Endpoint	Description
GET	/api/public/coworkers/profiles	List all profiles available to the current session
GET	/api/public/coworkers/profiles/current/benefits	Get benefits for the currently active profile