Carbon Voice

/** * Generated by orval v7.9.0 🍺 * Do not edit manually. * Carbon Voice Simplified API * # Introduction The simplified version of the Carbon Voice API is designed to enhance usability for third-party clients looking to seamlessly integrate with our application. By streamlining authentication methods, providing clear error handling guidelines, and implementing straightforward rate limiting policies, we ensure that developers can quickly and efficiently connect to our services. This user-friendly approach minimizes complexity, making it easier for external applications to leverage the powerful communication features of Carbon Voice without extensive technical overhead. This API is designed for people who feel comfortable integrating with RESTful APIs. ## Full API Version We also have a full version of the API. You can find it [here](/docs). ## Terminology * **Workspace**: An area that groups together people and Conversations. * **Conversation**: A channel of communication. A grouping of people and messages related to a given topic. * **Collaborators**: A group of people who are part of a Conversation. * **Discussion**: Any post into a conversation * **CarbonLink**: A link (on a website, QR code, or phone call) to start a conversation. ## BaseURL This API is served over HTTPS. All URLs referenced in the documentation have the following base: https://api.carbonvoice.app/api/simplified. ## Authentication There are three ways to authenticate with this API: * with an OAuth2 Access Token in the Authorization request header field (which uses the Bearer authentication scheme to transmit the Access Token) * with your Client ID and Client Secret credentials * with a PXToken Each endpoint supports only one option. <SecurityDefinitions /> ## Errors When an error occurs, you will receive an error object. Most of these error objects contain an error code and an error description so that your applications can more efficiently identify the problem. If you get an 4xx HTTP response code, then you can assume that there is a bad request from your end. In this case, check the [Error Responses section](#section/Introduction/Error-Responses) for more context. 5xx errors suggest a problem on our end, so in this case, check [Carbon Voice's Status](https://status.carbonvoice.app) to see how our systems are doing. In any other case you can use our support options. ## Error Responses `{ "success": false, requestId: "uuid", errmsg: "error message"` ## Rate-Limiting This API is subject to rate limiting. The limits differ per endpoint. If you exceed the provided rate limit for a given endpoint, you will receive the 429 Too Many Requests response with the following message: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. For details on rate limiting, refer to Rate Limit Policy. ## Support If you have problems or need help with your case, you can always reach out to our Support. * OpenAPI spec version: 1.0.0 */ export interface ToRecipient { /** Array of user IDs to send the message to */ user_ids?: string[]; /** Array of email addresses to send the message to */ emails?: string[]; }