Khoros

Khoros Messages API

The Messages API from Khoros — 10 operation(s) for messages.

GitHub OpenAPI

Operations 14

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /{integrationUuid}/messages/validation Validate an inbound messages payload · Validate JSON request of inbound messages #
Ask an LLM
“How can I test whether my inbound message JSON is valid before sending it to Care?”
“Can I dry-run a Listening API messages payload for a social integration?”
Tell an agent
Validate this inbound messages payload {payload} for integration {integration}.
Check the inbound message JSON for integration {integration} without creating anything.
POST /{integrationUuid}/messages Ingest inbound messages from a custom integration · Create inbound messages #
Ask an LLM
“How do I push messages from my own channel into Khoros Care?”
“Can a custom social integration create inbound messages in bulk?”
Tell an agent
Create inbound messages {payload} for integration {integration}.
Send new inbound customer messages into Care through integration {integration}.
DELETE /{integrationUuid}/messages Delete inbound messages from an integration · Delete messages #
Ask an LLM
“Can I remove messages that a custom integration previously sent into Care?”
“How do I delete ingested messages for a social integration?”
Tell an agent destructive · confirm first
Delete the inbound messages {payload} from integration {integration}.
Remove previously ingested messages for integration {integration}.
POST /messages Generate a new Flow thread ID · Generate a Thread ID #
Ask an LLM
“How do I get a thread ID to start a Flow conversation over REST?”
“Where does a new threadId for the Flow REST API come from?”
Tell an agent
Generate a new thread ID.
Create a Flow thread ID I can use for messaging.
POST /messages/{threadId} Send a text message to a Flow thread · Create a Text Message #
Ask an LLM
“How do I send a user's text message into a Flow bot thread?”
“Can a text message be processed synchronously so I get the bot reply right away?”
Tell an agent
Send the text {payload} to thread {thread}.
Post a text message to thread {thread} in sync mode.
GET /messages/{threadId} List the messages in a Flow thread · Retrieve a list of messages #
Ask an LLM
“How do I read back the messages in a Flow bot thread?”
“Can I include the history of triggered events when listing a thread's messages?”
Tell an agent
List the messages in thread {thread}.
Show page {page} of messages in thread {thread} including triggered events.
POST /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message Publish a message through the company-scoped v1 API · Publish a new message #
Ask an LLM
“How do I publish a social message through the v1 company and environment endpoint?”
“Can I schedule a v1 message to a social network for an initiative?”
Tell an agent
Publish a message titled {title} to {network} for company {company} initiative {initiative} in {env}.
Schedule a v1 message for {date} in initiative {initiative} of company {company} on {env}.
GET /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message/{messageId} Get a message through the company-scoped v1 API · Retrieve an existing message #
Ask an LLM
“How do I fetch one message using the v1 company-scoped path?”
“What status does a v1 message show after publishing?”
Tell an agent
Get v1 message {message} in initiative {initiative} for company {company} on {env}.
Show the publication status of message {message} under company {company}, initiative {initiative}, environment {env}.
PUT /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message/{messageId} Edit a message through the company-scoped v1 API · Update an existing multi-part message #
Ask an LLM
“Can I change a message's title or labels through the v1 company endpoint?”
“How do I reschedule a message with the v1 API?”
Tell an agent
Retitle v1 message {message} to {title} in initiative {initiative} of company {company} on {env}.
Reschedule message {message} to {date} for company {company}, initiative {initiative}, environment {env}.
DELETE /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message/{messageId} Delete a message through the company-scoped v1 API · Delete an existing message #
Ask an LLM
“Can I delete a message using the v1 company-scoped endpoint?”
“How do I remove a scheduled message with the v1 API?”
Tell an agent destructive · confirm first
Delete v1 message {message} in initiative {initiative} for company {company} on {env}.
Remove message {message} from company {company}, initiative {initiative}, environment {env}.
POST /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message?multipart Publish a v1 message with one uploaded image · Publish a new message #
Ask an LLM
“How do I publish a v1 message and upload its image in the same request?”
“Is an image file required when publishing a multipart v1 message?”
Tell an agent
Publish multipart message {message} with image {image} to initiative {initiative} of company {company} on {env}.
Upload image {image} and post it as a v1 message in initiative {initiative}, company {company}, {env}.
POST /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message?imageset Publish a v1 message with several images · Publish a new message #
Ask an LLM
“How do I publish one v1 post carrying multiple uploaded images?”
“Does the number of images in an image-set message have to match the files uploaded?”
Tell an agent
Publish image-set message {message} with images {image} to initiative {initiative} of company {company} on {env}.
Post an image set to initiative {initiative} for company {company} in {env}.
POST /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message?video Publish a v1 video message · Publish a new message #
Ask an LLM
“How do I publish a video post through the v1 messages API?”
“Can I upload a video as part of publishing a v1 message?”
Tell an agent
Publish video message {message} to initiative {initiative} of company {company} on {env}.
Post a video to initiative {initiative} for company {company} in {env}.
PUT /{environment}/v1/company/{companyId}/initiative/{initiativeId}/message/{messageId}?multipart Edit a v1 multipart message and its image · Update an existing multi-part message #
Ask an LLM
“Can I swap the image on a v1 multi-part message I already created?”
“How do I update a v1 message that was published with an uploaded file?”
Tell an agent
Update multipart message {message_id} with {message} and new image {image} in initiative {initiative}, company {company}, {env}.
Replace the image on v1 multipart message {message_id} for company {company}, initiative {initiative}, {env} using {message}.

Documentation

📖
Documentation
https://developer.khoros.com/khoroscaredevdocs/docs/khoros-care-integration-overview
📖
Documentation
https://developer.khoros.com/khorosmarketingdevdocs/docs/developing-and-integrating-with-khoros-marketing
📖
Documentation
https://developer.khoros.com/khoros-flow/docs/overview-of-khoros-flow-apis

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/khoros-ai/refs/heads/main/openapi/khoros-ai-messages-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/khoros-ai:khoros-ai-messages-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

khoros-ai-messages-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Khoros Ai Messages API
  version: '1.0'
  description: 'Operations tagged Messages across 4 of this provider''s published API definitions: lithium-care-listening-api-v2-openapi.json, lithium-flow-flow-rest-api-openapi.json, lithium-marketing-conversations-api-v1-openapi.json, lithium-messages-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{instance}.response.lithium.com/api/v2/listening
  variables:
    instance:
      default: instance
- url: https://api.flow.ai/rest/v1/
- url: https://api.spredfast.com
tags:


# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/khoros-ai/refs/heads/main/openapi/khoros-ai-messages-api-openapi.yml