Insforge Permissions API
Manage helper endpoints for realtime RLS examples.
Manage helper endpoints for realtime RLS examples.
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/insforge:insforge-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: Insforge Realtime Permissions API
version: 1.0.0
description: Realtime channel management, message history, permissions, and retention API. Live pub/sub uses Socket.IO.
tags:
- name: Permissions
description: Manage helper endpoints for realtime RLS examples.
paths:
/api/realtime/permissions:
get:
summary: Get Realtime Permissions
description: Retrieve RLS policies for subscribe (channels) and publish (messages) operations
tags:
- Permissions
security:
- bearerAuth: []
- apiKey: []
responses:
'200':
description: Realtime RLS permissions
content:
application/json:
schema:
$ref: '#/components/schemas/RealtimePermissions'
example:
subscribe:
policies:
- policyName: allow_authenticated_subscribe
tableName: channels
command: SELECT
roles:
- authenticated
using: enabled = true
withCheck: null
publish:
policies:
- policyName: allow_authenticated_publish
tableName: messages
command: INSERT
roles:
- authenticated
using: null
withCheck: 'true'
operationId: getApiRealtimePermissions
x-operation-id-source: derived
components:
schemas:
RealtimePermissions:
type: object
required:
- subscribe
- publish
properties:
subscribe:
type: object
required:
- policies
properties:
policies:
type: array
description: RLS policies for channel subscriptions
items:
$ref: '#/components/schemas/RlsPolicy'
publish:
type: object
required:
- policies
properties:
policies:
type: array
description: RLS policies for message publishing
items:
$ref: '#/components/schemas/RlsPolicy'
RlsPolicy:
type: object
required:
- policyName
- tableName
- command
- roles
properties:
policyName:
type: string
description: Name of the RLS policy
example: allow_authenticated_subscribe
tableName:
type: string
description: Table the policy applies to
example: channels
command:
type: string
description: SQL command the policy applies to (SELECT, INSERT, UPDATE, DELETE)
example: SELECT
roles:
type: array
items:
type: string
description: Database roles the policy applies to
example:
- authenticated
using:
type:
- string
- 'null'
description: USING clause for row-level filtering
example: enabled = true
withCheck:
type:
- string
- 'null'
description: WITH CHECK clause for row-level validation
example: null
securitySchemes:
bearerAuth:
type: http
scheme: bearer
apiKey:
type: apiKey
in: header
name: X-API-Key
x-provenance:
method: harvested
publisher: Insforge
source: https://raw.githubusercontent.com/InsForge/InsForge/main/openapi/realtime.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)