Skip to content

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

API for iblai

Download OpenAPI description
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

core

Operations

credentials

Operations

credentials_orgs_users_assertions_retrieve_2

Request

Endpoint to retrieve and update a specific credential assertion.

This endpoint allows retrieving details of a specific credential assertion and updating its status (e.g., revoking it).

Path Parameters: org (str): The organization/tenant identifier user_id (str): The user ID making the request entity_id (str): The assertion entity ID

Methods: GET: Retrieve assertion details PUT: Update assertion status (e.g., revoke)

PUT Request Body: A JSON object containing:

  • revoked (bool): Set to true to revoke the assertion
  • revocationReason (str): Reason for revocation (required when revoking)

Returns: GET: A JSON response containing the assertion details using the AssertionSerializer format PUT: A JSON response containing the updated assertion using the AssertionSerializer format

Error Responses: 400 Bad Request: If the request data is invalid 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to access this resource 404 Not Found: If the assertion doesn't exist 500 Internal Server Error: If an unexpected error occurs

Security
PlatformApiKeyAuthentication
Path
entity_idstringrequired
orgstringrequired
user_idstringrequired
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/credentials/orgs/{org}/users/{user_id}/assertions/{entity_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
entityIdstringrequired
issuedOnstringrequired
credentialDetailsobjectread-onlyrequired
credentialDetails.​property name*stringadditional property
recipientobjectread-onlyrequired
recipient.​property name*stringadditional property
metadataany or null
courseobjectread-onlyrequired
course.​property name*stringadditional property
programobjectread-onlyrequired
program.​property name*stringadditional property
narrativestring or null
revokedboolean
revocationReasonstringrequired
acceptancestring(AcceptanceEnum)
  • Unaccepted - Unaccepted
  • Accepted - Accepted
  • Rejected - Rejected
Enum"Unaccepted""Accepted""Rejected"
expiresstringrequired
Response
application/json
{ "entityId": "string", "issuedOn": "string", "credentialDetails": { "property1": "string", "property2": "string" }, "recipient": { "property1": "string", "property2": "string" }, "metadata": null, "course": { "property1": "string", "property2": "string" }, "program": { "property1": "string", "property2": "string" }, "narrative": "string", "revoked": true, "revocationReason": "string", "acceptance": "Unaccepted", "expires": "string" }

credentials_orgs_users_assertions_update

Request

Endpoint to retrieve and update a specific credential assertion.

This endpoint allows retrieving details of a specific credential assertion and updating its status (e.g., revoking it).

Path Parameters: org (str): The organization/tenant identifier user_id (str): The user ID making the request entity_id (str): The assertion entity ID

Methods: GET: Retrieve assertion details PUT: Update assertion status (e.g., revoke)

PUT Request Body: A JSON object containing:

  • revoked (bool): Set to true to revoke the assertion
  • revocationReason (str): Reason for revocation (required when revoking)

Returns: GET: A JSON response containing the assertion details using the AssertionSerializer format PUT: A JSON response containing the updated assertion using the AssertionSerializer format

Error Responses: 400 Bad Request: If the request data is invalid 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to access this resource 404 Not Found: If the assertion doesn't exist 500 Internal Server Error: If an unexpected error occurs

Security
PlatformApiKeyAuthentication
Path
entity_idstringrequired
orgstringrequired
user_idstringrequired
Bodyrequired
entityIdstringrequired
issuedOnstringrequired
metadataany or null
narrativestring or null
revokedboolean
revocationReasonstringrequired
acceptancestring(AcceptanceEnum)
  • Unaccepted - Unaccepted
  • Accepted - Accepted
  • Rejected - Rejected
Enum"Unaccepted""Accepted""Rejected"
expiresstringrequired
curl -i -X PUT \
  'https://docs.ibl.ai/_mock/apis/ibl/api/credentials/orgs/{org}/users/{user_id}/assertions/{entity_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "entityId": "string",
    "issuedOn": "string",
    "metadata": null,
    "narrative": "string",
    "revoked": true,
    "revocationReason": "string",
    "acceptance": "Unaccepted",
    "expires": "string"
  }'

Responses

Bodyapplication/json
entityIdstringrequired
issuedOnstringrequired
credentialDetailsobjectread-onlyrequired
credentialDetails.​property name*stringadditional property
recipientobjectread-onlyrequired
recipient.​property name*stringadditional property
metadataany or null
courseobjectread-onlyrequired
course.​property name*stringadditional property
programobjectread-onlyrequired
program.​property name*stringadditional property
narrativestring or null
revokedboolean
revocationReasonstringrequired
acceptancestring(AcceptanceEnum)
  • Unaccepted - Unaccepted
  • Accepted - Accepted
  • Rejected - Rejected
Enum"Unaccepted""Accepted""Rejected"
expiresstringrequired
Response
application/json
{ "entityId": "string", "issuedOn": "string", "credentialDetails": { "property1": "string", "property2": "string" }, "recipient": { "property1": "string", "property2": "string" }, "metadata": null, "course": { "property1": "string", "property2": "string" }, "program": { "property1": "string", "property2": "string" }, "narrative": "string", "revoked": true, "revocationReason": "string", "acceptance": "Unaccepted", "expires": "string" }

credentials_orgs_users_assignments_destroy

Request

Delete a credential assignment using its entity_id. Only platform admins and department admins can delete assignments.

Security
PlatformApiKeyAuthentication
Path
assignment_idstringrequired
orgstringrequired
user_idstringrequired
curl -i -X DELETE \
  'https://docs.ibl.ai/_mock/apis/ibl/api/credentials/orgs/{org}/users/{user_id}/assignments/{assignment_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

No response body

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations