1.0.0
OAS 3.0
https://api.au.connect.squiz.cloud/docs/swagger.json
Welcome to the REST API documentation v2. It adheres to the JSON API specifications:
application/json
),We use a standard HTTP Basic Authentication mechanism to authenticate each API call with the Squiz Integrations.
{EMAIL}
- email address you use to login to the platform.{APIKEY}
- a unique API Key generated for you found in the profile settings page.We adhere to REST API HTTP status codes. Read more about them here https://restfulapi.net/http-status-codes/
To use an OAuth2 based Component in the platform it is required to register a client at the authorization server. Upon registration the authorization server issues the registered client an identifier (client ID) and a secret. These client credentials are used to create a client using the following API. Auth clients can be created on any level: tenant, contract or workspace which incapsulate each other (in order), i.e client created on tenant level is available to use for creating secrets in any workspace of the tenant.
A Contract is a fundamental entity (scope) that reflects an agreement between a customer and the platform’s provider. The Contract scope can have an unlimited number of members, workspaces, and development teams. It also serves as a singular entity for the billing department against the consumed resources by all the integration flows. Every member of the Contract’s scope has a specific access level or role within the current Contract. The same user can have different roles in different Contracts within the Platform. Every Contract must have at least one Owner. The Owner’s Role has a predefined/default permissions’ set. It means this role cannot be deleted and the permissions’ set cannot be changed.
The Topic is a JSON schema to be used to communicate publisher and many subscribers.
This group of API endpoints allows you to work with snapshots feature of the Platform. The feature enables taking snapshots for all steps in a Flow. Also, it allows you to get/create/edit/remove snapshots individually for steps. Data model every step in Flow can have associated persistent data. Step identifier is used as identifier of snapshot. Data may be anything serializable in JSON, except undefined. Notice snapshot is flow's runtime data. So it's forbidden to edit snapshots while flow is running.
This group of API endpoints allows you to work with recipe deployments. Recipe deployment describes recipe activation process ans has information about which flows was created during recipe activation and what activation parameters was used.
A Workspace is a space where every user can work on an integration project independently or in collaboration with other users. Each Workspace can have more than one member. All members of a Workspace have certain roles that define user permissions. To get all available roles, please execute the “Get the Contract’s roles” endpoint. There is one predefined role - Workspace Owner. This role gives the holder all the rights within the Workspace unit, it cannot be deleted and the permissions set cannot be changed. Each role is limited to the given Workspace only. The same user in the platform can have different roles in different Workspaces.