Docs

Run an app action

Use an end-user token and installation ID to run an Embedded v1 app action.

Run a published app action with the credentials of one Embedded installation. This v1 endpoint uses an end-user token, not an API key.

curl -X POST 'https://connect.mindcloud.co/v1/installation/apps/<appId>/published/action/<actionId>/run' \
  -H 'Authorization: Bearer <END_USER_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "installationId": "<installationId>",
    "actionArguments": {}
  }'

The URL needs appId, appVersion, and actionId. Use published for the published app version. The body requires installationId; actionArguments is optional. MindCloud checks that the installation belongs to the authenticated end user and matches the app before it runs the action.

For new server-side integrations, see Run actions with an end user's connection. That guide uses the Universal API and your server-side API key.