---
title: "ask: local"
description: "a question in one of the ask tools' owning types, over the files the app may read to the card, answered by the app's own engine over its tenant's files, with the same foot"
section: reference
address: /reference/ask/local
contract: 0476e35e6e275db5
---
# ask: local
a question in one of the ask tools' owning types, over the files the app may read to the card, answered by the app's own engine over its tenant's files, with the same foot
[figure: The caller sends LocalInput to /v1/ask/local. The platform returns a card whose body is Card.]
POST/v1/ask/local
From the local server's own. The call needs the strategy rung under a token with the ask grant, and it is served by the installed app.
The route takes [LocalInput](/concepts/localinput) and returns a card whose body is [Card](/concepts/card).
## Request body
The request body is [LocalInput](/concepts/localinput).
| field | type | required | note |
|---|---|---|---|
| `tool` | `text` | yes | an ask tool |
| `input` | `json` | yes | the serialisation of that tool's input |
## Response
The route returns a card whose body is [Card](/concepts/card). Every card ends with a foot that states the basis of each number, the scope of the call, and the time when the facts were true.
## Headers
| header | required | meaning |
|---|---|---|
| `Scale-Scope` | yes | the scope the call runs in: tenant/, then /brand/, then /strategy/ |
| `Scale-As-True-On` | no | the date the facts must have been true on; defaults to now |
| `Scale-As-Known-On` | no | the date the facts must have been known on; defaults to now |
| `Scale-Key` | no | for a change, the key made from the input; a repeat under the same key returns the unit held and writes nothing |
A caller needs the strategy rung and a token with the ask grant. The desktop app serves this route.
## Example
The example sends the smallest body that LocalInput allows. The build validates it against the schema of LocalInput.
Example
```sh
curl -X POST https://api.scaleintelligence.co/v1/ask/local \
-H "Scale-Key: $SCALE_KEY" -H "Scale-Scope: tenant/" \
-H "content-type: application/json" \
-d '{ "tool": "…", "input": null }'
```
```typescript
import { client } from "@scale/sdk";
const answer = await client.ask.local({
"tool": "…",
"input": null
});
// answer.body is a Card. answer.foot holds the basis, the scope and the time.
```
```python
import requests
answer = requests.post("https://api.scaleintelligence.co/v1/ask/local",
headers={"Scale-Key": KEY, "Scale-Scope": "tenant/"},
json={
"tool": "…",
"input": null
}).json()
```
```rust
let answer: Card = client.post("https://api.scaleintelligence.co/v1/ask/local")
.header("Scale-Key", key).header("Scale-Scope", "tenant/")
.json(&LocalInput { /* the fields of the page */ }).send().await?.json().await?;
```