Switch to an assigned Workspace | emnify Documentation

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>

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.

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

JWT authentication token valid for the target Workspace

Errors

401

Unauthorized Error

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.

An auth_token should be provided to authenticate a session.

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

This endpoint expects an object.

Successfully switched to the assigned Workspace

JWT authentication token valid for the target Workspace

$	curl -X POST https://cdn.emnify.net/api/v1/authenticate/workspace \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"target_organisation": {
>	"id": 23211
>	}
>	}'

$	curl -X POST https://cdn.emnify.net/api/v1/authenticate/workspace \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"target_organisation": {
>	"id": 23211
>	}
>	}'

1	{
2	"auth_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
3	}