Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Netter permissions API

The permissions API from Netter — 5 operation(s) for permissions.

Netter permissions API is one of 44 APIs that Netter 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 an API reference.

This API exposes 7 operations across 5 paths, and defines 11 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against the base URL https://api.netter.ai.

7 operations 5 paths 11 schemas 1 DELETE4 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.netter.ai
Resource Areas
1

Paths & Operations 7

Across 5 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

permissions 7
GET
/api/v1/permissions/resource/{resource_type}/{resource_id}
List Resource Permissions
list_resource_permissions_api_v1_permissions_resource__resource_type___resource_id__get 2 params → 200422
POST
/api/v1/permissions/resource/{resource_type}/{resource_id}
Grant Resource Permission
grant_resource_permission_api_v1_permissions_resource__resource_type___resource_id__post 2 params body → 201422
PATCH
/api/v1/permissions/resource/{resource_type}/{resource_id}/{grantee_type}/{grantee_id}
Update Resource Permission
update_resource_permission_api_v1_permissions_resource__resource_type___resource_id___grantee_type___grantee_id__patch 4 params body → 200422
DELETE
/api/v1/permissions/resource/{resource_type}/{resource_id}/{grantee_type}/{grantee_id}
Revoke Resource Permission
revoke_resource_permission_api_v1_permissions_resource__resource_type___resource_id___grantee_type___grantee_id__delete 4 params → 204422
GET
/api/v1/permissions/user/{target_user_id}
List User Permissions
list_user_permissions_api_v1_permissions_user__target_user_id__get 1 param → 200422
GET
/api/v1/permissions/my
List My Permissions
list_my_permissions_api_v1_permissions_my_get 1 param → 200422
GET
/api/v1/permissions/effective/{resource_type}/{resource_id}
Effective Access
effective_access_api_v1_permissions_effective__resource_type___resource_id__get 2 params → 200422

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are PermissionRead (9 properties), AccessSource (7 properties), ValidationError (5 properties), UserPermissionRead (5 properties). Each schema is shown below with its type and property counts.

PermissionLevel
string
Permission tiers, strictly ordered VIEWER < EDITOR < ADMIN.
GranteeType
string
Who a resource grant targets — a user or a user group.
ValidationError
object
5 properties 3 required
UserPermissionRead
object
Permission with resource name for display in user permission lists.
5 properties 5 required
HTTPValidationError
object
1 property
PermissionUpdate
object
1 property 1 required
PermissionGrant
object
3 properties 3 required
ResourceType
string
Resources that can carry permissions. Polymorphic resourceid.
PermissionRead
object
9 properties 9 required
EffectiveAccessEntry
object
A user's effective access level on a resource, with all contributing sources.
3 properties 3 required
AccessSource
object
One contributing grant path for a user's effective access on a resource.
7 properties 7 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netter-permissions-api-openapi.yml Raw ↑

Other APIs Netter publishes across the network.

Netter actions API
Netter api-keys API
Netter app-chat API
Netter apps API
Netter apps-query API
Netter assistant API
Netter attributes API
Netter automations API
Netter chats API
Netter companies API
Netter dashboard-chat API
Netter dashboard-data API