# Numonic Ltd. API

**Canonical:** https://apis.io/apis/numonic-ai/numonic-ai-api/  
**Provider:** Numonic Ltd. — https://apis.io/providers/numonic-ai/  
**Documentation:** https://www.numonic.ai/docs/api/mcp

Numonic Ltd. API is one of 2 APIs that [Numonic Ltd.](https://apis.io/providers/numonic-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

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.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/numonic-ai/openapi/_ae-authored/numonic-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/numonic-ai/json-schema/numonic-ai-post-api-v1-prompts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/numonic-ai/json-schema/numonic-ai-post-api-v1-admin-crm-merges-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/numonic-ai/json-schema/numonic-ai-post-api-v1-annotations-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/numonic-ai/json-schema/numonic-ai-post-api-v1-assets-asseth-notes-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/numonic-ai/json-schema/numonic-ai-post-mcp-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/numonic-ai/json-schema/numonic-ai-post-api-v1-admin-crm-dedup-candidates-candidate-request-schema.json

## Other Numonic Ltd. APIs (1)

- [Numonic AI API](https://apis.io/apis/numonic-ai/numonic-ai-api-2/)

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/numonic-ai` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/numonic-ai/numonic-ai-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/numonic-ai/.
