# Set allowlists

Source: https://immiscible.fly.dev/docs/api/put-api-w-wid-agents-aid-allowlists

`PUT /api/w/:wid/agents/:aid/allowlists`

`tools` is a list of `{ appId, tools }`; `models` a list of model ids, `provider/*` or `"*"`. `null` clears either.

## Authentication

Session cookie. A signed-in person: the console's session cookie. Every state-changing request also carries the header `x-immiscible-csrf: 1`, and the member's role decides what it may do. Bearer tokens are ignored on these routes, so no machine credential can reach them.

## Path parameters

- `wid` (string, required): Workspace id
- `aid` (string, required): Agent id

## Request

curl:

```bash
curl -X PUT "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/agents/agt_4f2c91a7/allowlists" \
  -H "cookie: __Host-sid=$IMMISCIBLE_SESSION" \
  -H "x-immiscible-csrf: 1" \
  -H "content-type: application/json" \
  -d '{
    "tools": [
      {
        "appId": "app_0c4d",
        "tools": [
          "list_issues",
          "create_pull_request"
        ]
      }
    ],
    "models": [
      "anthropic/claude-sonnet-5"
    ]
  }'
```

Node:

```ts
const res = await fetch('https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/agents/agt_4f2c91a7/allowlists', {
  method: 'PUT',
  headers: {
    cookie: `__Host-sid=${process.env.IMMISCIBLE_SESSION}`,
    'x-immiscible-csrf': '1',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    tools: [
      {
        appId: 'app_0c4d',
        tools: ['list_issues', 'create_pull_request'],
      },
    ],
    models: ['anthropic/claude-sonnet-5'],
  }),
});
const data = await res.json();
console.log(res.status, data);
```

Python:

```python
import os
import requests

res = requests.put(
    "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/agents/agt_4f2c91a7/allowlists",
    headers={
        "cookie": f"__Host-sid={os.environ['IMMISCIBLE_SESSION']}",
        "x-immiscible-csrf": "1",
        "content-type": "application/json",
    },
    json={
        "tools": [
            {
                "appId": "app_0c4d",
                "tools": ["list_issues", "create_pull_request"],
            },
        ],
        "models": ["anthropic/claude-sonnet-5"],
    },
)
print(res.status_code, res.json())
```