Skip to main content
POST
Deprovision a SaaS identity
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
deprovisioningStrategy
object

Read only for an application that offers several deprovisioning actions (an identity provider such as Google Workspace or Microsoft Entra). Left out there, the action the company set for that application in its offboarding settings applies; with none set, the call answers 400 and names the available actions.

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