This feature is not available on all plans - contact support for more information on upgrading your plan for this feature.

⚠️ For more information on Coassemble’s API, please read through the article: What is Coassemble’s API functionality?

If you have a Coassemble workspace, this documentation is also available at https://[yourworkspace].coassemble.com/api/doc

Note: to use the Try It Out forms you'll need to use your own workspace URL rather than app.coassemble.com. Using these forms at app.coassemble.com will raise a warning about using "PLACEHOLDER FOR RESERVED DOMAINS".

Authorisation Keys

If you are already logged in to your Coassemble account, you can use the existing browser session to access the documentation; the operations that follow will succeed without requiring authentication keys.

If you are not logged in or intend to test authentication via API key, you'll need to enter your workspace-specific authentication keys via the Authorize button at the top right of the documentation page:

Your Coassemble API Key can be found in the ‘Settings’ tab in ‘Integrations’ page. Once you're on the ‘integrations’ page, navigate to the ‘Advanced’ tab. Here you will find the ‘Coassemble API’ section, and the ‘Authorization Header’ value is also shown.

Note that the value used for the 'Try it out' documentation above uses only the substring after 'Authorization:' in the available input.

A couple of important notes:

  • API Keys are unique to the user account: requests made with a given key will be scoped to the authorisation of that user account.
  • API Requests made using the Try It Out method shown here use live workspace data. Requests that perform modifications eg. PATCH, POST etc. will change actual workspace data.

Making Requests

Using the ‘Courses’ route example from above, clicking the ‘Try it out’ button in the Parameters section changes the format of that section to allow parameters to be entered for testing:

In this example, all parameters are optional so the Request can be executed without specifying anything further.

Once the Request is sent, the curl format is shown for convenience, the full URL used and the Response Code and Response Body and Headers from the server:

Note: the curl format can be used as the basis to transform into other formats, methods to do this can easily be found via search engine.

Next Steps

The API documentation page provides baseline information on the available routes on the Coassemble platform and a quick way to test request and response data.

This can be taken further with intended use-cases including: in conjunction with an existing third-party application; via connection to external webhooks or programmed within a custom web application.

We're always keen to hear ways we can improve. Our technical team welcomes all feedback on ways we can extend or enhance our platform API.

Did this answer your question?