# Coviu Documentation > Documentation for Coviu ## API Reference - [The Coviu REST API](https://coviu.readme.io/reference/the-coviu-rest-api.md) - [Auth](https://coviu.readme.io/reference/auth.md) - [Request access token](https://coviu.readme.io/reference/access-token.md): Request an access token using one of the supported OAuth2 grant types: ## Client Credentials - HTTP Basic Auth, passing the Client ID and Client Secret as the username and password - `application/x-www-form-urlencoded` data, containing: - `{ grant_type: "client_credentials" }` ## Authorization Code - HTTP Basic Auth, passing the Client ID and Client Secret as the username and password - `application/x-www-form-urlencoded` data, containing: - ``` { grant_type: "authorization_code", code: "eyJ0eXAi...." } ``` ## Refresh Token - HTTP Basic Auth, passing the Client ID and Client Secret as the username and password - `application/x-www-form-urlencoded` data, containing: - ``` { grant_type: "refresh_token", refresh_token: "eyJ0eXAi...." } ``` - [Sessions](https://coviu.readme.io/reference/sessions.md) - [Create a Session](https://coviu.readme.io/reference/createsession.md): There are some further options you are able to pass through a "feature_flags" field when creating a session. These allow some customisation of the interface ## Custom features for Sessions Custom feature can be added while creating a Session and it can be done by passing values into the feature_flags array. **Example Feature Flags option** ```text feature_flags: [ '-plugin;coviu-waiting-room-plugin', '-plugin;coviu-stripe-payments-resource-plugin', 'customisation;disable-menu', 'customisation;exit-url;https://your-exit-url', 'customisation;return-url;https://your-return-url', 'customisation;return-label;Your return label', 'customisation;auto-return', 'session;enforce-participant-uniqueness', 'customisation;favicon-url;https://yourdomain.com/favicon.ico' ] ``` **What do they do?** | Feature Flag | What it does ? | | :------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \-plugin | Removes standard Coviu plugins from the session room | | customisation;disable-menu | Removes the menu from the session room | | customisation;exit-url | Add a specific URL to wherever you would like to redirect to if the user exits the call interface using the "Exit call interface" button prior to other participants joining | | customisation;return-url | Add a specific URL to wherever you would like to redirect to after the call has completed from the exit screen | | customisation;return-label | To label the button that does the return URL navigation. | | customisation;auto-return | Automatically redirect to the return-url after hitting the "end call" button | | session;enforce-participant-uniqueness | Allow for the unique use of the participant's URL - it can't be re-used after first entry | | customisation;favicon-url; | Allow for the use of your favicon in the call | | customisation;background-color;{value} | Allows for using a custom background colour in the Coviu call window | | customisation;button-primary;{value} | Allows for using a custom button colour in the Coviu call window | | customisation;button-secondary;{value} | Allows for using a custom colour for the content inside the button in the Coviu call window | - [List Sessions](https://coviu.readme.io/reference/listsessions.md) - [Get a Session](https://coviu.readme.io/reference/getsession.md) - [Update a Session](https://coviu.readme.io/reference/updatesession.md) - [Cancel a Session](https://coviu.readme.io/reference/cancelsession.md) - [Get Session Summary](https://coviu.readme.io/reference/getsessionsummary.md): Here is some further information on the timestamps provided in the response: - Start time - Scheduled start time for the session - End time - Scheduled end time for the session - Actual start time - Creation time of the call, typically when host has joined - Actual end time - Call recorded as complete, last participant has left - Participant entry time - Earliest recorded entry time for the participant, does not include time in Waiting Room - Participant exit time - Latest recorded exit time for the participant. - [List Participants](https://coviu.readme.io/reference/listparticipants.md): By default, the returned order is paginated with the first page containing the created sessions in chronological order (oldest created first). If you set the "order" parameter to "reverse", the newest created sessions will be returned. You can filter sessions by start and end time, at which stage the returned result list is ordered by start time in chronological order (rather than by creation time). The "order" parameter allows you to reverse this order to retrieve sessions by start time with the newest start time first. - [Add Participant](https://coviu.readme.io/reference/addparticipant.md): It is sometimes useful to add a participant to a session after the session has been created. It is possible to add a participant to a session that has already started, but not to a session that has already finished. - [Get Participant](https://coviu.readme.io/reference/getparticipant.md) - [Update Participant](https://coviu.readme.io/reference/updateparticipant.md) - [Cancel a Participant](https://coviu.readme.io/reference/cancelparticipant.md): A session that is scheduled for the future may be canceled. No participants will be able to join the session after it has been canceled, and it can not be uncanceled once it has been canceled. A session that has already started may not be canceled. - [Get Currently Waiting Calls](https://coviu.readme.io/reference/getcurrentlywaitingcalls.md) - [Get Currently Waiting Calls for a Queue](https://coviu.readme.io/reference/getcurrentlywaitingcallsforqueue.md) - [Get a Call](https://coviu.readme.io/reference/getcall.md) - [Collections](https://coviu.readme.io/reference/collections.md) - [Retrieve the Collections for a Team](https://coviu.readme.io/reference/getcollections.md) - [List the Submissions for a Collection](https://coviu.readme.io/reference/listsubmissions.md) - [Get a Submission](https://coviu.readme.io/reference/getsubmission.md) - [Get the binary file for a SubmissionFile](https://coviu.readme.io/reference/getsubmissionfile.md) - [Get the binary file for an Audio Recording](https://coviu.readme.io/reference/getaudiorecording.md) - [Authentication](https://coviu.readme.io/reference/webhook-authentication.md) - [/webhook](https://coviu.readme.io/reference/post_webhook.md): The events and payloads documented in this section are webhooks — they are not endpoints your system should call, but rather requests that will be sent from our servers to your system when relevant events occur. These webhook payloads are delivered as HTTP POST requests to a URL you configure during integration. This page documents all events the webhooks can be configured to fire, and the structure of the payloads your system should expect to receive. Your system must expose an endpoint to receive these POST requests, and handle the incoming JSON payload according to the schema. Note: You should respond with a 2xx HTTP status code to acknowledge receipt. The system will not retry requests upon failure. - [Coviu Apps](https://coviu.readme.io/reference/getting-started-with-your-api-1.md): This page will help you get started with Coviu Apps. - [Technical Documentation](https://coviu.readme.io/reference/technical-documentation-1.md) - [Webhooks Documentation](https://coviu.readme.io/reference/webhooks-documentation.md) - [API Object](https://coviu.readme.io/reference/api-object-1.md) - [Concepts](https://coviu.readme.io/reference/concepts-1.md)