> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Act in your users' apps

> Search a user's inbox, read a Notion page or post to Slack, as the user.

Once a user has connected an app, your app can run that app's actions as the user.

## See what is possible

```bash theme={"system"}
curl "https://api.constella.app/platform/v1/users/u_123/actions?app=gmail&timezone=America/Los_Angeles" \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY"
```

You get `connected`, `can_connect`, and `actions`: each with a `name`, a `description`, its `input_schema`, and `reads_only`.

## Run one

```bash theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/actions/run \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "gmail_search", "arguments": {"query": "from:alex pricing"}, "timezone": "America/Los_Angeles"}'
```

> [!WARNING]
>
> By default only reading actions run (`"reads_only": true`). Send `"reads_only": false` to run actions that send, change or delete things, and only after the user said yes in your app.

## From an AI model

Hand your model [apps\_list](/dev/docs/api-reference/tools/apps-list.md) and [apps\_run](/dev/docs/api-reference/tools/apps-run.md) as tools, through the [tool routes](/dev/docs/build/app-users.md). `apps_run` asks first: see [Tools that ask first](/dev/docs/concepts/asks-first.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.