workspaces

Switch to an assigned Workspace

<Info icon="fa-light fa-lock" className="permission-callout"> <div className="permission-callout__header"><span className="permission-callout__title"><span className="permission-callout__label">Required permissions</span> <span className="fern-docs-badge small blue subtle rounded-full permission-callout__beta">Beta</span></span> <span className="permission-callout__learn-more">[Learn more](/developers/api-guidelines/permissions#how-permissions-work)</span></div>

Authenticate.Workspace + Get

<div className="permission-callout__roles"><span className="permission-callout__roles-label">Roles:</span> <Badge intent="info">Administrator</Badge> <Badge intent="info">User</Badge> <Badge intent="info">Observer</Badge></div> </Info>

Switch to an assigned Workspace and receive an authentication token for the target Workspace.

<Note> This endpoint requires authentication with [user credentials](/developers/auth/user-credentials) (not an application token), as application tokens are scoped to a single Workspace.

The returned auth_token is valid for the target Workspace. Your original token remains valid for the source Workspace. </Note>

post/api/v1/authenticate/workspace

Request

  • Base URL: https://cdn.emnify.net
  • URL: https://cdn.emnify.net/api/v1/authenticate/workspace
  • Auth: HTTP bearer

Request body

Response

Successfully switched to the assigned Workspace

auth_tokenstring

JWT authentication token valid for the target Workspace

Changes

No recorded changes to this operation across all 1 revision of this API.