Skip to main content

​
Setting up REST API

​
1. Add integration

Select REST API from the integrations page.

​
2. Configure settings

Fill out the form with the following settings:

​
OpenAPI Specifications

OpenAPI specs help Clark understand how to work with your API. To upload an OpenAPI specification to a REST API integration:
  1. Select Upload OpenAPI in the top-right corner
  2. From the uploader, select a JSON or YAML file containing your API’s OpenAPI spec (version 2.0 or later)
  3. Click Ok to upload
Once your API’s spec has been uploaded, you can manage your spec and explore docs from the API Specification tab.
Replacing an OpenAPI specification
To replace an API specification, such as to upload a new version, you can click on the button in the top-right labeled with the name of specification, e.g. spec-name.yaml, and upload a new specification.

​
3. Test and save

Click Test Connection to check that Superblocks can connect to your API. After connecting successfully, click Create to save the integration.

​
Supported OpenAPI specs

Superblocks supports uploading the following specification versions:
  • OpenAPI 3.0 and 3.1
  • Swagger 2.0
Specification files can be provided in any of the following formats:
  • JSON
  • YAML
  • X-YAML