Skip to main content

Mint API (v1)

Download OpenAPI specification:Download

Introduction

Signicat's Mint API allows you to manage and edit your Mint workflows programmatically, facilitating automation and integration with other systems.

This API reference provides information on available endpoints and how to interact with them. To learn more about the no-code platform Mint, visit the Signicat Mint documentation.

Get started

Initial preparations

If you don't have an account already, sign up for a free Signicat account by completing the following initial preparations:

  1. Sign up to the Signicat Dashboard and register your profile. For more details, see the Get started with Signicat guide.
  2. In the Dashboard, make sure you have set up an organisation and an account.
  3. Additionally, to use Sigicat Mint, you must set up a domain.

We recommend you create a sandbox account to test our services before going live. Sandbox and production accounts must be set up separately.

If you require support, you can contact us by creating a support ticket in the Signicat Dashboard.

Get client credentials

To authenticate against our APIs, you need to set up an API client. From this step, you will obtain a Client ID and a Client Secret.

Permissions

To connect to the Mint API you need to configure the correct permissions for you API client.

To grant access to your API client in the Signicat Dashboard:

  1. Go to Access Management > Permissions.
  2. Search for the name of the API client and, on the same row, select Edit to edit the access rights.
  3. Select Add next to 'Roles', in the Principal settings menu on the right.
  4. In the empty Role field at the bottom, select Select to add a new role permission.
  5. Search and select Flow Editor and Flow Viewer from the 'All available' roles tab.

You are now ready to start connecting to the Mint API!

Authorisation

The Mint API is a RESTful API that uses the OAuth 2.0 protocol for authorisation. All request and response bodies are formatted in JSON.

Learn more about authorisation to the API in the Obtaining an access token documentation.

Flow

Get all flows

Retrieves all the flows associated to an account.

Authorizations:
Bearer
query Parameters
IsLatest
boolean
IsLatestOrPublished
boolean
IsPublished
boolean
IsDraft
boolean
AllVersions
boolean
Version
integer <int32>
searchTerm
string
offset
integer <int32>
limit
integer <int32>
orderBy
string (FlowDefinitionOrderByDto)
Enum: "Name" "Description" "CreatedAt"
sortBy
string (SortByDto)
Enum: "Ascending" "Descending"

Responses

Response samples

Content type
No sample

Get a flow by ID

Retrieves a flow object for a given flow ID (id).

Authorizations:
Bearer
path Parameters
id
required
string

ID of the flow.

query Parameters
version
integer <int32>

Version of the flow.

Responses

Response samples

Content type
No sample

Execute a flow

Executes a flow by id.

This operation triggers a background flow execution. You can check the execution result using the Instance endpoints.

Authorizations:
Bearer
path Parameters
id
required
string

ID of the flow to execute.

Request Body schema:
object or null

Workflow input.

workflowUrlTtl
integer or null <int32> [ 0 .. 604800 ]

The time-to-live for the workflow URL in seconds. Defaults to 60 seconds.

Responses

Request samples

Content type
{
  • "input": {
    },
  • "workflowUrlTtl": 604800
}

Response samples

Content type
No sample

Instance

Get all instances by flow ID

Returns all the instances for a flow, if any available. Additionally, you can filter by instance status.

Authorizations:
Bearer
path Parameters
definitionId
required
string

The ID of the flow.

query Parameters
status
string (FlowStatus)
Enum: "Idle" "Running" "Finished" "Suspended" "Faulted" "Cancelled"
correlationId
string
orderby
string (InstanceOrderByDto)
Enum: "Started" "LastExecuted" "Finished"
searchTerm
string
offset
integer <int32>
limit
integer <int32>

Responses

Response samples

Content type
No sample

Get all instances

Lists all instances for all flows belonging to a Signicat account.

An Instance provides a log of what happened when a workflow was executed, it contains information about errors or which steps were completed successfully.

Additionally, you can filter by instance status.

Authorizations:
Bearer
query Parameters
status
string (FlowStatus)
Enum: "Idle" "Running" "Finished" "Suspended" "Faulted" "Cancelled"
correlationId
string
orderby
string (InstanceOrderByDto)
Enum: "Started" "LastExecuted" "Finished"
searchTerm
string
offset
integer <int32>
limit
integer <int32>

Responses

Response samples

Content type
No sample

Get instance by ID

Retrieves an instance for a given instanceId.

Authorizations:
Bearer
path Parameters
instanceId
required
string

The ID of the instance.

Responses

Response samples

Content type
No sample

Download an instance file

Authorizations:
Bearer
path Parameters
instanceId
required
string

ID of the instance

referenceId
required
string

Unique reference of the file.

Responses

Response samples

Content type
No sample

Download a zip file containing all the instance files

Authorizations:
Bearer
path Parameters
instanceId
required
string

ID of the instance

Responses

Response samples

Content type
No sample

Resume a instance by ID

Authorizations:
Bearer
path Parameters
id
required
string

ID of the instance to resume.

Request Body schema:
required
object or null
activityId
required
string or null

Responses

Request samples

Content type
{
  • "input": {
    },
  • "activityId": "string"
}

Response samples

Content type
No sample

Approve a instance by ID

Authorizations:
Bearer
path Parameters
id
required
string

ID of the instance to resume.

Request Body schema:
required
required
object (ResumeApprovalInstanceInputDto)
activityId
required
string or null

Responses

Request samples

Content type
{
  • "input": {
    },
  • "activityId": "string"
}

Response samples

Content type
No sample