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:
FieldRequiredDescription
Base URL✓The main endpoint address of the API that serves as the root for all requests
Authentication✓The authentication type you want to use. See detailed instructions for setting up API auth in our docs on Authentication & authorization
Headers✗List of headers that will be added to requests to your API
Params✗List of query parameters that will be added to requests to your API

​
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