iblai-api-agent-setting

Read and write an agent's core settings: identity (name, description, category, profile image), discovery/visibility, and capability flags (anonymous, featured, LTI, attachments, voice, memory, multi-query RAG, forkable) — all of which save through the single settings/ endpoint — plus forking (copy) and deletion. Use when configuring an agent's basic identity and capabilities.

Auth & conventions

• Base URL: https://api.iblai.app
• Header: Authorization: Api-Token $IBLAIAPIKEY on every request.
• Path vars: {org} = $IBLAIORG, {username} = $IBLAIUSERNAME,

{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/ with multipart/form-data — sending only the changed field(s).

• Not connected yet? Run /iblai-api-login first to populate IBLAI_ORG,

IBLAIUSERNAME, and IBLAIAPI_KEY.

Reads

• GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentor/categories/ — category options.
• GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/settings/ — load all current field values.
• GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/mentors/{mentor}/claw-config/ — detect sandbox wiring (404 = not connected).

Writes

• PUT …/users/{username}/mentors/{mentor}/settings/ — update settings (multipart/form-data, send only changed keys):

``json { "mentorname": "string", "mentordescription": "string", "categories": "number[]", "uploadedprofileimage": "File", "mentorvisibility": "string", "allowanonymous": "boolean", "isfeatured": "boolean", "isltiaccessible": "boolean", "showattachment": "boolean", "showvoicecall": "boolean", "showvoicerecord": "boolean", "enableclaw": "boolean", "enablememorycomponent": "boolean", "enablemultiqueryrag": "boolean", "forkable": "boolean" } ``

• POST …/users/{username}/mentors/{mentor}/fork/ — copy / duplicate agent:

``json { "newmentorname": "string (required)", "destinationplatformkey": "string (required)", "clone_documents": "boolean" } ``

• DELETE https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/{mentor}/ — delete agent (user-scoped path; no body). Destructive — confirm with the user first.

Example

Rename an agent and make it featured (only the two changed fields are sent):

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" \
  -F "mentor_name=Joseph (Prod)" \
  -F "is_featured=true"

Notes

• A field left out of the PUT is left unchanged — never resend the whole object.
• categories expects numeric category ids from the categories endpoint, not names.
• Deletion and forking are scoped to {username}; settings reads/writes use the

users/{username}/mentors/{mentor}/ path.