iblai-api-agent-tool

Mirrored from iblai/vibe · skills/agents/iblai-api-agent-tool/SKILL.md. This page is generated — edit it in the repository, not here.

Enable or disable an agent's tools via the API: list the tools an agent can toggle, read which tool slugs are currently enabled, and write the enabled set back through the agent settings/ endpoint. Use when controlling which tools an agent can use.

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).
Tool writes go through the agent settings endpoint — PUT …/users/{username}/mentors/{mentor}/settings/ — sending the tool slug set.
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}/available-tools/ — toggleable tools. Each row has slug (the value tool_slugs takes), display_name, description, category, and is_allowed.
GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/settings/ — currently enabled tools, as mentor_tools[] (read each slug).

Writes

PUT https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/settings/ — enable/disable tools:
```
{
  "tool_slugs": "string[]",
  "can_use_tools": "boolean"
}
```

Example

Enable web search and the code interpreter for an agent:

curl -X PUT \
  "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/$MENTOR/settings/" \
  -H "Authorization: Api-Token $IBLAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool_slugs": ["web-search", "code-interpreter"], "can_use_tools": true}'

Notes

tool_slugs is the full enabled set — slugs left out of the array are disabled.
Pull valid slugs from the available-tools/ endpoint before writing (live examples: web-search, code-interpreter, deep-research, mcp, screen-share).
can_use_tools: false turns tools off and clears the enabled set; turning them back on restores nothing, so send the full tool_slugs with can_use_tools: true.