Skip to main content
PUT
/
api
/
public
/
coworkers
/
profiles
/
current
Switch Active Profile
curl --request PUT \
  --url https://spaces.nexudus.com/api/public/coworkers/profiles/current \
  --header 'Authorization: Basic <encoded-value>'
{
  "WasSuccessful": true,
  "Value": {},
  "Status": 123,
  "Message": {},
  "Errors": "<any>",
  "401 Unauthorized": {},
  "404 Not Found": {}
}

Documentation Index

Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

ContextSource file
Account switcher in the navigation dropdownsrc/components/NavBar/AccountDropdown.tsx
Virtual Office profile mismatch alertsrc/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.
MethodEndpointDescription
GET/api/public/coworkers/profilesList all profiles available to the current session
GET/api/public/coworkers/profiles/current/benefitsGet benefits for the currently active profile