# communicate-so Sources API

**Canonical:** https://apis.io/apis/communicate-so/communicate-so-sources-api/  
**Provider:** communicate-so — https://apis.io/providers/communicate-so/  
**Base URL:** https://app.communicate.so/api/v1  
**Documentation:** https://communicate.so/developers

communicate-so Sources API is one of 14 APIs that [communicate-so](https://apis.io/providers/communicate-so/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Sources. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Sources API from communicate-so — 11 operation(s) for sources.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| POST | `/workspaces/{workspaceId}/agents/{agentId}/sources` | Train text or Q&A immediately, or enqueue durable website/blog ingestion |
| GET | `/workspaces/{workspaceId}/agents/{agentId}/sources` | List source readiness, metadata, queue state and chunk counts |
| GET | `/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}` | Read owned source content and its current revision |
| PATCH | `/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}` | Replace source title or editable content using its current revision |
| DELETE | `/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}` | Remove a source and its indexed knowledge |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/sources/file` | Upload and extract a knowledge document up to 10 MB |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}/recrawl` | Queue a website or blog source recrawl while preserving prior knowledge until… |
| PATCH | `/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}/refresh` | Enable or disable scheduled website or blog refresh |
| DELETE | `/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}/pages` | Remove one crawled page from a website or blog source and its indexed chunks |
| GET | `/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources` | List sources on a Manage-linked agent |
| POST | `/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources` | Add a text, Q&A, URL or blog source to a Manage-linked agent |
| PATCH | `/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}` | Edit a source on a Manage-linked agent |
| POST | `/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}/retrain` | Retrain a source on a Manage-linked agent |
| POST | `/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}/enable` | Turn on scheduled refresh for a linked source |
| POST | `/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}/disable` | Turn off scheduled refresh for a linked source |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/communicate-so/openapi/communicate-so-sources-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/communicate-so/json-schema/communicate-so-read-inbox-conversation-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/communicate-so/json-schema/communicate-so-list-workspace-agents-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/communicate-so/json-schema/communicate-so-create-agent-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/communicate-so/json-schema/communicate-so-duplicate-agent-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/communicate-so/json-schema/communicate-so-fetch-agent-logo-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/communicate-so/json-schema/communicate-so-read-agent-response-schema.json

## Other communicate-so APIs (12)

- [communicate-so Account credentials API](https://apis.io/apis/communicate-so/communicate-so-account-credentials-api/)
- [communicate-so Account preferences API](https://apis.io/apis/communicate-so/communicate-so-account-preferences-api/)
- [communicate-so Agents API](https://apis.io/apis/communicate-so/communicate-so-agents-api/)
- [communicate-so Authentication API](https://apis.io/apis/communicate-so/communicate-so-authentication-api/)
- [communicate-so Chat API](https://apis.io/apis/communicate-so/communicate-so-chat-api/)
- [communicate-so Discovery API](https://apis.io/apis/communicate-so/communicate-so-discovery-api/)
- [communicate-so Grill API](https://apis.io/apis/communicate-so/communicate-so-grill-api/)
- [communicate-so Inbox API](https://apis.io/apis/communicate-so/communicate-so-inbox-api/)
- [communicate-so Learnings API](https://apis.io/apis/communicate-so/communicate-so-learnings-api/)
- [communicate-so Notifications API](https://apis.io/apis/communicate-so/communicate-so-notifications-api/)
- [communicate-so Teams API](https://apis.io/apis/communicate-so/communicate-so-teams-api/)
- [communicate-so Workspace members API](https://apis.io/apis/communicate-so/communicate-so-workspace-members-api/)

## Tags

Sources

---

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