# ContextQ API

**Canonical:** https://apis.io/apis/contextq-dev/contextq-dev-api/  
**Provider:** ContextQ — https://apis.io/providers/contextq-dev/  
**Documentation:** https://app.contextq.dev/docs

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

ContextQ API as documented publicly: 97 operations. Contract generated from the documentation by API Evangelist (2026-11-04); not the provider's own document.

## Operations (60 of 97)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/code/quota` | Code-context quota pre-flight |
| GET | `/api/connectors` | List this tenant's connector sources |
| POST | `/api/connectors` | Create a connector source |
| DELETE | `/api/connectors/{id}` | Delete a connector source |
| GET | `/api/connectors/{id}` | Fetch one connector source |
| PATCH | `/api/connectors/{id}` | Update a connector source |
| POST | `/api/connectors/{id}/sync` | Manually trigger a sync for one connector source |
| GET | `/api/contexts` | List contexts (filterable, paginated) |
| POST | `/api/contexts` | Create a context |
| POST | `/api/contexts/bulk` | Bulk lifecycle/archive patch across many contexts in one call |
| POST | `/api/contexts/bulk-upsert` | Idempotent bulk upsert keyed on externalId (external connector intake) |
| GET | `/api/contexts/by-external/{externalid}` | Fetch a context by its externalId |
| POST | `/api/contexts/merge` | Merge 2-10 contexts into a single target (admin scope) |
| GET | `/api/contexts/quarantine/inbox` | Admin-only unified review inbox for quarantined contexts |
| DELETE | `/api/contexts/{id}` | Delete a context |
| GET | `/api/contexts/{id}` | Fetch a context by id |
| PUT | `/api/contexts/{id}` | Update a context (partial — omitted fields are left unchanged) |
| GET | `/api/contexts/{id}/belief-events` | Append-only ledger of every confidence delta applied to this context (T359) |
| GET | `/api/contexts/{id}/blast-radius` | Fan-out impact analysis before a belief update (T362) |
| GET | `/api/contexts/{id}/chunks` | Block-level chunks for a context, ordered by chunk_index |
| GET | `/api/contexts/{id}/confidence` | Belief confidence & calibration ledger (T359) |
| POST | `/api/contexts/{id}/evolve` | Manually (re-)run memory evolution for an existing context |
| POST | `/api/contexts/{id}/evolve/apply` | Apply selected proposals from a stored evolution review |
| GET | `/api/contexts/{id}/provenance` | Belief provenance chain (T358) walked backward from this context |
| POST | `/api/contexts/{id}/quarantine/review` | Admin resolution of a quarantined context (T350/T364) |
| GET | `/api/contexts/{id}/related` | Semantically-close context candidates (pgvector cosine + tag Jaccard overlap) |
| POST | `/api/contexts/{id}/resolve-contradiction` | Resolve a context disputed by a `contradicts` link (T352) |
| GET | `/api/contexts/{id}/reverify` | Reverification (self-testing memory) clock state + recent attempts (T361) |
| PATCH | `/api/contexts/{id}/reverify` | Opt a context into (or reschedule) the reverification clock (T361) |
| POST | `/api/contexts/{id}/undo-archive` | Undo a memory-evolution auto-archive within the configured window |
| GET | `/api/contexts/{id}/undo-archive-info` | Whether a memory-evolution auto-archive can still be undone |
| GET | `/api/contexts/{id}/versions` | Belief version timeline (T360) — historical snapshots + the live row |
| POST | `/api/contexts/{id}/versions/{seq}/restore` | Restore a context to a prior version_seq (T710) |
| POST | `/api/documents` | Upload one or more documents for async parse + chunk + embed (T383) |
| GET | `/api/federation/subscriptions` | List this tenant's federation subscriptions |
| POST | `/api/federation/subscriptions` | Create a federation subscription |
| DELETE | `/api/federation/subscriptions/{id}` | Unsubscribe (revoke) |
| GET | `/api/federation/subscriptions/{id}` | Fetch one federation subscription |
| PATCH | `/api/federation/subscriptions/{id}` | Update a federation subscription |
| POST | `/api/federation/subscriptions/{id}/pause` | Pause scheduled polling |
| POST | `/api/federation/subscriptions/{id}/resume` | Resume a paused subscription |
| POST | `/api/federation/subscriptions/{id}/rotate-key` | Rotate the TOFU-pinned remote signing key |
| POST | `/api/federation/subscriptions/{id}/rotate-webhook-secret` | Issue a new inbound webhook HMAC secret |
| POST | `/api/federation/subscriptions/{id}/sync` | Manually trigger a pull |
| POST | `/api/federation/webhook/{id}` | Inbound nudge from the publishing instance |
| POST | `/api/goal/sync` | Bulk-upsert a ctq-tasks manifest push |
| GET | `/api/hook-endpoints` | List this tenant's admission endpoints in call order |
| POST | `/api/hook-endpoints` | Register an admission endpoint |
| DELETE | `/api/hook-endpoints/{id}` | Delete an admission endpoint, its grant and its counters |
| GET | `/api/hook-endpoints/{id}` | Fetch one admission endpoint with its hourly counters for the last 7 days |
| PATCH | `/api/hook-endpoints/{id}` | Update an admission endpoint |
| PUT | `/api/hook-endpoints/{id}/content-grant` | PUT /api/hook-endpoints/{id}/content-grant |
| POST | `/api/hook-endpoints/{id}/rotate-secret` | Replace the signing secret; the new one is returned once |
| GET | `/api/hook-rules` | List this tenant's hook rules in evaluation order |
| POST | `/api/hook-rules` | Create a hook rule |
| POST | `/api/hook-rules/dry-run` | Evaluate a candidate context against the saved rules (or one unsaved rule) without writing |
| DELETE | `/api/hook-rules/{id}` | Delete a hook rule |
| GET | `/api/hook-rules/{id}` | Fetch one hook rule with its hourly counters for the last 7 days |
| PATCH | `/api/hook-rules/{id}` | Update a hook rule |
| POST | `/api/interchange/export` | Export a signed Memory Interchange Format (MIF) bundle |

…and 37 more operations. They are listed in full on the page.

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/contextq-dev/openapi/_ae-authored/contextq-dev-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/contextq-dev/json-schema/contextq-dev-post-api-webhook-endpoints-id-test-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/contextq-dev/json-schema/contextq-dev-post-api-goal-sync-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/contextq-dev/json-schema/contextq-dev-post-api-goal-sync-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contextq-dev/json-schema/contextq-dev-get-plugin-install-sh-response-schema.json

## Other ContextQ APIs (1)

- [ContextQ API](https://apis.io/apis/contextq-dev/contextq-api/)

---

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