Nerdit Security API

Credential inventory and revocation.

GitHub OpenAPI

Operations 8

GET /api/security Every credential this account has issued, and what can end it #
PUT /api/security/account-mcp-grants/{grant_id}/access Replace Account Access #
PUT /api/security/account-mcp-grants/{grant_id}/nodes Replace Account Nodes #
POST /api/security/account-mcp-grants/{grant_id}/revoke Revoke Account Grant #
POST /api/security/grants/{consent_id}/revoke Withdraw one grant and every connection it authorized #
POST /api/security/families/{family_id}/revoke End one connection, leaving the grant behind it in place #
POST /api/security/proxy-sessions/{session_id}/revoke Close one node-dashboard session #
POST /api/security/revoke-all Revoke every remote credential this account has issued #

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.
All 92 tools →

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

nerdit-ai-security-api-openapi.yml Raw ↑
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.'