Use batch with a wildcard to revoke all of a users Oso Cloud roles

TL;DR

On user removal, call the batch API with None in the role position to wipe all of that user's roles on the org at once instead of enumerating them. Reserve individual delete calls for single-fact removals.

Steps

1. On user removal, call the batch API with None in the role position to wipe all of that user's roles on the org at once instead of enumerating them. Reserve individual delete calls for single-fact removals. Forgetting to revoke facts on offboarding leaves a ghost authorization behind.

When to use

You are seeing this: Forgetting to revoke facts on offboarding leaves a ghost authorization behind. Use this skill when you run into "Use batch with a wildcard to revoke all of a users Oso Cloud roles".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Official docs (End-to-end example, Oso Cloud): documents a gotcha that trips agents handling offboarding. When a user leaves an organization you must delete their role facts from Oso Cloud, and listing plus deleting each role individually is the slow way. The batch API accepts None as a wildcard argument, deleting every role the user has on the given organization in one call; use delete for removing a single fact.

Verified resolution: On user removal, call the batch API with None in the role position to wipe all of that user's roles on the org at once instead of enumerating them. Reserve individual delete calls for single-fact removals. Forgetting to revoke facts on offboarding leaves a ghost authorization behind.

Source URL: https://www.osohq.com/docs/learn/tutorials/end-to-end-example