Niche Chat API
The chat API from Niche — 9 operation(s) for chat.
The chat API from Niche — 9 operation(s) for chat.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/nicheangle-com:nicheangle-com-chat-api"
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.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Signal Chat API
version: 0.1.0
tags:
- name: Chat
paths:
/chat/threads:
post:
tags:
- Chat
summary: Create Thread
operationId: create_thread_chat_threads_post
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateThreadRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Chat
summary: List Threads
operationId: list_threads_chat_threads_get
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/threads/{thread_id}:
get:
tags:
- Chat
summary: Get Thread
operationId: get_thread_chat_threads__thread_id__get
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
patch:
tags:
- Chat
summary: Patch Thread
operationId: patch_thread_chat_threads__thread_id__patch
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PatchThreadRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/threads/{thread_id}/greet:
post:
tags:
- Chat
summary: Greet Thread
description: 'Generate the desk''s opening line (in voice, personalized) for an empty
thread. Idempotent-ish: if the thread already has messages, returns the
first one instead of greeting twice.'
operationId: greet_thread_chat_threads__thread_id__greet_post
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/threads/{thread_id}/messages/stream:
post:
tags:
- Chat
summary: Post Message Stream
description: 'The desk''s message turn (H-1, now THE message route — the non-streaming
twin is gone; the web cut over). Appends the user''s turn, runs the desk
driver, and streams the reply PROSE token-by-token over SSE (`delta` events),
then a terminal `done` event with the persisted messages. The pipeline phase
feed (run SSE) is unchanged — it still drives ''what''s happening''. [IP] the
stream carries only assistant prose (run_agent_streaming''s text deltas); the
tool channel never leaves the server.
Recovery contract: the user message is persisted before the driver runs, and
the driver turn runs on its OWN db session in a task that survives client
disconnect — so a dropped stream is recovered by refetching the thread,
never by re-sending (which would run the turn twice).'
operationId: post_message_stream_chat_threads__thread_id__messages_stream_post
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostMessageRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/threads/{thread_id}/filing-greeting:
post:
tags:
- Chat
summary: Filing Greeting
description: 'Fired by the desk the moment a run lands on the filing sheet — Sonnet
''lights up'' with a proactive reaction + next-move offers. Idempotent per
session (returns null assistant_message if she already greeted this piece,
so a reload/double-fire never double-posts).'
operationId: filing_greeting_chat_threads__thread_id__filing_greeting_post
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/threads/{thread_id}/intelligence-greeting:
post:
tags:
- Chat
summary: Intelligence Greeting
description: 'Fired when an intelligence-query run lands at CP1 with a grounded synthesis.
research_query is fire-and-forget, so the persona delivers the actual answer
here — narrated from the engine-grounded narratives. Idempotent per session;
returns null when the parked run isn''t an intelligence query (e.g. a normal
start_run also reaches CP1), so the frontend can call it on every CP1 edge.'
operationId: intelligence_greeting_chat_threads__thread_id__intelligence_greeting_post
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/threads/{thread_id}/slate-greeting:
post:
tags:
- Chat
summary: Slate Greeting
description: 'Fired when a NORMAL run parks at a checkpoint — the story slate (CP1) or the
angles (CP2). The desk narrates whichever just landed with the engine''s counsel,
so the cards don''t appear in silence. Idempotent per session+checkpoint (returns
null when nothing applies — intel query, not parked, or already greeted), so the
frontend can call it on every CP1/CP2 edge.'
operationId: slate_greeting_chat_threads__thread_id__slate_greeting_post
parameters:
- name: thread_id
in: path
required: true
schema:
type: string
format: uuid
title: Thread Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/preferences:
get:
tags:
- Chat
summary: List Preferences
operationId: list_preferences_chat_preferences_get
parameters:
- name: brand_id
in: query
required: false
schema:
type: string
default: default
title: Brand Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/chat/preferences/{pref_id}:
delete:
tags:
- Chat
summary: Dismiss Preference
operationId: dismiss_preference_chat_preferences__pref_id__delete
parameters:
- name: pref_id
in: path
required: true
schema:
type: string
format: uuid
title: Pref Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
CreateThreadRequest:
properties:
title:
anyOf:
- type: string
maxLength: 200
- type: 'null'
title: Title
brand_id:
anyOf:
- type: string
- type: 'null'
title: Brand Id
type: object
title: CreateThreadRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
PatchThreadRequest:
properties:
title:
anyOf:
- type: string
maxLength: 200
- type: 'null'
title: Title
status:
anyOf:
- type: string
- type: 'null'
title: Status
type: object
title: PatchThreadRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
PostMessageRequest:
properties:
content:
type: string
maxLength: 4000
minLength: 1
title: Content
turn_id:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Turn Id
type: object
required:
- content
title: PostMessageRequest