Delete a User
DELETE/scim/v2/sso/:connection_name/Users/:id
Make a request to delete a user.
Permanently removes the user from the organization. This operation will also cascade delete all of the user's associated resources, including API keys and any other user-specific configurations. This action cannot be undone.
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 429
- 500
No Content
Response Headers
X-Request-Id
The unique identifier for the API request.
Bad Request
Response Headers
X-Request-Id
The unique identifier for the API request.
Unauthorized
Response Headers
X-Request-Id
The unique identifier for the API request.
WWW-Authenticate
The unique identifier for the API request.
Example:
Basic error="invalid_key", error_description="The API Key is invalid"Forbidden
Response Headers
X-Request-Id
The unique identifier for the API request.
Not Found
Response Headers
X-Request-Id
The unique identifier for the API request.
Rate Limit Exceeded
Response Headers
X-Request-Id
The unique identifier for the API request.
X-RateLimit-Limit
The maximum number of requests you're permitted to make per time period.
X-RateLimit-Remaining
The number of requests remaining in the current rate limit window.
X-RateLimit-Reset
The relative time in seconds until the current rate-limit window resets.
Important: This differs from Github and Twitter's same-named header which uses UTC epoch seconds. We use relative time to avoid client/server time synchronization issues.
Retry-After
The number of seconds to wait until the rate limit window resets. Only sent when the rate limit is reached.
Internal Server Error
Response Headers
X-Request-Id
The unique identifier for the API request.
OpenAPI definition (YAML)
paths:
/scim/v2/sso/{connection_name}/Users/{id}:
delete:
parameters:
- name: connection_name
in: path
required: true
schema:
type: string
description: The Connection Name
- name: id
in: path
required: true
schema:
type: string
description: The unique identifier for the users.
x-lifecycle-stage: General Availability
x-self-access: true
operationId: deleteScimV2User
description: '[](#section/Versioning/API-Lifecycle-Policy)
Make a request to delete a user.
Permanently removes the user from the organization. This operation will also cascade delete
all of the user''s associated resources, including API keys and any other user-specific configurations.
This action cannot be undone.
'
tags:
- Users (scim/v2)
security:
- cloud-api-key: []
- confluent-sts-access-token: []
responses:
'204':
description: No Content
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
'400':
description: Bad Request
x-minispec-transform-ignore: true
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/scim+json:
schema:
type: object
description: 'Standard SCIM error response format containing error details and status
information.
Returned when SCIM operations encounter validation errors or other issues.
'
properties:
schemas:
type: array
description: The SCIM schema for the error response.
items:
type: string
example: urn:ietf:params:scim:api:messages:2.0:Error
status:
type: string
description: The HTTP status code of the error response.
detail:
type: string
description: A human-readable description of the error.
title: scim.v2.Error
example:
schemas:
- urn:ietf:params:scim:api:messages:2.0:Error
status: '400'
detail: Bad Request
'401':
description: Unauthorized
x-minispec-transform-ignore: true
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
WWW-Authenticate:
schema:
type: string
description: The unique identifier for the API request.
example: Basic error="invalid_key", error_description="The API Key is invalid"
content:
application/scim+json:
schema:
type: object
description: 'Standard SCIM error response format containing error details and status
information.
Returned when SCIM operations encounter validation errors or other issues.
'
properties:
schemas:
type: array
description: The SCIM schema for the error response.
items:
type: string
example: urn:ietf:params:scim:api:messages:2.0:Error
status:
type: string
description: The HTTP status code of the error response.
detail:
type: string
description: A human-readable description of the error.
title: scim.v2.Error
example:
schemas:
- urn:ietf:params:scim:api:messages:2.0:Error
status: '401'
detail: Unauthorized
'403':
description: Forbidden
x-minispec-transform-ignore: true
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/scim+json:
schema:
type: object
description: 'Standard SCIM error response format containing error details and status
information.
Returned when SCIM operations encounter validation errors or other issues.
'
properties:
schemas:
type: array
description: The SCIM schema for the error response.
items:
type: string
example: urn:ietf:params:scim:api:messages:2.0:Error
status:
type: string
description: The HTTP status code of the error response.
detail:
type: string
description: A human-readable description of the error.
title: scim.v2.Error
example:
schemas:
- urn:ietf:params:scim:api:messages:2.0:Error
status: '403'
detail: Forbidden
'404':
description: Not Found
x-minispec-transform-ignore: true
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/scim+json:
schema:
type: object
description: 'Standard SCIM error response format containing error details and status
information.
Returned when SCIM operations encounter validation errors or other issues.
'
properties:
schemas:
type: array
description: The SCIM schema for the error response.
items:
type: string
example: urn:ietf:params:scim:api:messages:2.0:Error
status:
type: string
description: The HTTP status code of the error response.
detail:
type: string
description: A human-readable description of the error.
title: scim.v2.Error
example:
schemas:
- urn:ietf:params:scim:api:messages:2.0:Error
status: '404'
detail: Not Found
'429':
description: Rate Limit Exceeded
x-minispec-transform-ignore: true
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
X-RateLimit-Limit:
schema:
type: integer
description: The maximum number of requests you're permitted to make per time period.
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining in the current rate limit window.
X-RateLimit-Reset:
schema:
type: integer
description: "The relative time in seconds until the current rate-limit window resets. \
\ \n \n**Important:** This differs from Github and Twitter's same-named header which uses\
\ UTC epoch seconds. We use relative time to avoid client/server time synchronization\
\ issues."
Retry-After:
schema:
type: integer
description: The number of seconds to wait until the rate limit window resets. Only sent
when the rate limit is reached.
content:
application/scim+json:
schema:
type: object
description: 'Standard SCIM error response format containing error details and status
information.
Returned when SCIM operations encounter validation errors or other issues.
'
properties:
schemas:
type: array
description: The SCIM schema for the error response.
items:
type: string
example: urn:ietf:params:scim:api:messages:2.0:Error
status:
type: string
description: The HTTP status code of the error response.
detail:
type: string
description: A human-readable description of the error.
title: scim.v2.Error
example:
schemas:
- urn:ietf:params:scim:api:messages:2.0:Error
status: '429'
detail: Rate Limit Exceeded
'500':
description: Internal Server Error
x-minispec-transform-ignore: true
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/scim+json:
schema:
type: object
description: 'Standard SCIM error response format containing error details and status
information.
Returned when SCIM operations encounter validation errors or other issues.
'
properties:
schemas:
type: array
description: The SCIM schema for the error response.
items:
type: string
example: urn:ietf:params:scim:api:messages:2.0:Error
status:
type: string
description: The HTTP status code of the error response.
detail:
type: string
description: A human-readable description of the error.
title: scim.v2.Error
example:
schemas:
- urn:ietf:params:scim:api:messages:2.0:Error
status: '500'
detail: Internal Server Error
servers:
- url: https://api.confluent.cloud
description: Confluent Cloud API