sealgate-ai Permissions API
The Permissions API from sealgate-ai — 4 operation(s) for permissions.
The Permissions API from sealgate-ai — 4 operation(s) for permissions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sealgate-ai:sealgate-ai-permissions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SealGate Permissions API
description: Open-source MCP security, aggregation, and monitoring. Self-hosted MCP proxy.
version: 0.19.0
tags:
- name: Permissions
paths:
/api/v1/permissions/tool:
get:
summary: Get Tool Permissions
description: Get all tool permissions (domain-scoped to caller's domain).
operationId: get_tool_permissions_api_v1_permissions_tool_get
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PermissionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
post:
summary: Update Tool Permissions
description: Update tool permissions.
operationId: update_tool_permissions_api_v1_permissions_tool_post
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
- name: Idempotency-Key
in: header
required: false
description: Optional client-generated key that makes this write operation safe to retry. Reusing the same key returns the original response instead of performing the operation a second time. Keys are scoped to the caller and expire after 24 hours.
schema:
type: string
maxLength: 255
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePermissionsRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePermissionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
/api/v1/permissions/resource:
get:
summary: Get Resource Permissions
description: Get all resource permissions (domain-scoped to caller's domain).
operationId: get_resource_permissions_api_v1_permissions_resource_get
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PermissionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
post:
summary: Update Resource Permissions
description: Update resource permissions.
operationId: update_resource_permissions_api_v1_permissions_resource_post
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
- name: Idempotency-Key
in: header
required: false
description: Optional client-generated key that makes this write operation safe to retry. Reusing the same key returns the original response instead of performing the operation a second time. Keys are scoped to the caller and expire after 24 hours.
schema:
type: string
maxLength: 255
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePermissionsRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePermissionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
/api/v1/permissions/prompt:
get:
summary: Get Prompt Permissions
description: Get all prompt permissions (domain-scoped to caller's domain).
operationId: get_prompt_permissions_api_v1_permissions_prompt_get
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PermissionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
post:
summary: Update Prompt Permissions
description: Update prompt permissions.
operationId: update_prompt_permissions_api_v1_permissions_prompt_post
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
- name: Idempotency-Key
in: header
required: false
description: Optional client-generated key that makes this write operation safe to retry. Reusing the same key returns the original response instead of performing the operation a second time. Keys are scoped to the caller and expire after 24 hours.
schema:
type: string
maxLength: 255
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePermissionsRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePermissionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
/api/v1/permissions:
delete:
summary: Delete Permission
description: 'Delete a specific permission entry.
All parameters are required as query params:
- user_id: User ID or role ID (e.g. "role:finance")
- server_name: Server name
- permission_type: tool, resource, or prompt
- permission_key: The permission key to delete
Returns 200 when a permission was deleted, 204 when nothing matched.'
operationId: delete_permission_api_v1_permissions_delete
security:
- HTTPBearer: []
parameters:
- name: user_id
in: query
required: true
schema:
type: string
title: User Id
- name: server_name
in: query
required: true
schema:
type: string
title: Server Name
- name: permission_type
in: query
required: true
schema:
type: string
title: Permission Type
- name: permission_key
in: query
required: true
schema:
type: string
title: Permission Key
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeletePermissionResponse'
'204':
description: Nothing to delete
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Permissions
components:
schemas:
DeletePermissionResponse:
properties:
status:
type: string
title: Status
description: Operation result
default: ok
message:
type: string
title: Message
description: Result message
default: Permission deleted
type: object
title: DeletePermissionResponse
description: Response for permission deletion.
UpdatePermissionsResponse:
properties:
status:
type: string
title: Status
description: Operation result
default: ok
updated:
additionalProperties: true
type: object
title: Updated
description: Updated permission data
type: object
title: UpdatePermissionsResponse
description: Response for permission update operations.
UpdatePermissionsRequest:
properties:
permissions:
additionalProperties:
additionalProperties:
additionalProperties: true
type: object
type: object
type: object
title: Permissions
description: Permissions grouped by server_name, then by permission_key
user_id:
type: string
title: User Id
description: User ID to update permissions for (defaults to global)
default: '*'
type: object
required:
- permissions
title: UpdatePermissionsRequest
description: Request body for updating permissions.
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
PermissionsResponse:
properties:
permissions:
additionalProperties: true
type: object
title: Permissions
description: Permissions keyed by server_name, then permission_key
type: object
required:
- permissions
title: PermissionsResponse
description: Response containing permissions data (dynamic nested structure).
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
ClientBearer:
type: http
description: Opaque ewc_ client installation credential
scheme: bearer
ServiceToken:
type: http
description: 'A SealGate service token: `sgt_acct_...` (account token) or `sgt_org_...` (org token). Mint an account token in the dashboard.'
scheme: bearer
MCPGatewayOAuth:
type: oauth2
description: OAuth 2.1 authorization-code flow (PKCE required) against the SealGate MCP gateway's authorization server. Request only the scopes an agent needs; unrequested scopes are not granted.
flows:
authorizationCode:
authorizationUrl: /oauth/authorize
tokenUrl: /oauth/token
refreshUrl: /oauth/token
scopes:
mcp: Connect to the MCP gateway and call the tools exposed by your enabled servers. Every call is still evaluated by the policy engine.
offline_access: Issue a refresh token so the client can renew access without a new browser sign-in.