Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/nerdit-ai:nerdit-ai-security-api"
All apis
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.
Get an API 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Nerdit Cloud (web) Security API
version: 0.1.0
description: Credential inventory and revocation.
tags:
- name: Security
description: Credential inventory and revocation.
paths:
/api/security:
get:
tags:
- Security
summary: Every credential this account has issued, and what can end it
description: 'Answer what reaches this account''s node, and on whose authority.
One session, three reads, no relay: everything here is durable state,
so — unlike ``GET /api/nodes``, which merges in a liveness projection —
this page is the same answer whether or not a daemon is connected.'
operationId: security_overview_api_security_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SecurityView'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
/api/security/account-mcp-grants/{grant_id}/access:
put:
tags:
- Security
summary: Replace Account Access
operationId: replace_account_access_api_security_account_mcp_grants__grant_id__access_put
parameters:
- name: grant_id
in: path
required: true
schema:
type: string
format: uuid
title: Grant Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AccountGrantAccessRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccountGrantAccessView'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/security/account-mcp-grants/{grant_id}/nodes:
put:
tags:
- Security
summary: Replace Account Nodes
operationId: replace_account_nodes_api_security_account_mcp_grants__grant_id__nodes_put
parameters:
- name: grant_id
in: path
required: true
schema:
type: string
format: uuid
title: Grant Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AccountGrantNodesRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccountGrantNodesView'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/security/account-mcp-grants/{grant_id}/revoke:
post:
tags:
- Security
summary: Revoke Account Grant
operationId: revoke_account_grant_api_security_account_mcp_grants__grant_id__revoke_post
parameters:
- name: grant_id
in: path
required: true
schema:
type: string
format: uuid
title: Grant Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GrantRevocationView'
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/security/grants/{consent_id}/revoke:
post:
tags:
- Security
summary: Withdraw one grant and every connection it authorized
description: 'Disconnect one app from one node: the consent and its families go.'
operationId: revoke_grant_api_security_grants__consent_id__revoke_post
parameters:
- name: consent_id
in: path
required: true
schema:
type: string
format: uuid
title: Consent Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GrantRevocationView'
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/security/families/{family_id}/revoke:
post:
tags:
- Security
summary: End one connection, leaving the grant behind it in place
description: 'The narrow lever: one connector goes, the app stays approved.'
operationId: revoke_family_api_security_families__family_id__revoke_post
parameters:
- name: family_id
in: path
required: true
schema:
type: string
format: uuid
title: Family Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GrantRevocationView'
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/security/proxy-sessions/{session_id}/revoke:
post:
tags:
- Security
summary: Close one node-dashboard session
description: End one browser's access to one node dashboard; stay signed in here.
operationId: revoke_proxy_session_api_security_proxy_sessions__session_id__revoke_post
parameters:
- name: session_id
in: path
required: true
schema:
type: string
format: uuid
title: Session Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProxySessionRevocationView'
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/security/revoke-all:
post:
tags:
- Security
summary: Revoke every remote credential this account has issued
description: 'Cut off every connector, dashboard session and guest session, and nothing else.
No 404 branch: the subject is the caller''s own account, which the
session already proved exists. An account with nothing left to revoke
revokes zero, exactly as a repeat of any other scope does, though a
stream whose credential is already dead still closes.'
operationId: revoke_all_api_security_revoke_all_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccountRevocationView'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
SecurityView:
properties:
clients:
items:
$ref: '#/components/schemas/ClientView'
type: array
title: Clients
grants:
items:
$ref: '#/components/schemas/GrantView'
type: array
title: Grants
proxy_sessions:
items:
$ref: '#/components/schemas/ProxySessionView'
type: array
title: Proxy Sessions
account_grants:
items:
$ref: '#/components/schemas/AccountGrantView'
type: array
title: Account Grants
available_account_nodes:
items:
$ref: '#/components/schemas/AccountGrantNodeView'
type: array
title: Available Account Nodes
max_account_grant_nodes:
type: integer
title: Max Account Grant Nodes
default: 25
available_account_projects:
items:
$ref: '#/components/schemas/AccountGrantProjectView'
type: array
title: Available Account Projects
max_account_grant_projects:
type: integer
title: Max Account Grant Projects
default: 25
additionalProperties: false
type: object
required:
- clients
- grants
- proxy_sessions
title: SecurityView
description: Everything reaching this account's machines — or able to again — and what ends it.
GrantView:
properties:
id:
type: string
format: uuid
title: Id
client_id:
type: string
title: Client Id
client_name:
type: string
title: Client Name
client_revoked:
type: boolean
title: Client Revoked
self_registered:
type: boolean
title: Self Registered
redirect_uris:
items:
type: string
type: array
title: Redirect Uris
node_id:
type: string
format: uuid
title: Node Id
node_slug:
type: string
title: Node Slug
node_name:
type: string
title: Node Name
role:
type: string
const: submitter
title: Role
scopes:
items:
type: string
type: array
title: Scopes
granted_at:
type: string
format: date-time
title: Granted At
families:
items:
$ref: '#/components/schemas/FamilyView'
type: array
title: Families
additionalProperties: false
type: object
required:
- id
- client_id
- client_name
- client_revoked
- self_registered
- redirect_uris
- node_id
- node_slug
- node_name
- role
- scopes
- granted_at
- families
title: GrantView
description: One approval — an app, a node, and the connections it authorized.
AccountGrantNodeView:
properties:
id:
type: string
format: uuid
title: Id
slug:
type: string
title: Slug
display_name:
type: string
title: Display Name
additionalProperties: false
type: object
required:
- id
- slug
- display_name
title: AccountGrantNodeView
ProxySessionView:
properties:
id:
type: string
format: uuid
title: Id
node_id:
type: string
format: uuid
title: Node Id
node_slug:
type: string
title: Node Slug
destination_host:
type: string
title: Destination Host
role:
type: string
title: Role
created_at:
type: string
format: date-time
title: Created At
last_seen_at:
type: string
format: date-time
title: Last Seen At
absolute_expires_at:
type: string
format: date-time
title: Absolute Expires At
additionalProperties: false
type: object
required:
- id
- node_id
- node_slug
- destination_host
- role
- created_at
- last_seen_at
- absolute_expires_at
title: ProxySessionView
description: One browser's open access to one node dashboard.
AccountRevocationView:
properties:
revoked_grants:
type: integer
title: Revoked Grants
revoked_families:
type: integer
title: Revoked Families
revoked_proxy_sessions:
type: integer
title: Revoked Proxy Sessions
revoked_visitor_sessions:
type: integer
title: Revoked Visitor Sessions
closed_streams:
type: integer
title: Closed Streams
additionalProperties: false
type: object
required:
- revoked_grants
- revoked_families
- revoked_proxy_sessions
- revoked_visitor_sessions
- closed_streams
title: AccountRevocationView
description: Everything "revoke all remote access" reached, counted per kind.
AccountGrantNodesRequest:
properties:
node_ids:
items:
type: string
format: uuid
type: array
maxItems: 1000
title: Node Ids
additionalProperties: false
type: object
required:
- node_ids
title: AccountGrantNodesRequest
AccountGrantProjectView:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
node_id:
type: string
format: uuid
title: Node Id
node_name:
type: string
title: Node Name
additionalProperties: false
type: object
required:
- id
- name
- node_id
- node_name
title: AccountGrantProjectView
AccountGrantView:
properties:
id:
type: string
format: uuid
title: Id
client_id:
type: string
title: Client Id
client_name:
type: string
title: Client Name
client_revoked:
type: boolean
title: Client Revoked
self_registered:
type: boolean
title: Self Registered
redirect_uris:
items:
type: string
type: array
title: Redirect Uris
resource:
type: string
title: Resource
role:
type: string
const: submitter
title: Role
scopes:
items:
type: string
type: array
title: Scopes
granted_at:
type: string
format: date-time
title: Granted At
updated_at:
type: string
format: date-time
title: Updated At
scope_kind:
type: string
enum:
- nodes
- projects
title: Scope Kind
nodes:
items:
$ref: '#/components/schemas/AccountGrantNodeView'
type: array
title: Nodes
projects:
items:
$ref: '#/components/schemas/AccountGrantProjectView'
type: array
title: Projects
families:
items:
$ref: '#/components/schemas/FamilyView'
type: array
title: Families
additionalProperties: false
type: object
required:
- id
- client_id
- client_name
- client_revoked
- self_registered
- redirect_uris
- resource
- role
- scopes
- granted_at
- updated_at
- scope_kind
- nodes
- projects
- families
title: AccountGrantView
ProxySessionRevocationView:
properties:
revoked:
type: boolean
title: Revoked
closed_streams:
type: integer
title: Closed Streams
additionalProperties: false
type: object
required:
- revoked
- closed_streams
title: ProxySessionRevocationView
description: 'What closing one node-dashboard session ended: the session, and nothing else.'
FamilyView:
properties:
family_id:
type: string
format: uuid
title: Family Id
created_at:
type: string
format: date-time
title: Created At
expires_at:
type: string
format: date-time
title: Expires At
last_used_at:
type: string
format: date-time
title: Last Used At
additionalProperties: false
type: object
required:
- family_id
- created_at
- expires_at
- last_used_at
title: FamilyView
description: 'One live connection under a grant: a refresh family and its deadline.'
AccountGrantNodesView:
properties:
closed_streams:
type: integer
title: Closed Streams
revoked_families:
type: integer
title: Revoked Families
reconnect_required:
type: boolean
title: Reconnect Required
additionalProperties: false
type: object
required:
- closed_streams
- revoked_families
- reconnect_required
title: AccountGrantNodesView
ClientView:
properties:
client_id:
type: string
title: Client Id
client_name:
type: string
title: Client Name
additionalProperties: false
type: object
required:
- client_id
- client_name
title: ClientView
description: 'One client this deployment would accept an authorization from.
Deployment-global rather than per-account, and deliberately so: the list is
operator-curated and its identifiers are pasted into Claude by hand, so a
client with no grant from this person still belongs on the page — it is
what they are about to connect, and the page is where they check that the
identifier they were given is one this server knows.
Which is why a client an operator has taken out of service is absent here
even when a grant above still names it: this collection answers "would an
authorization for this identifier be accepted", and for that one the answer
is no. The grant is the thing that survived, and it is listed where the
grants are.'
ErrorEnvelope:
properties:
error:
$ref: '#/components/schemas/ErrorDetail'
additionalProperties: false
type: object
required:
- error
title: ErrorEnvelope
description: Response model used by all cloud API errors.
AccountGrantAccessView:
properties:
closed_streams:
type: integer
title: Closed Streams
revoked_families:
type: integer
title: Revoked Families
reconnect_required:
type: boolean
title: Reconnect Required
additionalProperties: false
type: object
required:
- closed_streams
- revoked_families
- reconnect_required
title: AccountGrantAccessView
AccountGrantAccessRequest:
properties:
scope_kind:
type: string
enum:
- nodes
- projects
title: Scope Kind
node_ids:
anyOf:
- items:
type: string
format: uuid
type: array
maxItems: 1000
- type: 'null'
title: Node Ids
project_ids:
anyOf:
- items:
type: string
maxLength: 20
minLength: 20
pattern: ^prj_[a-z2-7]{16}$
type: array
maxItems: 1000
- type: 'null'
title: Project Ids
additionalProperties: false
type: object
required:
- scope_kind
title: AccountGrantAccessRequest
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
ErrorDetail:
properties:
code:
$ref: '#/components/schemas/ErrorCode'
message:
type: string
title: Message
status:
type: integer
title: Status
request_id:
anyOf:
- type: string
- type: 'null'
title: Request Id
details:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Details
additionalProperties: false
type: object
required:
- code
- message
- status
title: ErrorDetail
description: The stable body nested under the envelope's ``error`` key.
ErrorCode:
type: string
enum:
- bad_request
- unauthorized
- forbidden
- not_found
- method_not_allowed
- conflict
- validation_failed
- rate_limited
- internal_error
- service_unavailable
- not_implemented
- plan_limit_exceeded
- link_code_invalid
- link_code_expired
- link_code_consumed
- link_code_attempts_exceeded
- link_code_limit_exceeded
- link_code_denied
- link_key_invalid
- preauth_key_limit_exceeded
- node_not_found
- node_already_linked
- node_offline
- machine_waking
- node_revoked
- entitlement_required
- organisation_has_members
- trial_quota_used
- trial_boxes_busy
- trial_archived
- replace.bad_url
- replace.extractor_unavailable
- replace.already_claimed
- csrf_failed
- auth_transaction_invalid
- auth_transaction_expired
- auth_identity_invalid
- auth_identity_deleting
- session_invalid
- session_expired
- navigation_ticket_invalid
- navigation_ticket_expired
- navigation_ticket_consumed
- proxy_session_invalid
- proxy_session_expired
- origin_forbidden
- hosted_private
- hosted_disabled
- visitor_session_required
- custom_domains.pro_required
- custom_domains.limit_reached
- custom_domains.apex_unsupported
- custom_domains.taken
- custom_domains.not_found
- access_revoked
- webhook_signature_invalid
- already_subscribed
- billing_account_missing
- oauth_invalid_request
- oauth_invalid_client
- oauth_invalid_grant
- oauth_unsupported_grant_type
- oauth_invalid_scope
- oauth_access_denied
- oauth_server_error
- oauth_temporarily_unavailable
- oauth_invalid_token
- oauth_insufficient_scope
- protocol_version_unsupported
- node_authentication_failed
- relay_frame_invalid
- relay_destination_invalid
- relay_stream_unknown
- relay_stream_limit_exceeded
- relay_body_too_large
- relay_response_too_large
- relay_bandwidth_exceeded
- relay_backpressure
- relay_draining
- relay_stream_timeout
title: ErrorCode
description: Codes clients may branch on independently of human-readable messages.
GrantRevocationView:
properties:
revoked_families:
type: integer
title: Revoked Families
closed_streams:
type: integer
title: Closed Streams
additionalProperties: false
type: object
required:
- revoked_families
- closed_streams
title: GrantRevocationView
description: 'What withdrawing one grant — or one family — actually ended.
Zeros are a success: the subject was already revoked, which is the state
the caller asked for. ``closed_streams`` counts the live streams this
request terminated, which is what makes the thirty-second bound (W-I8)
something the page can show rather than only promise.'