Skip to content

Deprovision a user

DELETE
/scim/v2/Users/{id}
curl --request DELETE \
--url https://beta-api.plune.ai/scim/v2/Users/example \
--header 'Authorization: Bearer <token>'

What active: false does, then the link goes: the id is a 404 for every operation after and the user is in no search (RFC 7644 §3.6). The account stays; a new POST of the address makes a new link. 300 a minute a company. A company without Enterprise in active or grace is refused 403 enterprise_required; it loses nothing and nobody is switched off.

id
required
string

The SCIM id Plune gave the user.

Deleted

The company owner (mutability)

Media type application/scim+json

RFC 7644 §3.12. Never repeats the request, its token or a value it carried.

object
schemas
required
Array<string>
Allowed values: urn:ietf:params:scim:api:messages:2.0:Error
status
required
string
scimType
string
Allowed values: invalidFilter uniqueness mutability invalidSyntax invalidValue
detail
required
string
code

Plune’s word, on the 403 of a company without Enterprise.

string
Allowed values: enterprise_required
Example
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": "409",
"scimType": "invalidFilter",
"code": "enterprise_required"
}

No SCIM token

Media type application/scim+json

RFC 7644 §3.12. Never repeats the request, its token or a value it carried.

object
schemas
required
Array<string>
Allowed values: urn:ietf:params:scim:api:messages:2.0:Error
status
required
string
scimType
string
Allowed values: invalidFilter uniqueness mutability invalidSyntax invalidValue
detail
required
string
code

Plune’s word, on the 403 of a company without Enterprise.

string
Allowed values: enterprise_required
Example
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": "409",
"scimType": "invalidFilter",
"code": "enterprise_required"
}

No Enterprise

Media type application/scim+json

RFC 7644 §3.12. Never repeats the request, its token or a value it carried.

object
schemas
required
Array<string>
Allowed values: urn:ietf:params:scim:api:messages:2.0:Error
status
required
string
scimType
string
Allowed values: invalidFilter uniqueness mutability invalidSyntax invalidValue
detail
required
string
code

Plune’s word, on the 403 of a company without Enterprise.

string
Allowed values: enterprise_required
Example
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": "409",
"scimType": "invalidFilter",
"code": "enterprise_required"
}

No such user

Media type application/scim+json

RFC 7644 §3.12. Never repeats the request, its token or a value it carried.

object
schemas
required
Array<string>
Allowed values: urn:ietf:params:scim:api:messages:2.0:Error
status
required
string
scimType
string
Allowed values: invalidFilter uniqueness mutability invalidSyntax invalidValue
detail
required
string
code

Plune’s word, on the 403 of a company without Enterprise.

string
Allowed values: enterprise_required
Example
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": "409",
"scimType": "invalidFilter",
"code": "enterprise_required"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over