# Spredfast Conversations API (v2)

**Canonical:** https://apis.io/apis/spredfast/spredfast-conversations-api-v2/  
**Provider:** Spredfast — https://apis.io/providers/spredfast/  
**Base URL:** https://api.spredfast.com/v2  
**Documentation:** https://developer.khoros.com/khorosmarketingdevdocs

Spredfast Conversations API (v2) is one of 50 APIs that [Spredfast](https://apis.io/providers/spredfast/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Social-Media, Marketing, Publishing, and Content Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

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.

## Operations (38)

| Method | Path | Summary |
|---|---|---|
| GET | `/conversations/initiative/{initiative-id}/accountset` | Retrieve All Account Sets & Accounts Available |
| POST | `/conversations/asset` | Create Text Asset |
| POST | `/conversations/asset?multipart` | Create Image or Video |
| GET | `/conversations/asset/{assetId}` | Retrieve a Content Center Asset by ID |
| PUT | `/conversations/asset/{assetId}` | Update Existing Content Center Asset |
| POST | `/conversations/folder` | Create a New Content Asset Folder |
| GET | `/conversations/folder` | Retrieve a list of folders |
| GET | `/conversations/folder/{folderId}` | Retrieve a Content Asset Folder by ID |
| PUT | `/conversations/folder/{folderId}` | Update Existing Content Center Asset Folder |
| DELETE | `/conversations/folder/{folderId}` | Delete a Content Asset Folder by ID |
| GET | `/conversations/folder/{folderId}/assets` | Retrieve a List of Assets in a Folder |
| GET | `/conversations/calendar/customChannel` | List CustomChannels |
| POST | `/conversations/calendar/customChannel` | Create a CustomChannel |
| GET | `/conversations/calendar/customChannel/{customChannelId}` | Get a CustomChannel based on ID |
| PUT | `/conversations/calendar/customChannel/{customChannelId}` | Update a CustomChannel |
| POST | `/conversations/initiative/{initiativeId}/calendar/customChannelItem/{customChannelItemId}` | Create a CustomChannelItem |
| PUT | `/conversations/initiative/{initiativeId}/calendar/customChannelItem/{customChannelItemId}` | Update a CustomChannelItem |
| GET | `/conversations/initiative/{initiativeId}/calendar/customChannelItem/{customChannelItemId}` | Get a CustomChannelItem by ID |
| GET | `/conversations/calendar/messages` | Get Messages |
| GET | `/conversations/initiative` | Retrieve a List of Available Initiatives |
| GET | `/conversations/initiative/{initiativeId}` | Retrieve a Single Initiative |
| GET | `/conversations/initiative/{initiativeId}/contentLabel` | Retrieve Paged Labels |
| POST | `/conversations/initiative/{initiativeId}/message` | Publish a New Message (imageset) |
| PUT | `/conversations/initiative/{initiativeId}/message/{messageId}` | Update a Message |
| GET | `/conversations/initiative/{initiativeId}/message/{messageId}` | Retrieve an Existing Message |
| DELETE | `/conversations/initiative/{initiativeId}/message/{messageId}` | Delete an Existing Message |
| POST | `/conversations/initiative/{initiativeId}/message?multipart` | Publish a New Message (multipart) |
| PUT | `/conversations/initiative/{initiativeId}/message/{messageId}?multipart` | Update a Multipart Message |
| GET | `/conversations/initiative/{initiativeId}/multiChannelMessage/{messageId}` | Retrieve an Existing Multi-channel Message |
| GET | `/conversations/privilege` | Retrieve Permissions for Current User |
| GET | `/conversations/initiative/{initiativeId}/plan` | Retrieve a List of Plans |
| GET | `/conversations/roles` | List Roles for the Company |
| GET | `/conversations/users/initiative/{initiativeId}/publishers` | List Conversations Publishers |
| DELETE | `/conversations/user/{userId}` | Delete a Conversations User |
| POST | `/conversations/user` | Create a Conversations User |
| GET | `/conversations/users` | List Conversations Users |
| POST | `/conversations/initiative/{initiativeId}/video/captions` | Create a Video Captions |
| GET | `/conversations/workspaces` | List Workspaces for the Company |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/spredfast/refs/heads/main/openapi/spredfast-conversations-api-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/spredfast/refs/heads/main/overlays/spredfast-conversations-api-overlay.yaml
- **Documentation** — https://developer.khoros.com/khorosmarketingdevdocs
- **APIReference** — https://developer.khoros.com/khorosmarketingdevdocs/reference
- **GettingStarted** — https://developer.khoros.com/khorosmarketingdevdocs/docs/getting-started-with-the-conversations-api
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/spredfast/refs/heads/main/skills/spredfast-publish-a-social-message.md
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/spredfast/refs/heads/main/skills/spredfast-manage-content-center-assets.md
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/spredfast/refs/heads/main/apis.yml

## Other Spredfast APIs (12)

- [Spredfast Account Set API](https://apis.io/apis/spredfast/spredfast-accountset-api/)
- [Spredfast Admin API](https://apis.io/apis/spredfast/spredfast-admin-api/)
- [Spredfast Asset API](https://apis.io/apis/spredfast/spredfast-asset-api/)
- [Spredfast Assets API](https://apis.io/apis/spredfast/spredfast-assets-api/)
- [Spredfast Case API](https://apis.io/apis/spredfast/spredfast-case-api/)
- [Spredfast Compare.json?streams API](https://apis.io/apis/spredfast/spredfast-compare-json-streams-api/)
- [Spredfast Compare.json?streams={content}&sort API](https://apis.io/apis/spredfast/spredfast-compare-json-streams-content-sort-api/)
- [Spredfast Compare.json?streams={content}&target API](https://apis.io/apis/spredfast/spredfast-compare-json-streams-content-target-api/)
- [Spredfast Compare.json?streams={content}&target={number}&precision API](https://apis.io/apis/spredfast/spredfast-compare-json-streams-content-target-number-precision-api/)
- [Spredfast Customer API](https://apis.io/apis/spredfast/spredfast-customer-api/)
- [Spredfast Customers API](https://apis.io/apis/spredfast/spredfast-customers-api/)
- [Spredfast Data API](https://apis.io/apis/spredfast/spredfast-data-api/)

## Tags

Social-Media, Marketing, Publishing, Content Management

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/spredfast/spredfast-conversations-api-v2/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/spredfast/.