How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Authzed Permissions API

Check, expand, and lookup permissions on resources and subjects

Authzed Permissions API is one of 6 APIs that Authzed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Permissions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.

This API exposes 5 operations across 5 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://grpc.authzed.com, https://app.authzed.com.

5 operations 5 paths 36 schemas 5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://grpc.authzed.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Authzed Permissions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — SpiceDB preshared-key. Pass as Authorization: Bearer

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 POST. Each is listed below with its method, path, parameters, and response codes.

Permissions 5

Check, expand, and lookup permissions on resources and subjects

POST
/v1/permissions/check
CheckPermission determines for a given resource whether a subject computes to having a permission or is a direct member of a particular relation.
PermissionsService_CheckPermission body → 200default
POST
/v1/permissions/checkbulk
CheckBulkPermissions evaluates the given list of permission checks and returns the list of results.
PermissionsService_CheckBulkPermissions body → 200default
POST
/v1/permissions/expand
ExpandPermissionTree reveals the graph structure for a resource's permission or relation. This RPC does not recurse infinitely deep and may require multiple calls to fully unnest a deeply nested grap…
PermissionsService_ExpandPermissionTree body → 200default
POST
/v1/permissions/resources
LookupResources returns all the resources of a given type that a subject can access whether via a computed permission or relation membership.
PermissionsService_LookupResources body → 200default
POST
/v1/permissions/subjects
LookupSubjects returns all the subjects of a given type that have access whether via a computed permission or relation membership.
PermissionsService_LookupSubjects body → 200default

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are CheckDebugTrace (12 properties), LookupSubjectsRequest (9 properties), LookupSubjectsResponse (8 properties), LookupResourcesRequest (8 properties). Each schema is shown below with its type and property counts.

Any
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides supp…
1 property
LookupSubjectsResponse
object
LookupSubjectsResponse contains a single matching subject object ID for the requested subject object type on the permission or relation.
8 properties
Status
object
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](h…
3 properties
v1.Cursor
object
Cursor is used to provide resumption of listing between calls to APIs such as LookupResources.
1 property
PermissionType
string
PartialCaveatInfo
object
1 property
CheckPermissionResponse.Permissionship
string
- PERMISSIONSHIPUNSPECIFIED: PERMISSIONSHIPUNSPECIFIED is the default value and should not be used or relied upon. Servers should not return this value. - PERM…
CheckBulkPermissionsRequestItem
object
4 properties
CheckBulkPermissionsRequest
object
CheckBulkPermissionsRequest issues a check on whether a subject has permission or is a member of a relation on a specific resource for each item in the list. T…
3 properties
CheckDebugTrace.Permissionship
string
CheckBulkPermissionsResponseItem
object
3 properties
AlgebraicSubjectSet
object
AlgebraicSubjectSet is a subject set which is computed based on applying the specified operation to the operands according to the algebra of sets. UNION is a l…
2 properties
CheckBulkPermissionsPair
object
3 properties
ExpandPermissionTreeRequest
object
ExpandPermissionTreeRequest returns a tree representing the expansion of all relationships found accessible from a permission or relation on a particular resou…
3 properties
LookupResourcesResponse
object
LookupResourcesResponse contains a single matching resource object ID for the requested object type, permission, and subject.
5 properties
AlgebraicSubjectSet.Operation
string
CaveatEvalInfo
object
CaveatEvalInfo holds information about a caveat expression that was evaluated.
5 properties
CheckDebugTrace
object
CheckDebugTrace is a recursive trace of the requests made for resolving a CheckPermission API call.
12 properties
LookupResourcesRequest
object
LookupResourcesRequest performs a lookup of all resources of a particular kind on which the subject has the specified permission or the relation in which the s…
8 properties
SubProblems
object
1 property
CheckPermissionRequest
object
CheckPermissionRequest issues a check on whether a subject has a permission or is a member of a relation, on a specific resource.
6 properties
LookupPermissionship
string
- LOOKUPPERMISSIONSHIPUNSPECIFIED: LOOKUPPERMISSIONSHIPUNSPECIFIED is the default value and should not be used or relied upon. Servers should not return this v…
Result
string
Consistency
object
Consistency will define how a request is handled by the backend. By defining a consistency requirement, and a token at which those requirements should be appli…
4 properties
ObjectReference
object
ObjectReference is used to refer to a specific object in the system.
2 properties
CheckBulkPermissionsResponse
object
2 properties
ResolvedSubject
object
ResolvedSubject is a single subject resolved within LookupSubjects.
3 properties
ZedToken
object
ZedToken represents a point in time, or a "revision" in SpiceDB. It is used to provide causality metadata between Write and read requests (Check, ReadRelations…
1 property
CheckPermissionResponse
object
5 properties
WildcardOption
string
LookupSubjectsRequest
object
LookupSubjectsRequest performs a lookup of all subjects of a particular kind for which the subject has the specified permission or the relation in which the su…
9 properties
SubjectReference
object
2 properties
PermissionRelationshipTree
object
PermissionRelationshipTree is used for representing a tree of a resource and its permission relationships with other objects.
4 properties
ExpandPermissionTreeResponse
object
2 properties
DebugInformation
object
DebugInformation defines debug information returned by an API call in a footer when requested with a specific debugging header. The specific debug information…
2 properties
DirectSubjectSet
object
DirectSubjectSet is a subject set which is simply a collection of subjects.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

authzed-permissions-api-openapi.yml Raw ↑

Other APIs Authzed publishes across the network.

Authzed Cloud API
Authzed Experimental API
Authzed Relationships API
Authzed Schema API
Authzed Watch API
Where this information came from

This is an independent, third-party profile of Authzed Permissions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.