Fincept Terminal Chat API
The chat API from Fincept Terminal — 12 operation(s) for chat.
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/fincept-in:fincept-in-chat-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: Fincept In Chat API
version: 3.0.0
description: 'Operations tagged chat across 2 of this provider''s published API definitions: fincept-in-openapi.json, fincept-in-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Chat
paths:
/chat/sessions:
get:
tags:
- Chat
summary: Get Chat Sessions
description: Get user's chat sessions.
operationId: get_chat_sessions_chat_sessions_get
security:
- APIKeyHeader: []
parameters:
- name: limit
in: query
required: false
schema:
type: integer
default: 50
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Chat
summary: Create Chat Session
description: Create new chat session.
operationId: create_chat_session_chat_sessions_post
security:
- APIKeyHeader: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ChatSessionCreate'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/sessions/bulk-delete:
delete:
tags:
- Chat
summary: Bulk Delete Sessions
description: Bulk delete chat sessions.
operationId: bulk_delete_sessions_chat_sessions_bulk_delete_delete
requestBody:
content:
application/json:
schema:
additionalProperties: true
type: object
title: Session Data
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
/chat/sessions/{session_uuid}:
get:
tags:
- Chat
summary: Get Chat Session
description: Get specific chat session with messages.
operationId: get_chat_session_chat_sessions__session_uuid__get
security:
- APIKeyHeader: []
parameters:
- name: session_uuid
in: path
required: true
schema:
type: string
title: Session Uuid
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Chat
summary: Delete Chat Session
description: Delete chat session and all messages.
operationId: delete_chat_session_chat_sessions__session_uuid__delete
security:
- APIKeyHeader: []
parameters:
- name: session_uuid
in: path
required: true
schema:
type: string
title: Session Uuid
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/sessions/{session_uuid}/save-message:
post:
tags:
- Chat
summary: Save Chat Message
description: Save a message — kept for transition. Deduplicates against auto-persisted messages.
operationId: save_chat_message_chat_sessions__session_uuid__save_message_post
security:
- APIKeyHeader: []
parameters:
- name: session_uuid
in: path
required: true
schema:
type: string
title: Session Uuid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ChatMessageSave'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/sessions/{session_uuid}/activate:
put:
tags:
- Chat
summary: Activate Chat Session
description: Activate a chat session (deactivates others).
operationId: activate_chat_session_chat_sessions__session_uuid__activate_put
security:
- APIKeyHeader: []
parameters:
- name: session_uuid
in: path
required: true
schema:
type: string
title: Session Uuid
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/sessions/{session_uuid}/title:
put:
tags:
- Chat
summary: Update Chat Title
description: Update chat session title.
operationId: update_chat_title_chat_sessions__session_uuid__title_put
security:
- APIKeyHeader: []
parameters:
- name: session_uuid
in: path
required: true
schema:
type: string
title: Session Uuid
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: true
title: Title Data
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/stats:
get:
tags:
- Chat
summary: Get Chat Statistics
description: Get chat statistics for current user.
operationId: get_chat_statistics_chat_stats_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security:
- APIKeyHeader: []
/chat/export:
post:
tags:
- Chat
summary: Export Chat Sessions
description: Export chat sessions to JSON.
operationId: export_chat_sessions_chat_export_post
requestBody:
content:
application/json:
schema:
additionalProperties: true
type: object
title: Export Data
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
/chat/search:
get:
tags:
- Chat
summary: Search Chat Messages
description: Search chat messages.
operationId: search_chat_messages_chat_search_get
security:
- APIKeyHeader: []
parameters:
- name: query
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Query
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Q
- name: limit
in: query
required: false
schema:
type: integer
default: 20
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/optimize-prompt:
post:
tags:
- Chat
summary: Optimize Prompt
description: 'Optimize a user''s prompt (one LLM call). Cost: 1 credit, refunded if it fails.'
operationId: optimize_prompt_chat_optimize_prompt_post
requestBody:
content:
application/json:
schema:
additionalProperties: true
type: object
title: Body
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
/chat/admin/statistics:
get:
tags:
- Chat
summary: Get Admin Chat Statistics
description: Get system-wide chat statistics (admin only).
operationId: get_admin_chat_statistics_chat_admin_statistics_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security:
- APIKeyHeader: []
/chat/admin/sessions:
get:
tags:
- Chat
summary: Get Admin Chat Sessions
description: Get all chat sessions with pagination (admin only).
operationId: get_admin_chat_sessions_chat_admin_sessions_get
security:
- APIKeyHeader: []
parameters:
- name: page
in: query
required: false
schema:
type: integer
default: 1
title: Page
- name: limit
in: query
required: false
schema:
type: integer
default: 50
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ChatMessageSave:
properties:
role:
type: string
title: Role
default: user
content:
type: string
title: Content
provider:
anyOf:
- type: string
- type: 'null'
title: Provider
model:
anyOf:
- type: string
- type: 'null'
title: Model
tokens_used:
anyOf:
- type: integer
- type: 'null'
title: Tokens Used
response_time_ms:
anyOf:
- type: integer
- type: 'null'
title: Response Time Ms
tool_calls:
anyOf:
- type: string
- type: 'null'
title: Tool Calls
metadata:
anyOf:
- type: string
- type: 'null'
title: Metadata
type: object
required:
- content
title: ChatMessageSave
description: Save a message (deprecated — backend now auto-persists from /agent/stream).
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
ChatSessionCreate:
properties:
title:
anyOf:
- type: string
- type: 'null'
title: Title
default: New Conversation
type: object
title: ChatSessionCreate
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key
x-refined-from:
- fincept-in-openapi.json
- fincept-in-openapi.json
x-provenance:
method: harvested
publisher: Fincept Terminal
source: https://api.fincept.in/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)