Numonic Ltd. API

Numonic Ltd. API as documented publicly: 25 operations. Contract generated from the documentation by API Evangelist (2026-11-19); not the provider's own document.

GitHub OpenAPI

Operations 25

GET /api/s/{id} GET /api/s/{id} #
GET /api/v1/admin/crm/contacts Search Contacts #
GET /api/v1/admin/crm/dedup-candidates List Dedup Candidates #
POST /api/v1/admin/crm/dedup-candidates/{candidate} Resolve Dedup Candidate #
POST /api/v1/admin/crm/merges Merge CRM Records #
GET /api/v1/admin/crm/prospects Search Prospects #
POST /api/v1/admin/crm/prospects Register Prospect #
GET /api/v1/admin/crm/prospects/{prospecth} Get Prospect State #
POST /api/v1/admin/crm/prospects/{prospecth}/touches Log Outreach Touch #
GET /api/v1/admin/crm/relationship-summary Get Relationship Summary #
GET /api/v1/annotations List annotations on a workflow node. #
POST /api/v1/annotations Add an audited annotation to a workflow node (not shown in the asset Notes tab). #
DELETE /api/v1/annotations/{annotationid} Soft-delete an annotation, keeping the audit trail. #
PATCH /api/v1/annotations/{annotationid} Revise an annotation as a new superseding version. #
POST /api/v1/assets/{asseth}/notes Add a note to an asset, shown in its Notes tab. #
GET /api/v1/collections List collections as a hierarchical tree for organizing as #
PATCH /api/v1/collections/{collectionh} Update collection metadata such as display name or description. #
GET /api/v1/models GET /api/v1/models #
GET /api/v1/models/{modelid} Get full details for a specific model including metadata, version history, and usage. #
POST /api/v1/prompts POST /api/v1/prompts #
GET /api/v1/prompts/{prompth} Get a prompt by hash ID with full version history and evaluations. #
POST /api/v1/prompts/{prompth}/render Render a prompt template by substituting {{variable}} placeholders with provided values. #
GET /api/v1/storage/details Get Tenant Storage Details #
GET /api/v1/storage/signed-url/upload Get a signed URL for uploading a file #
POST /mcp Transport HTTP / JSON‑RPC 2.0 #

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/numonic-ai:numonic-ai-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

numonic-ai-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Numonic Ltd. API
  version: '2026-11-19'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-19: 25 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Numonic Ltd. has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 24
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-19'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.numonic.ai/docs/api/mcp
paths:
  /api/s/{id}:
    get:
      operationId: get_api_s_id
      tags:
      - Api
      summary: GET /api/s/{id}
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl or fetch rather than retyping it), and optionally returns a small inline preview image (include_image) so the asset can
          be seen without fetching a URL. For a URL that does not expire, approve the asset and call PublishAsset. Parameter Type Required Description
          tenant_id string · uuid optional Optional: UUID of the tenant. Omit it: the server uses the tenant your credential (OAuth connection
          o'
  /api/v1/admin/crm/contacts:
    get:
      operationId: get_api_v1_admin_crm_contacts
      tags:
      - Api
      summary: Search Contacts
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: Required by this tool, but the value is ignored.
      - name: pipeline
        in: query
        required: true
        schema:
          type: string
        description: Which CRM pipeline to list.
      - name: stage
        in: query
        required: false
        schema:
          type: string
        description: Optional pipeline-stage filter.
      - name: search
        in: query
        required: false
        schema:
          type: string
        description: Optional case‑insensitive substring match.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/dedup-candidates:
    get:
      operationId: get_api_v1_admin_crm_dedup_candidates
      tags:
      - Api
      summary: List Dedup Candidates
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: Candidate status filter (default open).
      - name: entity_type
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: only contacts or only organizations.'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Page size (default 25).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/dedup-candidates/{candidate}:
    post:
      operationId: post_api_v1_admin_crm_dedup_candidates_candidate
      tags:
      - Api
      summary: Resolve Dedup Candidate
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: candidate
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AdminCrmDedupCandidatesCandidateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/merges:
    post:
      operationId: post_api_v1_admin_crm_merges
      tags:
      - Api
      summary: Merge CRM Records
      x-source: https://www.numonic.ai/docs/api/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AdminCrmMergesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/prospects:
    get:
      operationId: get_api_v1_admin_crm_prospects
      tags:
      - Api
      summary: Search Prospects
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: Required by this tool, but the value is ignored.
      - name: filters
        in: query
        required: false
        schema:
          type: object
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_admin_crm_prospects
      tags:
      - Api
      summary: Register Prospect
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: Required by this tool, but the value is ignored.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AdminCrmProspectsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/prospects/{prospecth}:
    get:
      operationId: get_api_v1_admin_crm_prospects_prospecth
      tags:
      - Api
      summary: Get Prospect State
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: prospecth
        in: path
        required: true
        schema:
          type: string
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Required by this tool, but the value is ignored: it always acts on the canonical CRM tenant (super‑admin only).'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/prospects/{prospecth}/touches:
    post:
      operationId: post_api_v1_admin_crm_prospects_prospecth_touches
      tags:
      - Api
      summary: Log Outreach Touch
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: prospecth
        in: path
        required: true
        schema:
          type: string
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: Required by this tool, but the value is ignored.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AdminCrmProspectsProspecthTouchesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/admin/crm/relationship-summary:
    get:
      operationId: get_api_v1_admin_crm_relationship_summary
      tags:
      - Api
      summary: Get Relationship Summary
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Required by this tool, but the value is ignored: it always acts on the canonical CRM tenant (super‑admin only).'
      - name: entity_type
        in: query
        required: true
        schema:
          type: string
        description: Which hub entity_id belongs to.
      - name: entity_id
        in: query
        required: true
        schema:
          type: string
        description: Hub hash (SHA-1) of the contact, prospect or organization.
      - name: activity_limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum activity entries returned (default 50).
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/annotations:
    get:
      operationId: get_api_v1_annotations
      tags:
      - Api
      summary: List annotations on a workflow node.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: workflow_node_id
        in: query
        required: true
        schema:
          type: string
        description: 40-character hexadecimal workflow node identifier
      - name: include_resolved
        in: query
        required: false
        schema:
          type: boolean
        description: 'Include resolved annotations in results (default: false)'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_annotations
      tags:
      - Api
      summary: Add an audited annotation to a workflow node (not shown in the asset Notes tab).
      x-source: https://www.numonic.ai/docs/api/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AnnotationsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/annotations/{annotationid}:
    delete:
      operationId: delete_api_v1_annotations_annotationid
      tags:
      - Api
      summary: Soft-delete an annotation, keeping the audit trail.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: annotationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_api_v1_annotations_annotationid
      tags:
      - Api
      summary: Revise an annotation as a new superseding version.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: annotationid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiV1AnnotationsAnnotationidRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/assets/{asseth}/notes:
    post:
      operationId: post_api_v1_assets_asseth_notes
      tags:
      - Api
      summary: Add a note to an asset, shown in its Notes tab.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: asseth
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AssetsAssethNotesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/collections:
    get:
      operationId: get_api_v1_collections
      tags:
      - Api
      summary: List collections as a hierarchical tree for organizing as
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: UUID of the tenant.'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/collections/{collectionh}:
    patch:
      operationId: patch_api_v1_collections_collectionh
      tags:
      - Api
      summary: Update collection metadata such as display name or description.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: collectionh
        in: path
        required: true
        schema:
          type: string
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: UUID of the tenant.'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiV1CollectionsCollectionhRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/models:
    get:
      operationId: get_api_v1_models
      tags:
      - Api
      summary: GET /api/v1/models
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: UUID of the tenant.'
      - name: query
        in: query
        required: false
        schema:
          type: string
        description: Text search across model name, display name, and description.
      - name: model_type
        in: query
        required: false
        schema:
          type: string
        description: Filter by model type.
      - name: base_model
        in: query
        required: false
        schema:
          type: string
        description: Filter by base architecture.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: 'Maximum results to return (default: 50)'
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: 'Offset for pagination (default: 0)'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/models/{modelid}:
    get:
      operationId: get_api_v1_models_modelid
      tags:
      - Api
      summary: Get full details for a specific model including metadata, version history, and usage.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: modelid
        in: path
        required: true
        schema:
          type: string
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: UUID of the tenant.'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/prompts:
    post:
      operationId: post_api_v1_prompts
      tags:
      - Api
      summary: POST /api/v1/prompts
      x-source: https://www.numonic.ai/docs/api/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PromptsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/prompts/{prompth}:
    get:
      operationId: get_api_v1_prompts_prompth
      tags:
      - Api
      summary: Get a prompt by hash ID with full version history and evaluations.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: prompth
        in: path
        required: true
        schema:
          type: string
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: Tenant UUID
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/prompts/{prompth}/render:
    post:
      operationId: post_api_v1_prompts_prompth_render
      tags:
      - Api
      summary: Render a prompt template by substituting {{variable}} placeholders with provided values.
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: prompth
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PromptsPrompthRenderRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/storage/details:
    get:
      operationId: get_api_v1_storage_details
      tags:
      - Api
      summary: Get Tenant Storage Details
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: tenant_id
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: UUID of the tenant to query.'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/storage/signed-url/upload:
    get:
      operationId: get_api_v1_storage_signed_url_upload
      tags:
      - Api
      summary: Get a signed URL for uploading a file
      x-source: https://www.numonic.ai/docs/api/mcp
      parameters:
      - name: filename
        in: query
        required: true
        schema:
          type: string
        description: Original filename
      - name: contentType
        in: query
        required: true
        schema:
          type: string
        description: MIME type of the file
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token (API key with write scope)
      - name: X-Tenant-ID
        in: header
        required: false
        schema:
          type: string
        description: Tenant identifier
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1StorageSignedUrlUploadResponse'
      x-evidence:
        kind: documentation
  /mcp:
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: Transport HTTP / JSON‑RPC 2.0
      x-source: https://www.numonic.ai/docs/api/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiV1AdminCrmDedupCandidatesCandidateRequest:
      type: object
      properties:
        decision:
          type: string
          description: 'enum: confirm · reject'
        survivor:
          type: string
          description: Hub hash of the record to keep (required for confirm).
        note:
          type: string
      required:
      - decision
    PostApiV1AdminCrmMergesRequest:
      type: object
      properties:
        action:
          type: string
          description: 'enum: merge · unmerge'
        entity_type:
          type: string
          description: 'enum: contact · organization'
        duplicate:
          type: string
          description: Hub hash of the record to retire (or restore).
        survivor:
          type: string
          description: Hub hash of the record to keep (required for merge).
        reason:
          type: string
      required:
      - action
      - entity_type
      - duplicate
    PostApiV1AdminCrmProspectsRequest:
      type: object
      properties:
        prospect:
          type: object
          description: Prospect data.
        record_source:
          type: string
          description: Origin tag.
      required:
      - prospect
      - record_source
    PostApiV1AdminCrmProspectsProspecthTouchesRequest:
      type: object
      properties:
        touch:
          type: object
        record_source:
          type: string
      required:
      - touch
      - record_source
    PostApiV1AnnotationsRequest:
      type: object
      properties:
        workflow_node_id:
          type: string
          description: 40-character hexadecimal workflow node identifier
        content:
          type: string
          description: Annotation text content (1-10000 characters)
        content_type:
          type: string
          description: Content format type
        visibility:
          type: string
          description: 'Visibility level: private, team, public'
      required:
      - workflow_node_id
      - content
    PatchApiV1AnnotationsAnnotationidRequest:
      type: object
      properties:
        content:
          type: string
          description: New annotation content (required)
        visibility:
          type: string
          description: Updated visibility level (optional)
      required:
      - content
    PostApiV1AssetsAssethNotesRequest:
      type: object
      properties:
        asset_id:
          type: string
          description: 40-character hexadecimal asset identifier (the hash in the asset page URL)
        content:
          type: string
          description: Note text (1-10000 characters)
        content_type:
          type: string
          description: Content format type
        visibility:
          type: string
          description: 'Visibility level: private, team, public'
      required:
      - asset_id
      - content
    PatchApiV1CollectionsCollectionhRequest:
      type: object
      properties:
        display_name:
          type: string
          description: New display name (1-255 characters).
        description:
          type: string
          description: New description (1-2000 characters).
    PostApiV1PromptsRequest:
      type: object
      properties:
        tenant_id:
          type: string
          description: Tenant UUID
        prompt_text:
          type: string
          description: The prompt text content
        name:
          type: string
          description: Human-readable prompt name
        description:
          type: string
          description: Prompt description
        target_model:
          type: string
          description: Target model (e.g., midjourney, dall-e, flux)
        category:
          type: string
          description: Prompt category (e.g., landscape, portrait)
        tags:
          type: array
          description: Prompt tags for organization
      required:
      - prompt_text
    PostApiV1PromptsPrompthRenderRequest:
      type: object
      properties:
        tenant_id:
          type: string
          description: Tenant UUID
        variables:
          type: object
          description: Template variables as key-value pairs
    GetApiV1StorageSignedUrlUploadResponse:
      type: object
      properties:
        signedUrl:
          type: string
          description: URL to which the file bytes should be PUT
    PostMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON‑RPC version, e.g., "2.0".
        method:
          type: string
          description: MCP method name.
        params:
          type: object
          description: Method‑specific parameters.
        id:
          type: integer
          description: Request identifier.
      required:
      - jsonrpc
      - method
      - params
      - id
  securitySchemes:
    API_key:
      type: apiKey
      in: header
      name: Authorization or X-API-Key
      x-source: https://www.numonic.ai/docs/api/mcp/quickstart?client=perplexity
tags:
- name: Api
- name: Mcp
security:
- API_key: []