SKILL.md
iblai-api-agent-audit
Read an agent's audit log through the API: the who-changed-what trail for an agent, filterable by action code, actor email, and date range. Read-only — there are no writes. Use when investigating configuration changes to an agent.
Auth & conventions
- Base URL:
https://api.iblai.app - Header:
Authorization: Api-Token $IBLAIAPIKEYon every request. - Path vars:
{org}=$IBLAIORG,{username}=$IBLAIUSERNAME,
{mentor} = the agent's unique id (e.g. d17dc729-60fd-4363-81a0-f67d9318b03e).
- Not connected yet? Run
/iblai-api-loginfirst to populateIBLAI_ORG,
IBLAIUSERNAME, and IBLAIAPI_KEY.
Reads
- GET
https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/audit-logs/?limit=20&offset={n}&mentor={mentor}&action={code}&actoremail={e}&fromdate={d}&to_date={d}— audit entries. No writes.
This skill is read-only — it exposes no create, update, or delete endpoints.
Example
Read the first page of audit entries for an agent, filtered to a single actor within a date range:
curl -s \
"https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/audit-logs/?limit=20&offset=0&mentor=$MENTOR&[email protected]&from_date=2026-01-01&to_date=2026-06-12" \
-H "Authorization: Api-Token $IBLAI_API_KEY"Notes
- Paginate with
limitandoffset; the default page size shown here is20. action,actoremail,fromdate, andto_dateare optional filters —
omit any you don't need to narrow by.
fromdate/todatetake ISO dates (e.g.2026-06-12).- Read-only: investigating an audit trail never mutates agent state.