iblai-api-agent-promptlisted
Install: claude install-skill iblai/api
# iblai-api-agent-prompt
Manage an agent's prompts via the API: the built-in system / proactive / study /
guided prompts and greeting settings (all saved through the single `settings/`
endpoint), plus full create/update/delete on the agent's suggested prompts. Use
when editing what an agent says and suggests.
## 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`).
- **Settings writes** go through one endpoint —
**PUT** `…/users/{username}/mentors/{mentor}/settings/` — sending **only the
changed field(s)**.
- Not connected yet? Run **`/iblai-api-login`** first to populate `IBLAI_ORG`,
`IBLAI_USERNAME`, and `IBLAI_API_KEY`.
## Reads
- **GET** `…/users/{username}/mentors/{mentor}/settings/` — system / proactive / study / guided prompt text, `greeting_method`, `enable_guided_prompts`.
- **GET** `https://api.iblai.app/dm/api/search/orgs/{org}/users/{username}/prompts/?mentor={mentor}&limit=6&offset={n}&order_direction=asc` — list suggested prompts.
- **GET** `https://api.iblai.app/dm/api/ai-prompt/orgs/{org}/users/{username}/prompts/category/` — prompt categories.
## Writes
- **PUT** `…/mentors/{mentor}/settings/` — update a built-in prompt (send one key):
```json
{
"system_prompt": "string",
"proactive_prompt": "string",