Skip to content
API Reference
/
Automations

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server

https://docs.bndry.net/_mock/apis/openapi/

https://api.bndry.app/

Documents

Service for managing documents.

Operations

Form Definitions

Service for managing form definitions.

Operations

Forms

Operations

Workspaces

Service for managing workspaces and their associated forms and documents.

Operations

Automations

Service for managing and executing automations.

Operations

List all automations

Request

Lists available automations for the tenant.

Security
oauth2_client_credentials or oauth2_authorization_code
Query
pageSizeinteger(int32)(page_size)

Optional. The maximum number of automations to return. The service may return fewer than this value. If unspecified, at most 50 automations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageTokenstring(page_token)

Optional. A page token, received from a previous ListAutomations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAutomations must match the call that provided the page token.

filterstring(filter)

Optional. A filter expression that filters the results listed in the response. See AIP-160 for filter syntax.

skipinteger(int32)(skip)

Optional. The number of automations to skip before starting to collect the result set.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/automations?pageSize=0&pageToken=string&filter=string&skip=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
automationsArray of objects(automations)

The list of automations.

nextPageTokenstring(next_page_token)

A token to retrieve the next page of results, or empty if there are no more results in the list.

totalSizeinteger(int32)(total_size)

The total number of automations matching the request.

Response
application/json
{
  "automations": [
    { … }
  ],
  "nextPageToken": "string",
  "totalSize": 0
}

Retrieve an automation

Request

Retrieves details about a specific automation.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
automationstringrequired

The automation id.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/automations/{automation}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
namestring(name)

(IDENTIFIER) The resource name of the automation. Format: automations/{automation}

displayNamestring(display_name)read-only

Human-readable display name.

descriptionstring(description)read-only

Description of what the automation does.

inputSchemaobject(google.protobuf.Struct)read-only

Input schema for parameters (JSON schema).

Response
application/json
{
  "name": "automations/credit-approval-workflow",
  "displayName": "Credit Approval Workflow",
  "description": "Automates credit approval process for loan applications, including risk assessment, document verification, and compliance checks",
  "inputSchema": {
    "property1": {},
    "property2": {}
  }
}

Run an automation

Request

Runs an automation and returns an automation execution.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
automationstringrequired

The automation id.

Bodyapplication/jsonrequired
parametersobject(google.protobuf.Struct)

(OPTIONAL) Optional. Input parameters for the automation execution.

curl -i -X POST \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/automations/{automation}:run' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "parameters": {
      "property1": {},
      "property2": {}
    }
  }'

Responses

Success

Bodyapplication/json
One of:

This resource represents a long-running operation that is the result of a network API call.

errorobject(google.rpc.Status)required

The error result of the operation in case of failure or cancellation.

error.​codeinteger(int32)(code)

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

error.​messagestring(message)

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

error.​detailsArray of objects(details)

A list of messages that carry the error details. There is a common set of message types for APIs to use.

namestring(name)

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

metadataobject(google.protobuf.Any)

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

doneboolean(done)

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

Response
application/json
{
  "error": {
    "code": 0,
    "message": "string",
    "details": [ … ]
  },
  "name": "string",
  "metadata": {
    "type": "string",
    "value": "string",
    "debug": {}
  },
  "done": true
}

List automation executions

Request

Lists automation executions for a specific automation.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
automationstringrequired

The automation id.

Query
pageSizeinteger(int32)(page_size)

Optional. The maximum number of executions to return. The service may return fewer than this value. If unspecified, at most 50 executions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageTokenstring(page_token)

Optional. A page token, received from a previous ListAutomationExecutions call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAutomationExecutions must match the call that provided the page token.

filterstring(filter)

Optional. A filter expression that filters the results listed in the response. See AIP-160 for filter syntax.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/automations/{automation}/executions?pageSize=0&pageToken=string&filter=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
automationExecutionsArray of objects(automation_executions)

The list of automation executions.

nextPageTokenstring(next_page_token)

A token to retrieve the next page of results, or empty if there are no more results in the list.

totalSizeinteger(int32)(total_size)

The total number of executions matching the request.

Response
application/json
{
  "automationExecutions": [
    { … }
  ],
  "nextPageToken": "string",
  "totalSize": 0
}

Retrieve an automation execution

Request

Retrieves details about a specific automation execution.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
automationstringrequired

The automation id.

executionstringrequired

The execution id.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/automations/{automation}/executions/{execution}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
namestring(name)

(IDENTIFIER) The resource name of the automation. Format: automations/{automation}/executions/{execution}

automationstring(automation)read-only

The automation being executed. Format: automations/{automation}

inputParametersobject(google.protobuf.Struct)read-only

Input parameters provided for the execution.

statestring(bndry.api.platform.automations.v1alpha.AutomationExecution.State)read-only

Current execution state.

Enum"STATE_UNSPECIFIED""ACTIVE""REQUIRES_INPUT""SUCCEEDED""FAILED""CANCELLED"
formsArray of strings(forms)read-only

The resource names of the forms that require a response to continue the execution.

errorobject(google.rpc.Status)read-only

Output only. The error which caused the execution to finish prematurely. The value is only present if the execution's state is FAILED or CANCELLED.

startTimestring(date-time)(google.protobuf.Timestamp)read-only

Output only. Timestamp when execution started.

endTimestring(date-time)(google.protobuf.Timestamp)read-only

Output only. Marks the end of execution, successful or not.

Response
application/json
{
  "name": "automations/credit-approval-workflow/executions/exec-20240315-001",
  "automation": "automations/credit-approval-workflow",
  "inputParameters": {
    "property1": {},
    "property2": {}
  },
  "state": "STATE_UNSPECIFIED",
  "forms": [
    "workspaces/example-financial/forms/kyc-verification-form"
  ],
  "error": {
    "code": 0,
    "message": "string",
    "details": [ … ]
  },
  "startTime": "1s",
  "endTime": "1s"
}

Cancel an automation execution

Request

Cancels a running automation execution.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
automationstringrequired

The automation id.

executionstringrequired

The execution id.

curl -i -X POST \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/automations/{automation}/executions/{execution}:cancel' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
namestring(name)

(IDENTIFIER) The resource name of the automation. Format: automations/{automation}/executions/{execution}

automationstring(automation)read-only

The automation being executed. Format: automations/{automation}

inputParametersobject(google.protobuf.Struct)read-only

Input parameters provided for the execution.

statestring(bndry.api.platform.automations.v1alpha.AutomationExecution.State)read-only

Current execution state.

Enum"STATE_UNSPECIFIED""ACTIVE""REQUIRES_INPUT""SUCCEEDED""FAILED""CANCELLED"
formsArray of strings(forms)read-only

The resource names of the forms that require a response to continue the execution.

errorobject(google.rpc.Status)read-only

Output only. The error which caused the execution to finish prematurely. The value is only present if the execution's state is FAILED or CANCELLED.

startTimestring(date-time)(google.protobuf.Timestamp)read-only

Output only. Timestamp when execution started.

endTimestring(date-time)(google.protobuf.Timestamp)read-only

Output only. Marks the end of execution, successful or not.

Response
application/json
{
  "name": "automations/credit-approval-workflow/executions/exec-20240315-001",
  "automation": "automations/credit-approval-workflow",
  "inputParameters": {
    "property1": {},
    "property2": {}
  },
  "state": "STATE_UNSPECIFIED",
  "forms": [
    "workspaces/example-financial/forms/kyc-verification-form"
  ],
  "error": {
    "code": 0,
    "message": "string",
    "details": [ … ]
  },
  "startTime": "1s",
  "endTime": "1s"
}

EventService

EventService provides operations for managing events

Operations

Notes

Operations

Tenants

Service for managing tenants.

Operations

Entities

Operations

Onboard Individual (Verify Identity)

Service for managing individual entity onboarding jobs.

Operations

Truuth

TruuthService provides an API for the BNDRY SPA to initiate a new verification session with Truuth

Operations