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

Spredfast Conversations API (v2)

The current Spredfast / Khoros Marketing publishing and content surface — 39 operations covering initiatives, account sets, message publishing and scheduling, the Content Center (assets and folders), custom channels and the publishing calendar, plans, content labels, users, roles, privileges and workspaces. OAuth 2.0 bearer token; company and environment are derived from the token.

This API exposes 38 operations across 28 paths. It is described by OpenAPI 3.2.0, at version 1.1.

Requests are made against a single base URL, https://api.spredfast.com/v2.

38 operations 28 paths 0 schemas 3 DELETE20 GET9 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1
Base URL
https://api.spredfast.com/v2
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Spredfast Conversations API (v2) declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (sec0) using the clientCredentials flow. By default, every request must be authenticated.

Paths & Operations 38

Across 28 paths, the API surfaces 38 operations — 3 DELETE, 20 GET, 9 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

Conversations 38
GET
/conversations/initiative/{initiative-id}/accountset
Retrieve All Account Sets & Accounts Available
accountset 1 param → 200400
POST
/conversations/asset
Create Text Asset
assets-create-text-asset body → 200406
POST
/conversations/asset?multipart
Create Image or Video
assets-create-image-or-video body → 200
GET
/conversations/asset/{assetId}
Retrieve a Content Center Asset by ID
assets-retrieve-a-content-center-asset-by-id 1 param → 200
PUT
/conversations/asset/{assetId}
Update Existing Content Center Asset
assets-update-existing-content-center-asset 3 params body → 200
POST
/conversations/folder
Create a New Content Asset Folder
create-a-new-content-asset-folder body → 200
GET
/conversations/folder
Retrieve a list of folders
retrieve-a-list-of-folders 4 params → 200400
GET
/conversations/folder/{folderId}
Retrieve a Content Asset Folder by ID
retrieve-a-content-asset-folder-by-id 1 param → 200
PUT
/conversations/folder/{folderId}
Update Existing Content Center Asset Folder
update-existing-content-center-asset-folder 1 param body → 200400
DELETE
/conversations/folder/{folderId}
Delete a Content Asset Folder by ID
delete-a-content-asset-folder-by-id 1 param → 200
GET
/conversations/folder/{folderId}/assets
Retrieve a List of Assets in a Folder
retrieve-a-list-of-assets-in-a-folder 5 params → 200
GET
/conversations/calendar/customChannel
List CustomChannels
list-customchannels body → 200400
POST
/conversations/calendar/customChannel
Create a CustomChannel
create-a-customchannel body → 200
GET
/conversations/calendar/customChannel/{customChannelId}
Get a CustomChannel based on ID
get-a-customchannel-based-on-id 1 param body → 200
PUT
/conversations/calendar/customChannel/{customChannelId}
Update a CustomChannel
update-a-customchannel 1 param body → 200
POST
/conversations/initiative/{initiativeId}/calendar/customChannelItem/{customChannelItemId}
Create a CustomChannelItem
create-a-customchannelitem 2 params body → 200
PUT
/conversations/initiative/{initiativeId}/calendar/customChannelItem/{customChannelItemId}
Update a CustomChannelItem
update-a-customchannelitem 2 params body → 200
GET
/conversations/initiative/{initiativeId}/calendar/customChannelItem/{customChannelItemId}
Get a CustomChannelItem by ID
get-a-customchannelitem-by-id 2 params → 200400
GET
/conversations/calendar/messages
Get Messages
get-messages 6 params → 200
GET
/conversations/initiative
Retrieve a List of Available Initiatives
retrieve-a-list-of-available-initiatives 3 params → 200
GET
/conversations/initiative/{initiativeId}
Retrieve a Single Initiative
retrieve-a-single-initiative 1 param → 200
GET
/conversations/initiative/{initiativeId}/contentLabel
Retrieve Paged Labels
retrieve-paged-labels 5 params → 200
POST
/conversations/initiative/{initiativeId}/message
Publish a New Message (imageset)
publish-a-new-message-imageset 1 param body → 200
PUT
/conversations/initiative/{initiativeId}/message/{messageId}
Update a Message
update-a-message 2 params body → 200
GET
/conversations/initiative/{initiativeId}/message/{messageId}
Retrieve an Existing Message
retrieve-an-existing-message 2 params → 200
DELETE
/conversations/initiative/{initiativeId}/message/{messageId}
Delete an Existing Message
delete-an-existing-message 2 params → 200
POST
/conversations/initiative/{initiativeId}/message?multipart
Publish a New Message (multipart)
publish-a-new-message-multipart 1 param body → 200
PUT
/conversations/initiative/{initiativeId}/message/{messageId}?multipart
Update a Multipart Message
update-a-multipart-message 2 params body → 200
GET
/conversations/initiative/{initiativeId}/multiChannelMessage/{messageId}
Retrieve an Existing Multi-channel Message
retrieve-an-existing-multi-channel-message 2 params → 200
GET
/conversations/privilege
Retrieve Permissions for Current User
retrieve-permissions-for-current-user → 200
GET
/conversations/initiative/{initiativeId}/plan
Retrieve a List of Plans
retrieve-a-list-of-plans 4 params → 200
GET
/conversations/roles
List Roles for the Company
list-roles-for-the-company 2 params → 200
GET
/conversations/users/initiative/{initiativeId}/publishers
List Conversations Publishers
list-conversations-publishers 1 param → 200
DELETE
/conversations/user/{userId}
Delete a Conversations User
delete-a-conversations-user 1 param → 200404
POST
/conversations/user
Create a Conversations User
create-a-conversations-user body → 200406
GET
/conversations/users
List Conversations Users
list-conversations-users 3 params → 200
POST
/conversations/initiative/{initiativeId}/video/captions
Create a Video Captions
create-a-video-captions body → 200406
GET
/conversations/workspaces
List Workspaces for the Company
list-workspaces-for-the-company 2 params → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spredfast-conversations-api-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Spredfast Conversations API (v2), 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.