# Curiosity API **Canonical:** https://apis.io/apis/curiosity/curiosity-api/ **Provider:** Curiosity — https://apis.io/providers/curiosity/ **Base URL:** https:///api **Documentation:** https://docs.curiosity.ai/workspace-learning/07-apis-endpoints/02-authentication Curiosity API is one of 2 APIs that [Curiosity](https://apis.io/providers/curiosity/) 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. Curiosity API as documented publicly: 47 operations. Contract generated from the documentation by API Evangelist (2026-10-12); not the provider's own document. ## Operations (47) | Method | Path | Summary | |---|---|---| | POST | `/api/admin-agent/sessions/{id}/commit/approve` | Approve a session commit; streams log and result events. | | POST | `/api/admin-agent/sessions/{id}/uploads` | Attach a file to an admin‑assistant conversation. | | GET | `/api/build/{buildid}` | Everything the admin Build tree draws, in one call and with no source code in it. | | POST | `/api/cce/{name}` | Lower-level invocation alias used by the front-end. | | POST | `/api/chatai/chat` | Send a turn to the chat assistant. Used by the built-in chat view. | | GET | `/api/chatai/deep-research/settings` | The deep research queue limits, the workspace's researchers, and the runs executing or queued right now. Admin only. | | POST | `/api/chatai/deep-research/{deepresearchid}` | Stop the deep research running in a conversation. Admin, write access. | | GET | `/api/chatai/tools/metrics` | Per-tool invocation metrics (counts, average latency, error rate). Admin only. | | GET | `/api/code/history/all` | The workspace change‑history timeline, newest first, backing Manage → Operate → Change History. | | GET | `/api/embeddings/{embeddingid}` | Reference for the embeddings surface in Curiosity Studio: how to encode text, query for similar nodes, and project embeddings for visualization. | | POST | `/api/embeddings/{embeddingid}` | Reference for the embeddings surface in Curiosity Studio: how to encode text, query for similar nodes, and project embeddings for visualization. | | GET | `/api/endpoints/metrics` | Per-endpoint invocation metrics. Admin only. | | GET | `/api/endpoints/run/similar-tickets` | Custom endpoint invocation – Example — calling a custom endpoint. | | POST | `/api/endpoints/run/{name}` | Custom endpoints | | POST | `/api/endpoints/token/run/{name}` | Authentication | | POST | `/api/graph/import-definitions` | Import definitions to a workspace; streams log and result events. | | GET | `/api/graph/logs-files/download` | Every match of a historical log search, streamed as one .log file. | | GET | `/api/graph/stats/{statid}` | The per‑node‑type / per‑edge‑type database counters, as the aligned table the server logs periodically. | | PUT | `/api/groups/group` | Create or update a group (behaviour changes section). | | PUT | `/api/groups/group/{groupuid}` | Update a specific group identified by UID. | | POST | `/api/groups/group/{groupuid}/delete` | Delete a specific group identified by UID. | | GET | `/api/groups/group/{groupuid}/users` | GET /api/groups/group/{groupUID}/users | | GET | `/api/login/check` | Verify a session JWT is still valid. | | POST | `/api/login/create` | Authenticate via the login endpoint. | | POST | `/api/login/password/{passwordid}` | Change the calling user's password. | | POST | `/api/migrations/{migrationid}` | Migration jobs (admin, write access). POST /api/migrations/cancel cancels the run and waits up to 30 seconds for it to stop, so a caller can rewrite or reset... | | POST | `/api/node/download/csv` | search results – the CSV / JSON Lines / Excel downloads (POST /api/node/download/csv, download/jsonl, download/zip). | | POST | `/api/node/download/synthetic/{syntheticid}` | Synthetic sample downloads (any signed-in, non-guest user). POST /api/node/download/synthetic/csv no longer take a baseURL query parameter — the export now c... | | POST | `/api/node/many/{manyid}` | User record field visibility – The projection applies to every generic reader: POST /api/node/many/field (which answers BLOCKED for a field the caller may no... | | POST | `/api/node/query` | User record field visibility – The projection applies to every generic reader: POST /api/node/query. | | GET | `/api/node/{uid}` | User record field visibility – The projection applies to every generic reader: GET /api/node/{uid}. | | POST | `/api/saml/acs` | Assertion Consumer Service endpoint — the SAML callback. | | GET | `/api/saml/createrequest/{providername}/{issuer}/{destination}` | Builds an AuthnRequest for the configured provider. | | GET | `/api/search/settings/llm` | Which node types and search filters the built-in search tool exposes to an assistant, plus every filter available for the enabled node types. Admin only. | | PUT | `/api/search/settings/llm` | Store the exposed node types and filters. An empty set restores the built-in defaults. Admin, write access. | | GET | `/api/search/synonyms/for` | The synonyms, alternates, blocked terms and suggested candidates for one term. | | PUT | `/api/search/synonyms/for` | Store the Synonyms, Alternates and Blocked lists for one term — all three are required, send [] for unused ones. | | GET | `/api/search/synonyms/list/for` | Every term that has synonyms configured for a language. | | POST | `/api/{provider}/config` | Update the SSO config (admin only). | | GET | `/api/{provider}/{id}` | Callback the identity provider redirects back to after the user authenticates. | | POST | `/chat/completions` | POST /chat/completions | | GET | `/install.sh` | Download install script | | GET | `/models` | GET /models | | POST | `/v1/messages` | POST /v1/messages | | POST | `/v1/messages/count_tokens` | POST /v1/messages/count_tokens | | GET | `/v1/models` | GET /v1/models | | GET | `/v1/models/{id}` | GET /v1/models/{id} | ## Machine-readable artifacts (7) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/openapi/_ae-authored/curiosity-openapi-generated.yml - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/json-schema/curiosity-post-v1-messages-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/json-schema/curiosity-post-chat-completions-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/json-schema/curiosity-put-api-search-synonyms-for-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/json-schema/curiosity-post-api-embeddings-embeddingid-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/json-schema/curiosity-put-api-search-settings-llm-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/curiosity/refs/heads/main/json-schema/curiosity-post-api-login-password-passwordid-request-schema.json ## Other Curiosity APIs (1) - [Curiosity Workspace API](https://apis.io/apis/curiosity/curiosity-workspace-api/) --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/curiosity/curiosity-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/curiosity/.