Skip to main content
POST
/
saas
/
{saasId}
/
deprovision
Deprovision a SaaS identity
curl --request POST \
  --url https://api.getprimo.com/saas/{saasId}/deprovision \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identityId": "<string>"
}
'
{}

Documentation Index

Fetch the complete documentation index at: https://docs.getprimo.com/llms.txt

Use this file to discover all available pages before exploring further.

Key: Write Scope: Company

Authorizations

​
Authorization
string
header
required

Use your Primo API key in the Authorization header as Bearer <API_KEY>.

Path Parameters

​
saasId
string
required

Body

application/json
​
identityId
string
required

The ID of the identity to deprovision. Retrieve it from getSaasById → identities[].id.

Minimum string length: 1

Response

default - application/json
​
provisioningType
enum<string>
required

Whether the deprovisioning was handled automatically via API or a manual ticket was created.

Available options:
automatic,
manual