DELETE /experience/assignments/{assignmentId}

Remove an Experience Assignment

Remove an Experience assignment from a target

Deletion is permanent. Returns 204 No Content. The delete is a hard delete — immediate, with no recovery. The spec does not state this explicitly, so confirm with Alianza before relying on it in a destructive flow. If your integration needs an audit trail of removed assignments, capture the deletion event on your side.

Authentication

OAuth 2.0. Required scope(s): experience-assignments:manage.

Request

Path parameters

Name Type Required Description
assignmentId string (uuid) yes ID of the Experience Assignment

Query parameters

None.

Headers

None.

Responses

204 — Experience Assignment removed successfully

401 — Unauthorized - Missing or expired access token. Obtain a new token and retry.

Content-Type: application/problem+json

Schema: ProblemDetails

Example:

{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Access token is missing or has expired",
  "traceId": "6d4a3a62-0d4b-4b96-9171-8c5070e01c35"
}

403 — Forbidden - Experience Assignment exists, the authenticated user has authorization to read but no authorization to delete the Experience Assignment

Content-Type: application/problem+json

Schema: ProblemDetails

Example:

{
  "title": "Forbidden",
  "status": 403,
  "detail": "The authenticated user does not have authorization to delete this Experience Assignment",
  "traceId": "6d4a3a62-0d4b-4b96-9171-8c5070e01c35"
}

404 — Not Found - Experience Assignment does not exist, already deleted, or the authenticated user does not have authorization to access the Experience Assignment

Content-Type: application/problem+json

Schema: ProblemDetails

Example:

{
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested Experience Assignment does not exist or has already been deleted",
  "traceId": "6d4a3a62-0d4b-4b96-9171-8c5070e01c35"
}

Errors

This operation may return:

  • 401 — Unauthorized - Missing or expired access token. Obtain a new token and retry.
  • 403 — Forbidden - Experience Assignment exists, the authenticated user has authorization to read but no authorization to delete the Experience Assignment
  • 404 — Not Found - Experience Assignment does not exist, already deleted, or the authenticated user does not have authorization to access the Experience Assignment

See Errors reference for the full catalogue.