Switch to an assigned Workspace | emnify Documentation

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

This endpoint requires authentication with 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.

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>

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Request

This endpoint expects an object.

target_organisationobjectRequired

Response

Successfully switched to the assigned Workspace

auth_tokenstring or null

JWT authentication token valid for the target Workspace

1	curl -X POST https://cdn.emnify.net/api/v1/authenticate/workspace \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"target_organisation": {
6	"id": 23211
7	}
8	}'

Authentication

Request

Response

Errors