Skip to content
Skip to main content
DELETE
https://api.us.nylas.com/v3/iam/principals/{principal_id}

Delete IAM principal

Permanently deletes a principal and all of its API keys.

You can't delete the last active Organization-bound IAM Admin. The response contains only request_id.

Requires an IAM API key with the iam.principals.delete permission. Application API keys and access tokens don't work.

Parameters

Path parameters

principal_id*string

The principal's ID.

Responses

request_idstring

The ID of the request.

DELETEhttps://api.us.nylas.com/v3/iam/principals/{principal_id}

Paste the authorization token required for this endpoint.

principal_idrequiredstring

The principal's ID.