# communicate-so Grill API

**Canonical:** https://apis.io/apis/communicate-so/communicate-so-grill-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 Grill 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 Grill. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Grill API from communicate-so — 8 operation(s) for grill.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/active` | Resume the latest active training round or report no draft |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds` | Generate a resumable training round and charge for its generated questions |
| GET | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}` | Read an addressed training round and its questions |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/answer` | Save, edit or clear a training answer without charging credits |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/draft` | Draft an answer from live retrieval and charge one credit without saving it |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/skip` | Skip a training question and charge only when a replacement is generated |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/regenerate` | Replace an unanswered training question and charge one credit |
| POST | `/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/finish` | Publish answered training pairs as indexed Q&A knowledge without charging… |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/communicate-so/openapi/communicate-so-grill-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 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 Sources API](https://apis.io/apis/communicate-so/communicate-so-sources-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

Grill

---

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