CoreStory User API
The user API from CoreStory — 3 operation(s) for user.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/corestory-user-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Crowdbotics API Documentation User 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:
- name: User
paths:
/api/user/activity-stats:
get:
tags:
- User
summary: Get user activity statistics
description: Retrieve activity statistics for the currently authenticated user
operationId: get_user_activity_stats
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserActivityStatsResponse'
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorSchema'
/api/user/recent-conversations:
get:
tags:
- User
summary: Get recent conversations
description: Retrieve a list of recent conversations for the currently authenticated user
operationId: get_recent_conversations
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
description: 'Number of recent conversations to retrieve (default: 10, max: 50)'
default: 10
title: Limit
description: 'Number of recent conversations to retrieve (default: 10, max: 50)'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/RecentConversationsResponse'
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorSchema'
/api/user/onboarding-profile:
get:
tags:
- User
summary: Get user onboarding profile
description: Retrieve the onboarding profile for the currently authenticated user
operationId: get_user_onboarding_profile
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserOnboardingProfileResponse'
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorSchema'
put:
tags:
- User
summary: Upsert user onboarding profile
description: Create or update the onboarding profile for the currently authenticated user (idempotent).
operationId: upsert_user_onboarding_profile
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UserOnboardingProfileUpsertRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserOnboardingProfileResponse'
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorSchema'
components:
schemas:
UserActivityStatsResponse:
properties:
total_codebases:
type: integer
title: Total Codebases
description: Total number of projects (codebases) created or accessible to the user
total_conversations:
type: integer
title: Total Conversations
description: Total number of conversations across all of the user's projects
type: object
required:
- total_codebases
- total_conversations
title: UserActivityStatsResponse
description: User's activity statistics
example:
total_codebases: 5
total_conversations: 12
ErrorSchema:
properties:
error:
$ref: '#/components/schemas/ErrorBody'
type: object
required:
- error
title: ErrorSchema
RecentConversationItem:
properties:
id:
type: integer
title: Id
description: Conversation ID
title:
type: string
title: Title
description: Conversation title
project_id:
type: integer
title: Project Id
description: ID of the project the conversation belongs to
project_name:
anyOf:
- type: string
- type: 'null'
title: Project Name
description: Name of the project the conversation belongs to
created_at:
type: string
format: date-time
title: Created At
description: Conversation creation timestamp
type: object
required:
- id
- title
- project_id
- created_at
title: RecentConversationItem
description: A single recent conversation entry.
UserOnboardingProfileResponse:
properties:
id:
type: string
title: Id
description: Unique identifier for the onboarding profile
user_id:
type: string
title: User Id
description: ID of the user this profile belongs to
organization_id:
type: string
title: Organization Id
description: ID of the organization this profile is scoped to
role:
type: string
title: Role
description: User's professional role (e.g. developer, product_manager)
goals:
items:
type: string
type: array
title: Goals
description: List of user's onboarding goals
path_type:
type: string
title: Path Type
description: Preferred onboarding workflow path (e.g. ide_first, docs_first)
preferences:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Preferences
description: Flexible JSONB bucket for user preferences
completed_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Completed At
description: When onboarding was completed or skipped, or null
created_at:
type: string
format: date-time
title: Created At
description: When the profile was created
updated_at:
type: string
format: date-time
title: Updated At
description: When the profile was last updated
type: object
required:
- id
- user_id
- organization_id
- role
- goals
- path_type
- created_at
- updated_at
title: UserOnboardingProfileResponse
description: Response schema for user onboarding profile retrieval.
example:
created_at: '2026-01-01T00:00:00Z'
goals:
- improve_code_quality
- speed_up_reviews
id: 550e8400-e29b-41d4-a716-446655440000
organization_id: 550e8400-e29b-41d4-a716-446655440002
path_type: ide_first
role: developer
updated_at: '2026-01-01T00:00:00Z'
user_id: 550e8400-e29b-41d4-a716-446655440001
ErrorBody:
properties:
message:
type: string
title: Message
type:
type: string
title: Type
details:
additionalProperties: true
type: object
title: Details
description: Optional extra context for the error.
type: object
required:
- message
- type
title: ErrorBody
UserOnboardingProfileUpsertRequest:
properties:
role:
$ref: '#/components/schemas/UserRole'
description: User's professional role
goals:
items:
type: string
type: array
title: Goals
description: List of user's onboarding goals
path_type:
$ref: '#/components/schemas/OnboardingPathType'
description: Preferred onboarding workflow path
preferences:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Preferences
description: Flexible JSONB bucket for user preferences
completed_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Completed At
description: When onboarding was completed or skipped
type: object
required:
- role
- goals
- path_type
title: UserOnboardingProfileUpsertRequest
description: 'Request schema for the idempotent PUT upsert endpoint.
role, goals, and path_type are required (needed for creation).
preferences and completed_at are optional.'
UserRole:
type: string
enum:
- developer
- engineering_manager
- architect
- business_analyst
- product_manager
- compliance_audit
title: UserRole
description: User's professional role for onboarding profile.
OnboardingPathType:
type: string
enum:
- ide_first
- docs_first
title: OnboardingPathType
description: User's preferred onboarding workflow path.
RecentConversationsResponse:
properties:
conversations:
items:
$ref: '#/components/schemas/RecentConversationItem'
type: array
title: Conversations
description: List of recent conversations with their details
type: object
required:
- conversations
title: RecentConversationsResponse
description: Response schema for recent conversations
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Enter the Bearer token from Clerk authentication
x-tagGroups:
- name: Ingest Your Codebase
tags:
- vector_store
- projects
- pre_ingestion
- reingestion
- name: Generate Code Intelligence
tags:
- documents
- document_generation
- document_formatters
- prd
- prd_version
- tech_spec
- quality_metrics
- sample_projects
- name: Query Your Codebase
tags:
- conversations
- workflows
- discovery
- context
- artifacts
- name: Manage and Inspect Intelligence
tags:
- api_debugging
- events
- version
- files
- cache
- token_tracking
- name: Authenticate and Manage Access
tags:
- clerk_authentication
- github_webhooks
- github_integration
- organizations
- api_key_management
- mcp_token_management
- user
- name: (Advanced) Prompt Tuning
tags:
- prompts
- name: MCP Protocol
tags:
- mcp_protocol
- name: Administration
tags:
- admin