SKILL.md
iblai-api-invite
Manage an organization's user invitations via the API: list invites (accepted or pending) and send invitations one at a time or in bulk from CSV rows, with optional user-group assignment. Use when inviting users into an organization.
Auth & conventions
- Base URL:
https://api.iblai.app - Header:
Authorization: Api-Token $IBLAIAPIKEYon every request. - Path vars:
{org}=$IBLAIORG,{username}=$IBLAIUSERNAME. - The host is DM under
/api/catalog/invitations/…. - Not connected yet? Run
/iblai-api-loginfirst to populateIBLAI_ORG,
IBLAIUSERNAME, and IBLAIAPI_KEY.
Reads
- GET
…/invitations/platform/?platformkey={org}&page={n}&pagesize=5&sort=-id— list invites (accepted / pending).
Writes
- POST
…/invitations/platform/— send an invite (call once per CSV row for bulk):
``json { "email": "string", "platformkey": "string (required)", "redirectto": "uri", "source": "username", "active": true, "companyname": "string (CSV)", "firstname": "string (CSV)", "lastname": "string (CSV)", "usergroup": "string (CSV)", "usergroupowner_email": "email (CSV)" } ``
Example
Send a single invite to a new user, redirecting them to the organization after they accept:
curl -X POST \
"https://api.iblai.app/dm/api/catalog/invitations/platform/" \
-H "Authorization: Api-Token $IBLAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"platform_key": "'"$IBLAI_ORG"'",
"redirect_to": "https://login.iblai.app/me",
"source": "'"$IBLAI_USERNAME"'",
"active": true
}'
Notes
- Sending invites emails real people — confirm the recipient list with the user
before posting, especially on bulk runs that POST once per row.
- The CSV-only fields (
companyname,firstname,lastname,usergroup,
usergroupowneremail) come from the bulk CSV columns; set usergroup / usergroupowner_email to assign the invitee to a group.
- The list is paginated — page through with
page/page_sizeand
sort=-id to see the newest invites first.