CoreStory

CoreStory Projects API

The projects API from CoreStory — 40 operation(s) for projects.

GitHub OpenAPI

Operations 46

POST /api/projects Create a new project with auto-generated PRD #
GET /api/projects Get organization projects with pagination #
POST /api/projects/create-and-generate Create a new project with auto-generated PRD and ingestion #
PATCH /api/projects/{project_id} Update project #
GET /api/projects/{project_id} Get project details #
POST /api/projects/{project_id}/transfer Transfer project to another organization #
GET /api/projects/{project_id}/status Lightweight polling status for ingestion and generation jobs #
GET /api/projects/{project_id}/pending-commits Get pending commits for a project #
GET /api/projects/{project_id}/health Get project health signals, code quality, and security findings #
GET /api/projects/{project_id}/tech-spec Get the project's Tech Spec (not base PRD) sections data #
GET /api/projects/{project_id}/prd/status Get the project's PRD generation status #
GET /api/projects/{project_id}/tech-spec/status Get the project's tech-spec generation status #
GET /api/projects/{project_id}/prd Get the project's PRD (not tech spec) sections data #
DELETE /api/projects/{project_id}/delete Delete a project #
GET /api/projects/{project_id}/metrics/processing/summary Get latest ingestion/generation metrics for a project #
POST /api/projects/upload-repository Upload repository files and create project #
POST /api/projects/upload-repository-from-pre-ingestion Create project from an existing pre-ingestion upload #
POST /api/projects/{project_id}/prd/generate Generate the PRD sections (no Tech Spec sections) for the project #
POST /api/projects/{project_id}/tech-spec/generate Generate the Tech Spec sections (no base PRD sections) for the project #
POST /api/projects/{project_id}/prd/generate-all Generate all PRD and tech spec sections for the project #
GET /api/projects/{project_id}/prd/context Get the context for the project's latest PRD #
POST /api/projects/{project_id}/prd/context Set or update the context for the project's latest PRD #
GET /api/projects/{project_id}/prd/user-stories/catalog Get a catalog of user stories items for UI faceted browsing #
GET /api/projects/{project_id}/tech-spec/tech-user-stories/catalog Get a catalog of user stories items for UI faceted browsing #
POST /api/projects/{project_id}/reingestion/analyze Start pre-reingestion analysis for an existing project #
GET /api/projects/{project_id}/reingestion/analyze/{job_id}/status Get reingestion analysis job status #
GET /api/projects/{project_id}/reingestion/analyze/{job_id}/coverage Get coverage results from reingestion analysis #
GET /api/projects/{project_id}/reingestion/analyze/{job_id}/excluded-files Get excluded file paths from reingestion analysis #
GET /api/projects/{project_id}/reingestion/analyze/{job_id}/included-files Get included file paths from reingestion analysis #
DELETE /api/projects/{project_id}/reingestion/analyze/{job_id} Delete a reingestion analysis job #
POST /api/projects/{project_id}/reingestion/trigger Trigger full reingestion for an existing project #
GET /api/projects/{project_id}/ingestion-events List ingestion events for a project #
GET /api/projects/{project_id}/ingestion-events/{event_id}/doc-impact Doc-section impact (added/modified/removed) for an ingestion event #
POST /api/projects/{project_id}/clone Clone Project #
POST /api/projects/{project_id}/prd/{section_name}/generate Generate a specific PRD section #
POST /api/projects/{project_id}/tech-spec/{section_name}/generate Generate a specific Tech Spec section #
PATCH /api/projects/{project_id}/prd/{section_name} Update the specified PRD section #
GET /api/projects/{project_id}/prd/{section_name} Get the specified PRD section #
PATCH /api/projects/{project_id}/tech-spec/{section_name} Update the specified Tech Spec section #
GET /api/projects/{project_id}/tech-spec/{section_name} Get the specified Tech Spec section #
GET /api/projects/{project_id}/file-manifest Get the complete file manifest for a project #
GET /api/projects/{project_id}/file-content Stream file content from vector store by file path #
GET /api/projects/{project_id}/file-content/metadata Get file metadata from vector store #
GET /api/projects/{project_id}/config Get project operator config (stored overrides + effective values) #
PATCH /api/projects/{project_id}/config Update project operator config (partial merge) #
PATCH /api/projects/{project_id}/sync-mode Set project sync mode (manual or auto) #

Documentation

📖
APIReference
https://c2s.corestory.ai/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/corestory/refs/heads/main/openapi/corestory-projects-api-openapi.yml

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/corestory-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

corestory-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Crowdbotics API Documentation Projects API
  description: '# CoreStory API Overview


    The CoreStory API provides programmatic access to structured insights derived from software source code.'
  version: 1.26.2
servers:
- url: /
  description: Current server
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (135 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/corestory/refs/heads/main/openapi/corestory-projects-api-openapi.yml