Fga
- Written for
- + Written for
- Deprecated
- + Deprecated
- Applies to
- + Applies to
Fga
Backend API — secret key (Authorization: Bearer sk_…).
13 routes. Each row is one endpoint with its explanation, required scope, and whether it honours the Idempotency-Key header.
Method & path | Scope | Idem | Explanation |
|---|---|---|---|
|
| List fine-grained authorization (ReBAC / Zanzibar) stores in the instance. Each store namespaces its own authorization models and relationship tuples. | |
|
| ✓ | Create a fine-grained authorization store — an isolated namespace for authorization models and relationship tuples. |
|
| Read one FGA store. A store from another instance is a 404. | |
|
| Delete an FGA store, cascading its authorization models and relationship tuples. | |
|
| List the immutable authorization-model versions of a store, newest first. | |
|
| ✓ | Write a new immutable authorization-model version (OpenFGA-shaped type_definitions with this/computedUserset/tupleToUserset and union/intersection/difference). Unknown relation or type references are rejected. |
|
| Read one authorization-model version, including its full model definition. | |
|
| ✓ | Transactionally write and/or delete relationship tuples in a store. Writes are idempotent (a re-written tuple is a no-op); the whole batch is all-or-nothing. |
|
| Query stored relationship tuples in a store, optionally filtered by user, relation and/or object. | |
|
| Check whether a user has a relation on an object, resolving the authorization model (direct tuples, computed usersets, tuple-to-userset hops, set operators) with cycle + depth safety. Supports contextual tuples and a pinned authorization_model_id. | |
|
| List the object ids of a type that a user has a relation on. Exact (check-filtered over the complete candidate set); cost is linear in the objects of that type. | |
|
| Expand the userset tree for an (object, relation) — who would hold the relation, mirroring the model rewrite. Not user-specific. | |
|
| Check up to 100 (user, relation, object) tuples in one request. |