Delete user by ID

DELETE 
/scim/v2/Users/:id

Initiates deletion of a user account by their encrypted account ID.

Required Permissions: deleteSCIMUser

The deletion process can take up to 30 minutes to complete.

The user is automatically removed from any employer organizations.

Request

Path Parameters

id stringrequired

Encrypted account key of the user to delete.

Responses

204

User deletion initiated successfully

400

Bad Request - Invalid request format or parameters

application/scim+json

Schema

Schema

schemas string[]required
status stringrequired

HTTP status code as string.

scimType string

Possible values: [invalidFilter, tooMany, uniqueness, mutability, invalidSyntax, invalidPath, noTarget, invalidValue, invalidVers, sensitive]

SCIM error type.

detail string

Human-readable error description.

Example (from schema)

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidFilter",
  "detail": "Invalid filter: No filter provided"
}

invalidFilter

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidFilter",
  "detail": "Invalid filter: No filter provided"
}

invalidUser

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidValue",
  "detail": "Invalid SCIM user data"
}

401

Unauthorized - Invalid or missing authentication

application/scim+json

Schema

Schema

schemas string[]required
status stringrequired

HTTP status code as string.

scimType string

Possible values: [invalidFilter, tooMany, uniqueness, mutability, invalidSyntax, invalidPath, noTarget, invalidValue, invalidVers, sensitive]

SCIM error type.

detail string

Human-readable error description.

Example (from schema)

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidFilter",
  "detail": "Invalid filter: No filter provided"
}

Example

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "401",
  "detail": "Authentication required"
}

403

Forbidden - Insufficient permissions

application/scim+json

Schema

Schema

schemas string[]required
status stringrequired

HTTP status code as string.

scimType string

Possible values: [invalidFilter, tooMany, uniqueness, mutability, invalidSyntax, invalidPath, noTarget, invalidValue, invalidVers, sensitive]

SCIM error type.

detail string

Human-readable error description.

Example (from schema)

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidFilter",
  "detail": "Invalid filter: No filter provided"
}

Example

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "403",
  "detail": "Insufficient permissions"
}

404

Not Found - Resource does not exist

application/scim+json

Schema

Schema

schemas string[]required
status stringrequired

HTTP status code as string.

scimType string

Possible values: [invalidFilter, tooMany, uniqueness, mutability, invalidSyntax, invalidPath, noTarget, invalidValue, invalidVers, sensitive]

SCIM error type.

detail string

Human-readable error description.

Example (from schema)

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidFilter",
  "detail": "Invalid filter: No filter provided"
}

Example

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "404",
  "detail": "User not found"
}

500

Internal Server Error

application/scim+json

Schema

Schema

schemas string[]required
status stringrequired

HTTP status code as string.

scimType string

Possible values: [invalidFilter, tooMany, uniqueness, mutability, invalidSyntax, invalidPath, noTarget, invalidValue, invalidVers, sensitive]

SCIM error type.

detail string

Human-readable error description.

Example (from schema)

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "400",
  "scimType": "invalidFilter",
  "detail": "Invalid filter: No filter provided"
}

Example

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "500",
  "detail": "An unexpected error occurred"
}

Loading...

 

Was this page helpful?