# AI Demos Research API

**Canonical:** https://apis.io/apis/aidemos-com/aidemos-com-research-api/  
**Provider:** AI Demos — https://apis.io/providers/aidemos-com/  
**Documentation:** https://aidemos.com/docs/mcp

AI Demos Research API is one of 38 APIs that [AI Demos](https://apis.io/providers/aidemos-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Research. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The research API from AI Demos — 223 operation(s) for research.

## Operations (60 of 253)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/research/registry` | Registry |
| GET | `/v2/research/defaults` | Defaults |
| GET | `/v2/research/id/{code}` | Resolve Short Code |
| GET | `/v2/research/actors` | List Actors |
| POST | `/v2/research/actors` | Create Actor |
| GET | `/v2/research/capabilities` | List Capabilities |
| POST | `/v2/research/capabilities` | Create Capability |
| GET | `/v2/research/capabilities/{id_or_slug}` | Get Capability |
| PATCH | `/v2/research/capabilities/{capability_id}` | Patch Capability |
| POST | `/v2/research/capabilities/{capability_id}/scenarios/{scenario_id}` | Tag Scenario |
| DELETE | `/v2/research/capabilities/{capability_id}/scenarios/{scenario_id}` | Untag Scenario |
| POST | `/v2/research/scenarios/search` | Search Scenarios |
| POST | `/v2/research/scenarios/reindex` | Reindex Scenarios |
| GET | `/v2/research/scenarios` | List Scenarios |
| POST | `/v2/research/scenarios` | Create Scenario |
| GET | `/v2/research/scenarios/{id_or_slug}` | Get Scenario |
| PATCH | `/v2/research/scenarios/{scenario_id}` | Patch Scenario |
| GET | `/v2/research/scenarios/{scenario_id}/rubric-versions` | List Rubric Versions |
| POST | `/v2/research/scenarios/{scenario_id}/rubric-versions` | Add Rubric Version |
| GET | `/v2/research/subjects` | List Subjects |
| POST | `/v2/research/subjects` | Create Subject |
| GET | `/v2/research/subject-identity-questions` | List Identity Questions |
| POST | `/v2/research/subject-identity-questions/{question_id}/answer` | Answer Identity Question |
| POST | `/v2/research/subjects/reconcile-catalog-tool` | Reconcile Catalog Tool |
| GET | `/v2/research/subjects/{id_or_slug}` | Get Subject |
| PATCH | `/v2/research/subjects/{subject_id}` | Patch Subject |
| GET | `/v2/research/test-cases` | List Test Cases |
| POST | `/v2/research/test-cases` | Create Test Case |
| GET | `/v2/research/test-cases/{id_or_slug}` | Get Test Case |
| GET | `/v2/research/test-case-versions/{version_id}` | Get Test Case Version |
| PATCH | `/v2/research/test-cases/{test_case_id}` | Patch Test Case |
| POST | `/v2/research/test-cases/{test_case_id}/versions` | Add Test Case Version |
| POST | `/v2/research/test-case-versions/{test_case_version_id}/focus` | Add Test Case Focus |
| GET | `/v2/research/test-case-versions/{test_case_version_id}/focus` | Get Test Case Focus |
| DELETE | `/v2/research/test-case-versions/{test_case_version_id}/focus/{artifact_id}/{ord}` | Delete Test Case Focus |
| GET | `/v2/research/test-case-versions/{test_case_version_id}/input-manifest` | Input Manifest |
| PUT | `/v2/research/test-case-versions/{test_case_version_id}/resource-artifacts` | Select Resource Artifacts |
| GET | `/v2/research/artifacts/{artifact_id}` | Resolve Artifact |
| GET | `/v2/research/artifacts` | List Artifacts |
| POST | `/v2/research/test-case-versions/{test_case_version_id}/artifacts` | Pin Artifact |
| DELETE | `/v2/research/test-case-versions/{test_case_version_id}/artifacts/{artifact_id}` | Unpin Artifact |
| POST | `/v2/research/bulk-attach` | Bulk Attach |
| GET | `/v2/research/benchmarks` | List Benchmarks |
| POST | `/v2/research/benchmarks` | Create Benchmark |
| GET | `/v2/research/benchmarks/{id_or_slug}` | Get Benchmark |
| POST | `/v2/research/benchmarks/{benchmark_id}/versions` | Add Benchmark Version |
| GET | `/v2/research/benchmark-versions/{version_id}` | Get Benchmark Version |
| PUT | `/v2/research/benchmark-versions/{version_id}/scope` | Set Scope |
| PUT | `/v2/research/benchmark-versions/{version_id}/subjects` | Set Subjects |
| POST | `/v2/research/benchmark-versions/{version_id}/subjects` | Add Subject |
| PUT | `/v2/research/benchmark-versions/{version_id}/test-cases` | Set Test Cases |
| POST | `/v2/research/benchmark-versions/{version_id}/freeze` | Freeze |
| POST | `/v2/research/benchmark-versions/{version_id}/retire` | Retire |
| GET | `/v2/research/benchmark-versions/{version_id}/coverage` | Coverage |
| POST | `/v2/research/drafting/run` | Submit Drafting |
| GET | `/v2/research/drafting/stats` | Drafting Stats |
| POST | `/v2/research/scenarios/{scenario_id}/review` | Review Scenario |
| GET | `/v2/research/reading-policies` | List Reading Policies |
| POST | `/v2/research/reading-policies` | Create Reading Policy |
| POST | `/v2/research/benchmark-versions/{version_id}/rebuild-cells` | Rebuild Cells |

…and 193 more operations. The page lists the first 250; the full set of 253 is in the OpenAPI linked below.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aidemos-com/openapi/aidemos-com-research-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/aidemos-com/json-schema/aidemos-com-event-in-schema.json
- **JSONSchema** — https://artifacts.apis.io/aidemos-com/json-schema/aidemos-com-recorded-evidence-in-schema.json
- **JSONSchema** — https://artifacts.apis.io/aidemos-com/json-schema/aidemos-com-visibility-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/aidemos-com/json-schema/aidemos-com-resource-in-schema.json
- **JSONSchema** — https://artifacts.apis.io/aidemos-com/json-schema/aidemos-com-app-api-research-capture-run-in-schema.json
- **JSONSchema** — https://artifacts.apis.io/aidemos-com/json-schema/aidemos-com-run-fact-hold-in-schema.json

## Other AI Demos APIs (12)

- [AI Demos Admin API](https://apis.io/apis/aidemos-com/aidemos-com-admin-api/)
- [AI Demos Admin Homepage API](https://apis.io/apis/aidemos-com/aidemos-com-admin-homepage-api/)
- [AI Demos Aggregates API](https://apis.io/apis/aidemos-com/aidemos-com-aggregates-api/)
- [AI Demos company relationships API](https://apis.io/apis/aidemos-com/aidemos-com-company-relationships-api/)
- [AI Demos Content API](https://apis.io/apis/aidemos-com/aidemos-com-content-api/)
- [AI Demos Embed API](https://apis.io/apis/aidemos-com/aidemos-com-embed-api/)
- [AI Demos Engagement API](https://apis.io/apis/aidemos-com/aidemos-com-engagement-api/)
- [AI Demos Health API](https://apis.io/apis/aidemos-com/aidemos-com-health-api/)
- [AI Demos Image API](https://apis.io/apis/aidemos-com/aidemos-com-image-api/)
- [AI Demos Jobs API](https://apis.io/apis/aidemos-com/aidemos-com-jobs-api/)
- [AI Demos MCP API](https://apis.io/apis/aidemos-com/aidemos-com-mcp-api/)
- [AI Demos Media API](https://apis.io/apis/aidemos-com/aidemos-com-media-api/)

## Tags

Research

---

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