---
title: "Ask the installation's agent to do something"
method: POST
path: "/api/v1/app_installations/{id}/ask"
tags: ["Apps"]
---

# Ask the installation's agent to do something

`POST /api/v1/app_installations/{id}/ask`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/app_installations/{id}/ask`
- Auth: API key in header `api-key`

Delivered to the installation's agent as an app_action webhook over the standard agent rail (delivery id, retries), against the version this ask was made against (captured under the installation's own row lock, security fix item 5). 422 when the installation has no agent assigned, or (security fix item 3) a chat installation's agent has since left its chat. Does NOT support X-Salt-Act-For -- refused, by design, even under an otherwise-valid plugin.write grant (Mandates).

## Path parameters

- `id` string, required

## Request body

- object
  - `text` string, required
  - `data` object: ≤ 16 KB serialized.

## Response `200`

OK.

- object
  - `ok` boolean

## Other responses

- `401`: Missing or invalid credentials.
- `403`: Forbidden.
- `413`: That's too much data to send.
- `422`: This plugin has no agent to ask.

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)