How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
CoreStory

CoreStory conversations API

The conversations API from CoreStory — 11 operation(s) for conversations.

Documentation Provider Profile APIs.io OpenAPI GitHub

CoreStory conversations API is one of 47 APIs that CoreStory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Conversations. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 17 operations across 11 paths, and defines 21 schemas. It is described by OpenAPI 3.2.0, at version 1.26.2.

Requests are made against a single base URL, /.

17 operations 11 paths 21 schemas 2 DELETE7 GET4 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.26.2
Base URL
https://c2s.corestory.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

CoreStory conversations API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Enter the Bearer token from Clerk authentication

Paths & Operations 17

Across 11 paths, the API surfaces 17 operations — 2 DELETE, 7 GET, 4 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

conversations 17
GET
/api/projects/{project_id}/chat/conversations/
Get all Project's conversations for a User with pagination
list_conversations 3 params → 200default
POST
/api/projects/{project_id}/chat/conversations/
Create a new conversation
create_conversation 1 param body → 201default
GET
/api/projects/{project_id}/chat/conversations/listdeprecated
DEPRECATED: Get all Project's conversations for a User with pagination
list_conversations_deprecated 3 params → 200default
GET
/api/projects/{project_id}/chat/conversations/{conversation_id}
Get conversation details with settings and metadata
get_conversation 2 params → 200default
PATCH
/api/projects/{project_id}/chat/conversations/{conversation_id}
Update conversation
update_conversation 2 params body → 200default
DELETE
/api/projects/{project_id}/chat/conversations/{conversation_id}
Delete a conversation
delete_conversation 2 params → 204default
GET
/api/projects/{project_id}/chat/conversations/{conversation_id}/messages
Get all chat messages for a conversation
get_conversation_messages 2 params → 200default
POST
/api/projects/{project_id}/chat/conversations/{conversation_id}/messages
Add Chat Message
add_chat_message 2 params body → 200default422
DELETE
/api/projects/{project_id}/chat/conversations/{conversation_id}/messages
Clear all messages from a conversation
clear_conversation_messages 2 params → 204default
GET
/api/projects/{project_id}/chat/conversations/{conversation_id}/messages/{message_id}/sources
Get source files for a chat message
get_message_sources 3 params → 200default
PATCH
/api/projects/{project_id}/chat/conversations/{conversation_id}/messages/{message_id}/feedback
Submit feedback on a chat message
update_message_feedback 3 params body → 200default
GET
/api/projects/{project_id}/chat/conversations/{conversation_id}/settingsdeprecated
Get conversation settings
get_conversation_settings 2 params → 200default
PATCH
/api/projects/{project_id}/chat/conversations/{conversation_id}/settingsdeprecated
Update conversation settings
update_conversation_settings 2 params body → 200default
PATCH
/api/projects/{project_id}/chat/conversations/{conversation_id}/export
Generate a shareable link for a conversation
export_conversation 2 params → 200default
GET
/api/projects/{project_id}/chat/conversations/{conversation_id}/import
Import a shared conversation into your account
import_conversation 2 params → 201default
POST
/api/projects/{project_id}/chat/conversations/create-conversationdeprecated
DEPRECATED: Create a new conversation
create_conversation_deprecated 1 param body → 201default
POST
/api/projects/{project_id}/chat/conversations/{conversation_id}/new-messagedeprecated
DEPRECATED: Add a chat message to a conversation
add_chat_message_deprecated 2 params body → 200default

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are ImportConversationResponse (16 properties), ConversationResponse (15 properties), ChatMessageResponse (8 properties), SourceReferenceResponse (7 properties). Each schema is shown below with its type and property counts.

MessageFeedbackRequest
object
Request model for providing feedback on a chat message
1 property 1 required
ChatPersona
string
Personas for chat behavior customization
PaginatedConversationListResponse
object
Response model for paginated conversation list
4 properties 4 required
ConversationSettingsResponse
object
Response model for conversation settings (deprecated: settings now in ConversationResponse)
5 properties 5 required
ConversationExportResponse
object
Response model for conversation export/sharing. Contains the conversation details and a shareable link that other users can use to import the conversation into…
5 properties 5 required
UpdateConversationRequest
object
Request model for partially updating conversation details
5 properties
ImportConversationResponse
object
Response model for imported conversation with backward-compatible status field.
16 properties 8 required
ConversationSettingsRequest
object
Request model for updating conversation settings (deprecated: use UpdateConversationRequest)
2 properties
ErrorSchema
object
1 property 1 required
ChatMessageResponse
object
Response model for chat message data
8 properties 7 required
MessageFeedbackResponse
object
Response model for message feedback operations
2 properties 2 required
QueryRequest
object
6 properties 1 required
ConversationCreateRequest
object
Request model for creating a conversation
4 properties 1 required
ContextScope
string
Context scope for knowledge retrieval
ImportStatus
string
ConversationMeta
object
Metadata about conversation messages.
3 properties
ConversationOrigin
string
Origin source of conversation creation
SourceReferenceResponse
object
Response model for source references
7 properties 5 required
FeedbackType
string
Types of user feedback
ConversationResponse
object
Response model for conversation data with settings and metadata
15 properties 8 required
ErrorBody
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

corestory-conversations-api-openapi.yml Raw ↑

Other APIs CoreStory publishes across the network.

CoreStory admin API
AE Profile APIs.io
CoreStory api_debugging API
AE Profile APIs.io
CoreStory api_key_management API
AE Profile APIs.io
CoreStory artifacts API
AE Profile APIs.io
CoreStory billing API
AE Profile APIs.io
CoreStory cache API
AE Profile APIs.io
CoreStory ciu API
AE Profile APIs.io
CoreStory clerk_authentication API
AE Profile APIs.io
CoreStory context API
AE Profile APIs.io
CoreStory discovery API
AE Profile APIs.io
CoreStory document_formatters API
AE Profile APIs.io
CoreStory document_generation API
AE Profile APIs.io
#Conversations
← Back to C APIs
API Details
ID
corestory:corestory-conversations-api
Base URL
https://c2s.corestory.ai
Docs
https://docs.corestory.ai
Provider
CoreStory
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=corestory-conversations-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/corestory-conversations-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of CoreStory conversations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.