ReferenceApps

Call action

Call an action on an installed app

POST
/apps/actions/call
AuthorizationBearer <token>

Bearer token authentication. Use your API key as the bearer token.

In: header

Call action input

actionIdentifierstring

ActionIdentifier is the unique identifier for the action to be called. Format: "blueprint_uid@v/actions/action_uid" if blueprint context is available.

blueprintId?string

BlueprintID is the specific blueprint ID to use. If set, overrides the blueprint derived from ActionIdentifier. Useful for calling actions from draft blueprints or specific blueprint versions.

connectionId?string

ConnectionID is the ID of the connection to use for the action. If not set, the default connection will be used if the action requires a connection and a common connection is available in the matrix. If the action does not require a connection, this field will be ignored.

flowMode?boolean

FlowMode indicates whether the action is called as part of a flow execution. When true, step output options will be processed and flow-specific behavior is enabled.

input?unknown

Input contains the input data to pass to the action. The structure depends on the specific action being called.

parentTaskId?string

ParentTaskID is the ID of the parent task if this action is being called as a subtask. Used for task hierarchy and tracking purposes.

waitForResult?boolean

WaitForResult controls whether the call should wait for the action to complete. If true or not set, the call blocks until the action completes and returns the result. If false, the call returns immediately with the task info, and the action executes asynchronously.

Response Body

curl -X POST "https://eu1.api.bivariant.com/v1/apps/actions/call" \  -H "Content-Type: application/json" \  -d '{    "actionIdentifier": "string"  }'
{
  "data": null,
  "error": {
    "code": "string",
    "message": "string"
  },
  "options": [
    "string"
  ],
  "task": {
    "appId": "string",
    "authorId": "string",
    "children": [
      {
        "appId": "string",
        "authorId": "string",
        "children": [],
        "createdAt": "string",
        "description": "string",
        "endedAt": "string",
        "errors": [
          {
            "code": "string",
            "message": "string"
          }
        ],
        "executorId": "string",
        "id": "string",
        "input": null,
        "kind": "default",
        "organizationId": "string",
        "output": null,
        "params": {
          "property1": null,
          "property2": null
        },
        "parentId": "string",
        "startedAt": "string",
        "stateId": "string",
        "status": "created",
        "targetId": "string",
        "title": "string",
        "updatedAt": "string"
      }
    ],
    "createdAt": "string",
    "description": "string",
    "endedAt": "string",
    "errors": [
      {
        "code": "string",
        "message": "string"
      }
    ],
    "executorId": "string",
    "id": "string",
    "input": null,
    "kind": "default",
    "organizationId": "string",
    "output": null,
    "params": {
      "property1": null,
      "property2": null
    },
    "parentId": "string",
    "startedAt": "string",
    "stateId": "string",
    "status": "created",
    "targetId": "string",
    "title": "string",
    "updatedAt": "string"
  }
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}