Group suggestions
/suggestions/groupingAuthorization
bearerAuth Send Authorization: Bearer <token> with one of: an app session access token from /auth/verify-otp or /auth/refresh; an OAuth access token from /oauth/token issued for the API origin (its scopes are its permissions); or a personal access token starting with optima_pat_ (see /docs/personal-access-tokens). Personal access tokens cannot create or list tokens, revoke other tokens, sign out, or delete or restore the account. Content routes need the permission of their layer: audio:read/audio:write for recordings, turns:read/turns:write for turns, contacts, source signals, and events, and insights:read/insights:write for suggestions and session summaries; search and recall need turns:read and insights:read. A request without the permission, or for an account whose layer is turned off, returns 403 FORBIDDEN. See /docs/authentication#scopes.
In: header
Header Parameters
Send 1 to pin the documented API contract. If omitted, the latest version is selected.
"1"Value in
- "1"
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/suggestions/grouping" \ -H "X-API-Version: 1" \ -H "Content-Type: application/json" \ -d '{ "idempotency_key": "0cd90e5a-2c03-4ab6-81a8-d48818026e58", "action": "create_group", "members": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "expected_revision": 1 } ] }'{ "success": true, "data": { "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0", "action_id": "52d6fa12-2c88-46da-984a-4cc821c7837a", "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f", "group_version": 1, "action": "create_group", "replayed": true }}