POST /auth/clientToken

Description

Post the desired Installation ID and Workspace Key to receive a Client Access Data Token. This token expires in 1 hour and should be cached to make API calls.

Overview

An Organization or Campaign must provide their Workspace ID and Workspace Key to you. The Workspace ID and Workspace Key are displayed when a user installs your Application in their Workspace, and can be verified using the data in apps/me/installations endpoint.

Required Parameters

"tokenType"- Default is appInstallation.

installationId - the ID of the installation that corresponds with the Workspace ID and Workspace Key you're requesting a client-scoped token for.

WorkspaceKey - the Workspace Key associated with the Workspace that you're requesting a client-scoped token for.

"permissions"- Reserved - By default, this must be an empty array.

URL structure

https://app.movementinfrastructure.org/api/v1//auth/clientToken

Examples

{"tokenType": "appInstallation", "installationId": 1235643, "workspaceKey": "aaaa", "permissions": []}

{
    tokenType: "Bearer",
    expiresAt: "2024-08-22T01:18:11.469141",
    token: "345e234x2303a5exampleerba1h1t2"
}