aiAssignmentsCascadeProfileDelete
AiSuccessResponse aiAssignmentsCascadeProfileDelete(AiAssignmentsCascadeProfileDeleteRequest)
DELETE /api/2.0/ai/assignments/cascade-profile-delete
Cascade profile delete
Detaches a profile from every assignment that points at it, which is the cleanup step before the profile itself is removed. The Default slot is promoted to the first remaining profile, or dropped when none is left, and every other slot holding the profile is cleared. profileId is required and may be sent in the body or as a query parameter. DELETE api/2.0/ai/profiles/delete already does this, so call it directly only when the profile is being removed by some other means.
Parameters
| Name | In | Type | Description | Notes |
|---|---|---|---|---|
| AiAssignmentsCascadeProfileDeleteRequest | body | AiAssignmentsCascadeProfileDeleteRequest | The profile to detach from every assignment. May be sent as the profileId query parameter instead of in the body. | [required] |
Responses
| Status code | Description | Type | Response headers |
|---|---|---|---|
| 200 | Confirms no assignment points at the profile any more. | AiSuccessResponse | - |
| 400 | profileId is missing. | AiErrorResponse | - |
| 401 | Missing asc_auth_key cookie or Authorization header. | AiErrorResponse | - |
| 403 | AI is disabled for this portal, the caller is a guest, or the room named by entityId is one the caller cannot open. Relayed from the DocSpace AI service or the Files API. | AiErrorResponse | - |
| 413 | The request body is larger than 100 KB, the JSON parser's limit on this route. | AiErrorResponse | - |
| 500 | Unhandled failure. The reason is logged server-side and never echoed back. | AiErrorResponse | - |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json