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/grafomem-com:grafomem-com-governed-decisions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: GRAFOMEM Cloud Governed Decisions API
  description: GMP-conformant governed agent memory platform. Provides vector-backed memory stores, multi-agent orchestration, decision trail audit logging, erasure proof certificates, governance policy evaluation, regulatory reports, webhook alerts, SSO/OIDC, and real-time SSE streaming.
  version: 1.9.0
tags:
- name: Governed Decisions
paths:
  /v1/governed/decisions:
    post:
      tags:
      - Governed Decisions
      summary: Governed Decision
      operationId: governed_decision_v1_governed_decisions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GovernedDecisionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governed/verify-batch:
    post:
      tags:
      - Governed Decisions
      summary: Verify Batch
      description: 'Ingest a batch of invoices, run the configurable rules engine

        SERVER-SIDE, and record each result as a signed governed decision

        (verifiability_tag="rule").'
      operationId: verify_batch_v1_governed_verify_batch_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyBatchRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governed/outcomes:
    post:
      tags:
      - Governed Decisions
      summary: Post Outcome
      operationId: post_outcome_v1_governed_outcomes_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OutcomeEvent'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governed/outcomes/bulk:
    post:
      tags:
      - Governed Decisions
      summary: Post Outcomes Bulk
      operationId: post_outcomes_bulk_v1_governed_outcomes_bulk_post
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/OutcomeEvent'
              type: array
              title: Events
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governed/reviews:
    post:
      tags:
      - Governed Decisions
      summary: Post Review
      operationId: post_review_v1_governed_reviews_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReviewRecord'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/cgr/rotation:
    post:
      tags:
      - Governed Decisions
      summary: Post Rotation
      description: 'Capture an emitter-supplied key-rotation proof (Ticket #7). Stored raw,

        append-only; the signature is verified at scoring time before keyA and keyB

        are folded into one identity.'
      operationId: post_rotation_v1_cgr_rotation_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RotationProofRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/cgr/rotations:
    get:
      tags:
      - Governed Decisions
      summary: Get Rotations
      description: 'Serve the captured, self-certifying rotation proofs read-only (Ticket

        #10a) so a consumer (geiant) can INDEPENDENTLY verify anchor→current instead

        of trusting grafomem''s re-issue. Each proof is served raw (byte-parity with

        what prev_key signed); the reader re-checks every signature — the server is

        untrusted transport, never an authority on continuity.


        Optional ?anchor= / ?current= filter to one identity''s chain,

        resolved server-side via resolve_identities (a convenience; the reader still

        re-verifies). Read-only, no write path touched.


        Auth: tenant-scoped (parity with the reviews/substrate reads) — a valid

        tenant context is required. Because the proofs are self-certifying, this

        route COULD be made anonymous by adding "/v1/cgr/rotations" to auth.py''s

        _SKIP_AUTH_PATHS (as /v1/cgr/issuer is); left tenant-scoped by default until

        a concrete anonymous-verifier need lands.'
      operationId: get_rotations_v1_cgr_rotations_get
      parameters:
      - name: anchor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Anchor
      - name: current
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Current
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/governed/reviews/bulk:
    post:
      tags:
      - Governed Decisions
      summary: Post Reviews Bulk
      operationId: post_reviews_bulk_v1_governed_reviews_bulk_post
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/ReviewRecord'
              type: array
              title: Reviews
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    VerifyBatchRequest:
      properties:
        invoices:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Invoices
        policy:
          additionalProperties: true
          type: object
          title: Policy
        model_id:
          type: string
          title: Model Id
          default: kapwork-verify-agent-v1
        agent_handle:
          type: string
          title: Agent Handle
          default: invoice-rules-engine@kapwork-receivables
        agent_tier:
          anyOf:
          - type: number
          - type: 'null'
          title: Agent Tier
        agent_key:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Key
      type: object
      required:
      - invoices
      title: VerifyBatchRequest
    GovernedDecisionRequest:
      properties:
        decision:
          type: string
          title: Decision
        reason:
          type: string
          title: Reason
          default: ''
        invoice_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Invoice Id
        context:
          additionalProperties: true
          type: object
          title: Context
        model_id:
          type: string
          title: Model Id
          default: kapwork-verify-agent-v1
        agent_handle:
          type: string
          title: Agent Handle
          default: invoice-certifier@kapwork-receivables
        verifiability_tag:
          type: string
          title: Verifiability Tag
          default: judgment
        agent_tier:
          anyOf:
          - type: number
          - type: 'null'
          title: Agent Tier
        agent_key:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Key
        domain:
          anyOf:
          - type: string
          - type: 'null'
          title: Domain
      type: object
      required:
      - decision
      title: GovernedDecisionRequest
    ReviewRecord:
      properties:
        invoice_ref:
          type: string
          title: Invoice Ref
        reviewer_handle:
          type: string
          title: Reviewer Handle
        rating:
          type: number
          title: Rating
        agent_handle:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Handle
        decision_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Decision Id
        review_date:
          anyOf:
          - type: string
          - type: 'null'
          title: Review Date
        source:
          type: string
          title: Source
          default: manual
      type: object
      required:
      - invoice_ref
      - reviewer_handle
      - rating
      title: ReviewRecord
      description: 'A funder/analyst rating of a certification (Ticket #3). Enables the

        "verify the reviewer" bridge — calibrate a reviewer on verifiable outcomes,

        then trust their ratings on unverifiable calls. Many-per-invoice: dedup key is

        (invoice_ref, reviewer_handle).'
    OutcomeEvent:
      properties:
        invoice_ref:
          type: string
          title: Invoice Ref
        outcome:
          type: string
          title: Outcome
        outcome_date:
          anyOf:
          - type: string
          - type: 'null'
          title: Outcome Date
        amount_recovered:
          anyOf:
          - type: number
          - type: 'null'
          title: Amount Recovered
        source:
          type: string
          title: Source
          default: manual
      type: object
      required:
      - invoice_ref
      - outcome
      title: OutcomeEvent
    RotationProofRequest:
      properties:
        prev_key:
          type: string
          title: Prev Key
        new_key:
          type: string
          title: New Key
        seq:
          type: integer
          title: Seq
          default: 1
        not_before:
          anyOf:
          - type: string
          - type: 'null'
          title: Not Before
        sig:
          type: string
          title: Sig
        source:
          type: string
          title: Source
          default: agent
      type: object
      required:
      - prev_key
      - new_key
      - sig
      title: RotationProofRequest
      description: 'A self-certifying key-rotation link (Ticket #7), EMITTER-supplied: the agent''s

        OLD key signs {prev_key, new_key, seq, not_before}. Stored raw (append-only);

        the signature is verified at aggregation time, never trusted on write.'