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

Delete IAM principal

Requires iam.principals.delete on an active principal bound to the authenticated organization. Authenticate with an active, unexpired IAM credential of type api_key. Application API keys (including legacy API keys) and provider OAuth tokens cannot authorize IAM management endpoints. Use an existing IAM credential with these permissions, or create your first management credential in the Dashboard.

Permanently deletes the principal and its credentials. The last active organization-bound IAM Admin cannot be deleted. A successful response contains request_id and no data.

IAM API KEY

Parameters

Path parameters

principal_id*string

ID of the principal in the authenticated organization.

Responses

request_idstring

Request ID for troubleshooting.

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

Paste the authorization token required for this endpoint.

principal_idrequiredstring

ID of the principal in the authenticated organization.