Skip to content
API Reference
/
catalog
/
catalog_invitations_platform_bulk_create

ibl-data-manager (3.59.0-ai-plus)

API for iblai

Download OpenAPI description
ibl.json
ibl.yaml
Languages
Servers
Mock server

https://docs.ibl.ai/_mock/apis/ibl/

https://base.manager.iblai.app/

ai-account

Operations

ai-analytics

Operations

ai-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

career

Operations

catalog

Operations

catalog_invitations_platform_blank_create

Request

Create multiple blank platform invitations

Security
PlatformApiKeyAuthentication
Body
required
platform_keystringrequired

The platform to create invitations for

sourcestringrequired

The source identifier for the invitations

countintegerrequired

The number of blank invitations to create

metadataobject

Additional metadata for the invitations

curl -i -X POST \
  https://docs.ibl.ai/_mock/apis/ibl/api/catalog/invitations/platform/blank/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform_key": "string",
    "source": "string",
    "count": 0,
    "metadata": {
      "property1": null,
      "property2": null
    }
  }'

Responses

Bodyapplication/json
successesintegerrequired

Number of successfully created invitations

error_codesArray of stringsrequired

List of error codes for failed invitations

Response
application/json
{
  "successes": 0,
  "error_codes": [
    "string"
  ]
}

catalog_invitations_platform_bulk_create

Request

API View for bulk creating platform invitations.

This endpoint allows creating multiple platform invitations in a single request.

Request Parameters: invitation_data (list, required): List of invitation data objects, each containing: platform_key (str, required): The platform to create an invitation for email (str, required): The email address to invite active (bool, optional): Whether the invitation is active metadata fields: Any additional parameters will be added as metadata platform_key (str, required for platform admins): The platform key for permission validation

Methods: POST: Create multiple platform invitations

Returns: POST: A JSON response containing the creation results: { "successes": 5, "error_codes": [] }

Error Responses: 400 Bad Request: If required parameters are missing or invalid 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to access this resource 500 Internal Server Error: If an unexpected error occurs during creation

Access Control:

  • Requires IsDMAdmin or IsPlatformAdmin permission
  • Available to platform administrators and DM admins
Security
PlatformApiKeyAuthentication
Body
required
invitation_dataArray of objects(PlatformInvitationCreate)required

List of invitation data objects

invitation_data[].​platform_keystringrequired

The platform to create an invitation for

invitation_data[].​emailstring(email)

The email address to invite

invitation_data[].​usernamestring

The username to invite

invitation_data[].​activeboolean

Whether the invitation is active

Default true
invitation_data[].​sourcestring

The source of the invitation

invitation_data[].​redirect_tostring(uri)

URL to redirect to after accepting the invitation

invitation_data[].​createdstring(date-time)

When the invitation was created

invitation_data[].​expiredstring(date-time)

When the invitation expires

invitation_data[].​metadataobject

Additional metadata for the invitation

platform_keystring

The platform key for permission validation

curl -i -X POST \
  https://docs.ibl.ai/_mock/apis/ibl/api/catalog/invitations/platform/bulk/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "invitation_data": [
      {
        "platform_key": "string",
        "email": "user@example.com",
        "username": "string",
        "active": true,
        "source": "string",
        "redirect_to": "http://example.com",
        "created": "2019-08-24T14:15:22Z",
        "expired": "2019-08-24T14:15:22Z",
        "metadata": {
          "property1": null,
          "property2": null
        }
      }
    ],
    "platform_key": "string"
  }'

Responses

Bodyapplication/json
successesintegerrequired

Number of successfully created invitations

error_codesArray of stringsrequired

List of error codes for failed invitations

Response
application/json
{
  "successes": 0,
  "error_codes": [
    "string"
  ]
}

catalog_invitations_platform_check_retrieve

Request

Check if a user has an active platform invitation

Query
emailstring(email)non-emptyrequired

The email address to check for active invitations

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/catalog/invitations/platform/check/?email=user%40example.com'

Responses

Active invitation exists for the email

core

Operations

credentials

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations
Copyright © ibl.ai | support@iblai.zendesk.com