iblai-api-agent-disclaimerlisted
Install: claude install-skill iblai/api
# iblai-api-agent-disclaimer
Manage an agent's disclaimers via the API: the Advisory text (a single field on
the agent's `settings/`) and the User Agreement (its own create / update /
activate lifecycle). Use when adding legal or advisory notices users must see or
accept.
## Auth & conventions
- **Base URL:** `https://api.iblai.app`
- **Header:** `Authorization: Api-Token $IBLAI_API_KEY` on every request.
- **Path vars:** `{org}` = `$IBLAI_ORG`, `{username}` = `$IBLAI_USERNAME`,
`{mentor}` = the agent's unique id (e.g. `d17dc729-60fd-4363-81a0-f67d9318b03e`).
- Not connected yet? Run **`/iblai-api-login`** first to populate `IBLAI_ORG`,
`IBLAI_USERNAME`, and `IBLAI_API_KEY`.
## Reads
- **GET** `https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/settings/` — Advisory text lives in the `disclaimer` field.
- **GET** `https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/disclaimers/?mentor_id={mentor}&scope=mentor` — User Agreement list (read `results[0]` for the active agreement).
## Writes
- **PUT** `…/users/{username}/mentors/{mentor}/settings/` — save **Advisory** text:
```json
{
"disclaimer": "string"
}
```
- **POST** `…/users/{username}/disclaimers/` — create a **User Agreement**:
```json
{
"content": "string (required)",
"mentors": ["uuid"],
"scope": "mentor",
"active": "boolean"
}
```
- **PATCH** `…/users/{username}/disclaimers/{id}/` — update content or toggle activation:
```j