OpsChain logo
API docs by Redocly

OpsChain API (v1)

Download OpenAPI specification:

LimePoint Pty Ltd: opschain@limepoint.com URL: https://opschain.io

Introduction

OpsChain is an orchestration and change automation platform based in GitOps principles with a core objective to Unify Change. Connect, automate, and orchestrate people, processes, and tools across your on-premise and cloud platforms.

version: 2026-06-29 (2f3ceabcc)

Projects

Endpoints to interact with projects.

Notes:

  • The show and list response payloads include links to the project's assets, changes, scheduled activity, bookmarks and MintModels endpoints. These endpoints act like the assets, changes, scheduled activity, bookmarks and MintModels endpoints respectively.
  • The list, create, show, update and archive asset endpoints are available via the /<path/to/asset/owner>/assets path. The example endpoints in this section reflect assets owned by a project.

List projects

Lists all projects (including archived projects).

Each project in the response includes a link to:

  • the project's changes endpoint for managing changes belonging to this project. It acts like the changes endpoint.
  • the project's scheduled_activities endpoint for managing scheduled activities belonging to this project. It acts like a scheduled activities endpoint.
  • the project's bookmarks endpoint for managing the bookmarks belonging to this project. It acts like a bookmarks endpoint.
  • the project's mintmodels endpoint for managing the MintModels belonging to this project. It acts like a MintModels endpoint.
  • the project's mintmodel_history endpoint for viewing this project's MintModel history. It acts like a MintModel history endpoint.
  • the project's workflows endpoint for viewing this project's workflows. It acts like a Workflows endpoint. .
query Parameters
filter[<query/sort filter>]=
string
Example: filter[<query/sort filter>]==> filter[code_eq]=opc
download
string
Example: download=projects.csv

Download the projects in CSV format with the specified file name. The projects will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "40a6b2ae-ca2c-4d2d-8933-2fc57ce2eda9",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}

Create project

Creates a project.

Request Body schema: application/vnd.api+json
required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "code": "opc",
      • "name": "OpsChain",
      • "description": "OpsChain project",
      • "project_type": "Enterprise"
      }
    }
}

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    • "id": "2a5b3181-e73e-4df7-9402-5dd3d9d5de9b",
    • "type": "project",
    • "attributes": {
      • "code": "bcne1",
      • "name": "iure573",
      • "description": "Est voluptas sit vel.",
      • "archived": false,
      • "created_by": "logged_in_user",
      • "project_type": "Standard"
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "children": {
        },
      • "bookmarks": {
        }
      },
    • "links": {
      • "self": "/api/projects/bcne1",
      • "bookmarks": "/api/projects/bcne1/bookmarks",
      • "git_remotes": "/api/projects/bcne1/git_remotes",
      • "environments": "/api/projects/bcne1/environments"
      },
    • "meta": {
      • "can_have_changes": false,
      • "can_have_children": true,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": false,
      • "child_node_types": [
        ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}

Show project

Shows a project, including any direct children.

The response includes a link to:

  • the project's changes endpoint for managing changes belonging to this project. It acts like the changes endpoint.
  • the project's scheduled_activities endpoint for managing scheduled activities belonging to this project. It acts like a scheduled activities endpoint.
  • the project's bookmarks endpoint for managing the bookmarks belonging to this project. It acts like a bookmarks endpoint.
  • the project's mintmodels endpoint for managing the MintModels belonging to this project. It acts like a MintModels endpoint.
  • the project's mintmodel_history endpoint for viewing this project's MintModel history. It acts like a MintModel history endpoint.
  • the project's workflows endpoint for viewing this project's workflows. It acts like a Workflows endpoint. .
path Parameters
project_code
required
string
Example: opc

project code

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    • "id": "057eccf8-abdb-4cae-9061-95f1205b9cca",
    • "type": "project",
    • "attributes": {
      • "code": "opc",
      • "name": "OpsChain",
      • "description": "OpsChain project",
      • "archived": false,
      • "created_by": "ernestine_hane",
      • "project_type": "Enterprise"
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "children": {
        },
      • "bookmarks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc",
      • "bookmarks": "/api/projects/opc/bookmarks",
      • "changes": "/api/projects/opc/changes",
      • "scheduled_activities": "/api/projects/opc/scheduled_activities",
      • "git_remotes": "/api/projects/opc/git_remotes",
      • "workflows": "/api/projects/opc/workflows",
      • "workflow_runs": "/api/projects/opc/workflow_runs",
      • "templates": "/api/projects/opc/templates",
      • "environments": "/api/projects/opc/environments",
      • "assets": "/api/projects/opc/assets",
      • "agents": "/api/projects/opc/agents"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": true,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": true,
      • "requires_template": false,
      • "child_node_types": [
        ],
      • "can_have_workflows": true,
      • "authorisations": {
        }
      }
    },
  • "included": [ ]
}

Update project

Updates a project.

path Parameters
project_code
required
string
Example: opc

project code

Request Body schema: application/vnd.api+json
required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "name": "Modified",
      • "description": "The updated project",
      • "archived": false
      }
    }
}

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e8746490-a465-4e16-bf54-1f884048498a",
    • "type": "project",
    • "attributes": {
      • "code": "opc",
      • "name": "repellat582",
      • "description": "Et omnis voluptate et.",
      • "archived": true,
      • "created_by": "donella_lynch",
      • "project_type": "Standard"
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "children": {
        },
      • "bookmarks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc",
      • "bookmarks": "/api/projects/opc/bookmarks",
      • "git_remotes": "/api/projects/opc/git_remotes",
      • "environments": "/api/projects/opc/environments"
      },
    • "meta": {
      • "can_have_changes": false,
      • "can_have_children": true,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": false,
      • "child_node_types": [
        ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}

Archive project

Archives a project.

path Parameters
project_code
required
string
Example: opc

project code

query Parameters
ignore_in_use
boolean

When true and the requesting user is a superuser, bypasses in use checks and force-destroys the project.

Responses

Response samples

Content type
text/plain
Environments
Endpoints to interact with environments.


Notes:


    

  • The show and list response payloads include links to the environment's assets, changes, scheduled activity, bookmarks and MintModels endpoints. These endpoints act like
the assets, changes, scheduled activity, bookmarks and MintModels endpoints respectively.
    • 

  • The list, create, show, update and archive asset endpoints are available via the /<path/to/asset/owner>/assets path. The example endpoints in this section reflect assets owned by a project.
    • 



List environments 
Lists all project environments (including archived environments).


Each environment in the response includes a link to:


    

  • the environment's changes endpoint for managing changes belonging to this environment. It acts like the changes endpoint.
    • 

  • the environment's scheduled_activities endpoint for managing scheduled activities belonging to this environment. It acts like a scheduled activities endpoint.
    • 

  • the environment's bookmarks endpoint for managing the bookmarks belonging to this environment. It acts like a bookmarks endpoint.
    • 

  • the environment's mintmodels endpoint for managing the MintModels belonging to this environment. It acts like a MintModels endpoint.
    • 

  • the environment's mintmodel_history endpoint for viewing this environment's MintModel history. It acts like a MintModel history endpoint.
    • 

  • the environment's workflows endpoint for viewing this environment's workflows. It acts like a Workflows endpoint.
.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_eq]=Test
download
string
 
 Example:  download=environments.csv
Download the project environments in CSV format with the specified file name. The environments will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "767b3c0e-546d-4a02-886f-95102ff9c83f",
      • "type": "environment",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create environment 
Creates an environment.


path Parameters
project_code
required
string
 
 Example:  opc
project code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "code": "dev",
      • "name": "Development",
      • "description": "OpsChain development environment"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "8225618a-da12-4568-8845-0cc58f2595ef",
    • "type": "environment",
    • "attributes": {
      • "code": "peqw9",
      • "name": "et501",
      • "description": "Saepe rerum repudiandae distinctio.",
      • "archived": false,
      • "created_by": "logged_in_user"
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "children": {
        },
      • "bookmarks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/peqw9",
      • "bookmarks": "/api/projects/opc/environments/peqw9/bookmarks",
      • "changes": "/api/projects/opc/environments/peqw9/changes",
      • "scheduled_activities": "/api/projects/opc/environments/peqw9/scheduled_activities",
      • "parent": "/api/projects/opc",
      • "assets": "/api/projects/opc/environments/peqw9/assets"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": true,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": false,
      • "child_node_types": [
        ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}
Show environment 
Shows an environment.


The response includes a link to:


    

  • the environment's changes endpoint for managing changes belonging to this environment. It acts like the changes endpoint.
    • 

  • the environment's scheduled_activities endpoint for managing scheduled activities belonging to this environment. It acts like a scheduled activities endpoint.
    • 

  • the environment's bookmarks endpoint for managing the bookmarks belonging to this environment. It acts like a bookmarks endpoint.
    • 

  • the environment's mintmodels endpoint for managing the MintModels belonging to this environment. It acts like a MintModels endpoint.
    • 

  • the environment's mintmodel_history endpoint for viewing this environment's MintModel history. It acts like a MintModel history endpoint.
    • 

  • the environment's workflows endpoint for viewing this environment's workflows. It acts like a Workflows endpoint.
.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


environment_code
required
string
 
 Example:  dev
environment code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "52ceafa8-f95c-483b-aaae-5d45d6c5077d",
    • "type": "environment",
    • "attributes": {
      • "code": "dev",
      • "name": "Development",
      • "description": "OpsChain development environment",
      • "archived": false,
      • "created_by": "jaclyn_kerluke"
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "children": {
        },
      • "bookmarks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev",
      • "bookmarks": "/api/projects/opc/environments/dev/bookmarks",
      • "changes": "/api/projects/opc/environments/dev/changes",
      • "scheduled_activities": "/api/projects/opc/environments/dev/scheduled_activities",
      • "parent": "/api/projects/opc",
      • "assets": "/api/projects/opc/environments/dev/assets"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": true,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": false,
      • "child_node_types": [
        ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    },
  • "included": [
    • {
      • "id": "5558910e-af32-4bf3-b5c0-34ce7846f83d",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ]
}
Update environment 
Updates an environment.


path Parameters
project_code
required
string
 
 Example:  opc
project code


environment_code
required
string
 
 Example:  dev
environment code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "name": "Modified",
      • "description": "The updated environment",
      • "archived": false
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "35c1f8fd-ee88-4e4f-8a67-a8ececfa31d4",
    • "type": "environment",
    • "attributes": {
      • "code": "dev",
      • "name": "qui511",
      • "description": "Ad laboriosam adipisci ea.",
      • "archived": true,
      • "created_by": "aline"
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "children": {
        },
      • "bookmarks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev",
      • "bookmarks": "/api/projects/opc/environments/dev/bookmarks",
      • "changes": "/api/projects/opc/environments/dev/changes",
      • "scheduled_activities": "/api/projects/opc/environments/dev/scheduled_activities",
      • "parent": "/api/projects/opc",
      • "assets": "/api/projects/opc/environments/dev/assets"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": true,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": false,
      • "child_node_types": [
        ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}
Archive environment 
Archives an environment.


path Parameters
project_code
required
string
 
 Example:  opc
project code


environment_code
required
string
 
 Example:  dev
environment code


query Parameters
ignore_in_use
boolean
 
When true and the requesting user is a superuser, bypasses in use checks and force-destroys the environment.


Responses
 Response samples 
Content type
text/plain
Show converged settings 
Show the converged settings for this environment, merged from all settings sources in the hierarchy (global, project, and environment settings).


The response includes a setting_sources meta object that attributes each setting value to its originating source.


path Parameters
project_code
required
string
 
 Example:  opc
project code


environment_code
required
string
 
 Example:  dev
environment code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "dev",
    • "type": "converged_settings",
    • "attributes": {
      • "data": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev/converged_settings"
      },
    • "meta": {
      • "setting_sources": {
        }
      }
    }
}
Show converged properties 
Show the converged properties for this environment, merged from all database properties sources in the hierarchy (project and environment properties).


The API response will also include the individual database properties that were included in the result.


path Parameters
project_code
required
string
 
 Example:  opc
project code


environment_code
required
string
 
 Example:  dev
environment code


query Parameters
converge_date
string
 
 Example:  converge_date=2026-06-29T07:52:21+00:00
Specify the date (and optionally time), to derive the active environment properties from.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "dev",
    • "type": "converged_properties",
    • "attributes": {
      • "data": {
        }
      },
    • "relationships": {
      • "repository_properties": {
        },
      • "properties": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev/converged_properties"
      },
    • "meta": {
      • "property_sources": {
        }
      }
    },
  • "included": [
    • {
      • "id": "71653f02-2ec3-4c2c-b0e6-64a6c5328ea4",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "082f2ff1-c15e-427e-b4b0-41fc9373f13a",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ]
}
Agents
Endpoints to interact with agents.


Notes:


    

  • The show and list response payloads include links to the agent's assets, changes, scheduled activity, bookmarks and MintModels endpoints. These endpoints act like
the assets, changes, scheduled activity, bookmarks and MintModels endpoints respectively.
    • 

  • The list, create, show, update and archive asset endpoints are available via the /<path/to/asset/owner>/assets path. The example endpoints in this section reflect assets owned by a project.
    • 



Build agent image 
Builds the container image for an agent. Note, this does not restart the agent.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c7c4afaf-27f3-473f-bf04-3bbf55bad664",
    • "type": "node_background_task",
    • "attributes": {
      • "request_number": 2,
      • "status_code": "initializing",
      • "error_message": null,
      • "created_by": "logged_in_user",
      • "task_type": "BuildAgentImageTask",
      • "created_at": "2026-06-29T07:52:30.687681Z",
      • "updated_at": "2026-06-29T07:52:30.687681Z",
      • "image_sha": null,
      • "image_purged": false,
      • "image_in_use": false
      },
    • "relationships": {
      • "template_version_history": {
        },
      • "owner": {
        }
      },
    • "links": {
      • "template_version": "/api/projects/opc/templates/9b13a8bf-082a-4708-a742-318f5855d4ca/versions/2026_Q1_2",
      • "self": "/api/projects/opc/agents/agent1/node_background_tasks/c7c4afaf-27f3-473f-bf04-3bbf55bad664",
      • "agent": "/api/projects/opc/agents/agent1",
      • "log_lines": "/api/node_background_task_log_lines?node_background_task_id=c7c4afaf-27f3-473f-bf04-3bbf55bad664"
      }
    }
}
Show agent status 
Shows the status for an agent.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "9fc08e65-2d4e-4e67-92b5-e34008b88147",
    • "type": "agent_status",
    • "attributes": {
      • "desired_status": "running",
      • "status": "initializing",
      • "image_build_status": "ready",
      • "active_image_sha": null,
      • "newest_image_sha": "sha256:7655e0d4a9fe96130dc9e62dd8d85536e3ba743398d5e5ba5801a9fb0bbd2082"
      },
    • "relationships": {
      • "node": {
        },
      • "referenced_build_agent_image_task": {
        },
      • "available_build_agent_image_tasks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/agent1/status",
      • "log_lines": "/api/projects/opc/agents/agent1/status/log_lines"
      }
    },
  • "included": [
    • {
      • "id": "94f02b3c-ef3c-4a8e-ad39-b8df23abaaaa",
      • "type": "node_background_task",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Update agent status 
Update an agent status.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "desired_status": "running",
      • "image_sha": "sha256:de10faf919fc71ba4eb1dd7bd6449566d012b0c9436b1c61bfee21d621b009aa"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e9889830-cf39-4092-9903-087a4b71ee3b",
    • "type": "agent_status",
    • "attributes": {
      • "desired_status": "running",
      • "status": "initializing",
      • "image_build_status": "ready",
      • "active_image_sha": null,
      • "newest_image_sha": "sha256:7655e0d4a9fe96130dc9e62dd8d85536e3ba743398d5e5ba5801a9fb0bbd2082"
      },
    • "relationships": {
      • "node": {
        },
      • "referenced_build_agent_image_task": {
        },
      • "available_build_agent_image_tasks": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/agent1/status",
      • "log_lines": "/api/projects/opc/agents/agent1/status/log_lines"
      }
    },
  • "included": [
    • {
      • "id": "334f3a5f-748f-4306-9abd-19670a5ef326",
      • "type": "node_background_task",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Show agent log lines 
Shows log lines for the agent.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "cb053b5a-5777-42bd-93f6-c0d4ed232c99",
      • "type": "agent_log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Show agent Kubernetes events 
Shows Kubernetes events for the agent. This request will only succeed when the agent is running.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "0",
      • "type": "agent_event",
      • "attributes": {
        }
      }
    ]
}
List agents 
Lists all agents (including archived agents) that belong to the project.


Each agent in the response includes a link to:


    

  • the agent's changes endpoint for managing changes belonging to this agent. It acts like the changes endpoint.
    • 

  • the agent's scheduled_activities endpoint for managing scheduled activities belonging to this agent. It acts like a scheduled activities endpoint.
    • 

  • the agent's bookmarks endpoint for managing the bookmarks belonging to this agent. It acts like a bookmarks endpoint.
    • 

  • the agent's mintmodels endpoint for managing the MintModels belonging to this agent. It acts like a MintModels endpoint.
    • 

  • the agent's mintmodel_history endpoint for viewing this agent's MintModel history. It acts like a MintModel history endpoint.
    • 

  • the agent's workflows endpoint for viewing this agent's workflows. It acts like a Workflows endpoint.
.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_eq]=Test
download
string
 
 Example:  download=agents.csv
Download the agents in CSV format with the specified file name. The agents will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "ee50ff58-cac9-4346-957f-348dc2e7e1f9",
      • "type": "agent",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create agent 
Creates an agent.


path Parameters
project_code
required
string
 
 Example:  opc
project code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "code": "agent1",
      • "name": "Agent",
      • "description": "Asset description",
      • "template_code": "agn",
      • "template_version": "2026_Q1_2"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "fd155c7b-fc06-4536-9534-6853673d527b",
    • "type": "agent",
    • "attributes": {
      • "code": "kf8tf",
      • "name": "officiis425",
      • "description": "Hic cumque qui quibusdam.",
      • "archived": false,
      • "created_by": "logged_in_user",
      • "task_active": true
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "template_version": {
        },
      • "bookmarks": {
        },
      • "template": {
        },
      • "current_node_background_task": {
        },
      • "agent_status": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/kf8tf",
      • "bookmarks": "/api/projects/opc/agents/kf8tf/bookmarks",
      • "converged_properties": "/api/projects/opc/agents/kf8tf/converged_properties",
      • "parent": "/api/projects/opc",
      • "node_background_tasks": "/api/projects/opc/agents/kf8tf/node_background_tasks",
      • "version_history": "/api/projects/opc/agents/kf8tf/version_history"
      },
    • "meta": {
      • "can_have_changes": false,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": true,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}
Show agent 
Shows an agent belonging to a project.


The response includes a link to:


    

  • the agent's changes endpoint for managing changes belonging to this agent. It acts like the changes endpoint.
    • 

  • the agent's scheduled_activities endpoint for managing scheduled activities belonging to this agent. It acts like a scheduled activities endpoint.
    • 

  • the agent's bookmarks endpoint for managing the bookmarks belonging to this agent. It acts like a bookmarks endpoint.
    • 

  • the agent's mintmodels endpoint for managing the MintModels belonging to this agent. It acts like a MintModels endpoint.
    • 

  • the agent's mintmodel_history endpoint for viewing this agent's MintModel history. It acts like a MintModel history endpoint.
    • 

  • the agent's workflows endpoint for viewing this agent's workflows. It acts like a Workflows endpoint.
.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "610252ad-e7df-4a5d-a09f-554a85c4da2a",
    • "type": "agent",
    • "attributes": {
      • "code": "agent1",
      • "name": "Agent",
      • "description": "Asset description",
      • "archived": false,
      • "created_by": "alva_west",
      • "actions": [ ],
      • "task_active": false
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "template_version": {
        },
      • "bookmarks": {
        },
      • "template": {
        },
      • "current_node_background_task": {
        },
      • "agent_status": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/agent1",
      • "bookmarks": "/api/projects/opc/agents/agent1/bookmarks",
      • "converged_properties": "/api/projects/opc/agents/agent1/converged_properties",
      • "parent": "/api/projects/opc",
      • "node_background_tasks": "/api/projects/opc/agents/agent1/node_background_tasks",
      • "version_history": "/api/projects/opc/agents/agent1/version_history"
      },
    • "meta": {
      • "can_have_changes": false,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": true,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    },
  • "included": [
    • {
      • "id": "c0d138a6-32f3-4924-adbb-6caf90bc13c3",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "522a90ec-d9b9-4fa5-b1fb-40e061ce7054",
      • "type": "template",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "39037604-0a9d-4e95-ad36-8c78cff81b15",
      • "type": "template_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "3e88bbb1-5d55-4d18-9979-e06b1aec2f22",
      • "type": "node_background_task",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "c39ab85b-5662-418a-9a78-3fc75e5a319e",
      • "type": "agent_status",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Update agent 
Updates an agent belonging to a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "name": "Modified",
      • "description": "The updated agent",
      • "archived": false
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "8cdb0448-0ee4-45e2-a85b-cff890b449c5",
    • "type": "agent",
    • "attributes": {
      • "code": "agent1",
      • "name": "ipsum435",
      • "description": "Ea architecto quod qui.",
      • "archived": true,
      • "created_by": "angeles",
      • "task_active": false
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "template_version": {
        },
      • "bookmarks": {
        },
      • "template": {
        },
      • "current_node_background_task": {
        },
      • "agent_status": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/agent1",
      • "bookmarks": "/api/projects/opc/agents/agent1/bookmarks",
      • "converged_properties": "/api/projects/opc/agents/agent1/converged_properties",
      • "parent": "/api/projects/opc",
      • "node_background_tasks": "/api/projects/opc/agents/agent1/node_background_tasks",
      • "version_history": "/api/projects/opc/agents/agent1/version_history"
      },
    • "meta": {
      • "can_have_changes": false,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": true,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}
Archive agent 
Archives an agent belonging to a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


Responses
 Response samples 
Content type
text/plain
Show converged settings 
Show the converged settings for this agent, merged from all settings sources in the hierarchy (global and project settings).


The response includes a setting_sources meta object that attributes each setting value to its originating source.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


query Parameters
converge_date
string
 
 Example:  converge_date=2026-06-29T07:52:20+00:00
Specify the date (and optionally time), to derive the active template version and agent settings from.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "agent1",
    • "type": "converged_settings",
    • "attributes": {
      • "data": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/agent1/converged_settings"
      },
    • "meta": {
      • "setting_sources": {
        }
      }
    }
}
Show converged properties 
Show the converged properties as they will appear for this agent. i.e. the endpoint will


    

  1. merge any template (repository) properties from the agent's template (in the order described in the documentation)
    2. 

  2. merge any project properties
    3. 

  3. merge any properties assigned to the agent
    4. 



The API response will also include all the individual repository and database properties that were included in the result.


path Parameters
project_code
required
string
 
 Example:  opc
project code


agent_code
required
string
 
 Example:  agent1
agent code


query Parameters
converge_date
string
 
 Example:  converge_date=2026-06-29T07:52:20+00:00
Specify the date (and optionally time), to derive the active template version and agent properties from.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "agent1",
    • "type": "converged_properties",
    • "attributes": {
      • "data": {
        }
      },
    • "relationships": {
      • "repository_properties": {
        },
      • "properties": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/agents/agent1/converged_properties"
      },
    • "meta": {
      • "property_sources": {
        }
      }
    },
  • "included": [
    • {
      • "id": "b9f562d0-9dc3-4708-8220-6d1a88de59a0",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "0258c88d-2112-47d6-8c68-6ad344987f0e",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "b7a787ed-be2c-4b09-a3af-8e7a1bd49cd5",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "properties.yaml",
      • "type": "repository_properties",
      • "attributes": {
        },
      • "links": {
        }
      },
    • {
      • "id": "projects/opc.yaml",
      • "type": "repository_properties",
      • "attributes": {
        },
      • "links": {
        }
      }
    ]
}
Assets
Endpoints to interact with assets.


Notes:


    

  • The show and list response payloads include links to the asset's changes, scheduled activity, bookmarks and MintModels endpoints. These endpoints act like
the changes, scheduled activity, bookmarks and MintModels endpoints respectively.
    • 

  • The list, create, show, update and archive asset endpoints are available via the /<path/to/asset/owner>/assets path. The example endpoints in this section reflect assets owned by a project.
    • 



List assets 
Lists all assets (including archived assets) that belong to the project.


Each asset in the response includes a link to:


    

  • the asset's changes endpoint for managing changes belonging to this asset. It acts like the changes endpoint.
    • 

  • the asset's scheduled_activities endpoint for managing scheduled activities belonging to this asset. It acts like a scheduled activities endpoint.
    • 

  • the asset's bookmarks endpoint for managing the bookmarks belonging to this asset. It acts like a bookmarks endpoint.
    • 

  • the asset's mintmodels endpoint for managing the MintModels belonging to this asset. It acts like a MintModels endpoint.
    • 

  • the asset's mintmodel_history endpoint for viewing this asset's MintModel history. It acts like a MintModel history endpoint.
    • 

  • the asset's workflows endpoint for viewing this asset's workflows. It acts like a Workflows endpoint.
.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_eq]=Test
download
string
 
 Example:  download=assets.csv
Download the project assets in CSV format with the specified file name. The assets will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "9e26ff4c-74d5-444c-8aac-4ac10b24bf39",
      • "type": "asset",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create asset 
Creates an asset belonging to the project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "code": "prj_soa",
      • "name": "Project asset",
      • "description": "Project asset description",
      • "template_code": "soa",
      • "template_version": "2023_Q4_2"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "0e348e2a-a5ce-49e6-8eea-1a42d9eb69d6",
    • "type": "asset",
    • "attributes": {
      • "code": "45tfu",
      • "name": "beatae455",
      • "description": "Assumenda sint sit a.",
      • "archived": false,
      • "created_by": "logged_in_user",
      • "task_active": true
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "template_version": {
        },
      • "bookmarks": {
        },
      • "template": {
        },
      • "current_node_background_task": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/45tfu",
      • "bookmarks": "/api/projects/opc/assets/45tfu/bookmarks",
      • "changes": "/api/projects/opc/assets/45tfu/changes",
      • "scheduled_activities": "/api/projects/opc/assets/45tfu/scheduled_activities",
      • "converged_properties": "/api/projects/opc/assets/45tfu/converged_properties",
      • "mintmodels": "/api/projects/opc/assets/45tfu/mintmodels",
      • "mintmodel_history": "/api/projects/opc/assets/45tfu/mintmodel_history",
      • "parent": "/api/projects/opc",
      • "node_background_tasks": "/api/projects/opc/assets/45tfu/node_background_tasks",
      • "version_history": "/api/projects/opc/assets/45tfu/version_history"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": true,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}
Show asset 
Shows an asset belonging to a project.


The response includes a link to:


    

  • the asset's changes endpoint for managing changes belonging to this asset. It acts like the changes endpoint.
    • 

  • the asset's scheduled_activities endpoint for managing scheduled activities belonging to this asset. It acts like a scheduled activities endpoint.
    • 

  • the asset's bookmarks endpoint for managing the bookmarks belonging to this asset. It acts like a bookmarks endpoint.
    • 

  • the asset's mintmodels endpoint for managing the MintModels belonging to this asset. It acts like a MintModels endpoint.
    • 

  • the asset's mintmodel_history endpoint for viewing this asset's MintModel history. It acts like a MintModel history endpoint.
    • 

  • the asset's workflows endpoint for viewing this asset's workflows. It acts like a Workflows endpoint.
.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4ef9f21e-bd32-4a94-9ea1-a46510f26785",
    • "type": "asset",
    • "attributes": {
      • "code": "prj_soa",
      • "name": "Project asset",
      • "description": "Project asset description",
      • "archived": false,
      • "created_by": "karry.hamill",
      • "actions": [
        ],
      • "mintmodel_valid": true,
      • "erb_file_content": "<MintModel erb file contents>",
      • "task_active": false
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "template_version": {
        },
      • "bookmarks": {
        },
      • "template": {
        },
      • "current_node_background_task": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa",
      • "bookmarks": "/api/projects/opc/assets/prj_soa/bookmarks",
      • "changes": "/api/projects/opc/assets/prj_soa/changes",
      • "scheduled_activities": "/api/projects/opc/assets/prj_soa/scheduled_activities",
      • "converged_properties": "/api/projects/opc/assets/prj_soa/converged_properties",
      • "mintmodels": "/api/projects/opc/assets/prj_soa/mintmodels",
      • "mintmodel_history": "/api/projects/opc/assets/prj_soa/mintmodel_history",
      • "parent": "/api/projects/opc",
      • "node_background_tasks": "/api/projects/opc/assets/prj_soa/node_background_tasks",
      • "version_history": "/api/projects/opc/assets/prj_soa/version_history"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": true,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    },
  • "included": [
    • {
      • "id": "a0cae1fd-7d24-4d45-aab8-a01a219ef27a",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "7c232de7-c678-4201-893a-93069187fb90",
      • "type": "bookmark",
      • "attributes": {},
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "adc4c421-1e4d-4bbe-8aaf-d0f275524a72",
      • "type": "template",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "e2e9fa8d-3818-427a-8ad8-18b62215d735",
      • "type": "template_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Update asset 
Updates an asset belonging to a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "name": "Modified",
      • "description": "The updated asset",
      • "archived": false
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "fb2f31bf-42a1-4314-8ac6-3cc06df492ca",
    • "type": "asset",
    • "attributes": {
      • "code": "prj_soa",
      • "name": "earum465",
      • "description": "Laboriosam omnis earum aspernatur.",
      • "archived": true,
      • "created_by": "lucius.hessel",
      • "task_active": false
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "settings": {
        },
      • "parent": {
        },
      • "project": {
        },
      • "template_version": {
        },
      • "bookmarks": {
        },
      • "template": {
        },
      • "current_node_background_task": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa",
      • "bookmarks": "/api/projects/opc/assets/prj_soa/bookmarks",
      • "changes": "/api/projects/opc/assets/prj_soa/changes",
      • "scheduled_activities": "/api/projects/opc/assets/prj_soa/scheduled_activities",
      • "converged_properties": "/api/projects/opc/assets/prj_soa/converged_properties",
      • "mintmodels": "/api/projects/opc/assets/prj_soa/mintmodels",
      • "mintmodel_history": "/api/projects/opc/assets/prj_soa/mintmodel_history",
      • "parent": "/api/projects/opc",
      • "node_background_tasks": "/api/projects/opc/assets/prj_soa/node_background_tasks",
      • "version_history": "/api/projects/opc/assets/prj_soa/version_history"
      },
    • "meta": {
      • "can_have_changes": true,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": true,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    }
}
Archive asset 
Archives an asset belonging to a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
ignore_in_use
boolean
 
When true and the requesting user is a superuser, bypasses in use checks and force-destroys the asset.


Responses
 Response samples 
Content type
text/plain
Show converged settings 
Show the converged settings for this asset, merged from all settings sources in the hierarchy (global, project, environment, and asset settings).


The response includes a setting_sources meta object that attributes each setting value to its originating source.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
converge_date
string
 
 Example:  converge_date=2026-06-29T07:52:21+00:00
Specify the date (and optionally time), to derive the active template version and asset settings from.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "prj_soa",
    • "type": "converged_settings",
    • "attributes": {
      • "data": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/converged_settings"
      },
    • "meta": {
      • "setting_sources": {
        }
      }
    }
}
Show converged properties 
Show the converged properties as they will appear to actions run on this asset. i.e. the endpoint will


    

  1. merge any template (repository) properties from the asset's template (in the order described in the documentation)
    2. 

  2. merge any project properties
    3. 

  3. merge any properties assigned to the project asset
    4. 



The API response will also include all the individual repository and database properties that were included in the result.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
converge_date
string
 
 Example:  converge_date=2026-06-29T07:52:21+00:00
Specify the date (and optionally time), to derive the active template version and asset properties from.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "prj_soa",
    • "type": "converged_properties",
    • "attributes": {
      • "data": {
        }
      },
    • "relationships": {
      • "repository_properties": {
        },
      • "properties": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/converged_properties"
      },
    • "meta": {
      • "property_sources": {
        }
      }
    },
  • "included": [
    • {
      • "id": "2f9e5561-ad1e-4a49-9299-1545f288314d",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "f954a55f-e08d-46a7-927a-011ccbbc9519",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "bb594ac6-1d6a-4416-a1ed-0646a69e4b77",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "properties.yaml",
      • "type": "repository_properties",
      • "attributes": {
        },
      • "links": {
        }
      },
    • {
      • "id": "projects/opc.yaml",
      • "type": "repository_properties",
      • "attributes": {
        },
      • "links": {
        }
      }
    ]
}
List generate actions request log lines 
List the log lines generated while building an image and querying the actions available for this asset / template version combination.


Note: See the list filtered log lines API docs for filtering options.


path Parameters
node_background_task_id
required
string
 
 Example:  3e7426c3-60b6-47be-85f2-6a30668abeef
query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
download
string
 
 Example:  download=change.log
Download the log lines with the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "9f2d75ec-8eae-4b6e-bb70-a432b78c6fa4",
      • "type": "node_background_task_log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Create generate actions request 
Create a request to refresh the actions list for an asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "43e3ff66-65ad-4287-8d29-d11fcd29dc9c",
    • "type": "node_background_task",
    • "attributes": {
      • "request_number": 1,
      • "status_code": "initializing",
      • "error_message": null,
      • "created_by": "logged_in_user",
      • "actions": [ ],
      • "task_type": "GenerateActionsRequest",
      • "created_at": "2026-06-29T07:53:24.793044Z",
      • "updated_at": "2026-06-29T07:53:24.793044Z"
      },
    • "relationships": {
      • "template_version_history": {
        },
      • "owner": {
        }
      },
    • "links": {
      • "template_version": "/api/projects/opc/templates/926023a2-23b6-49a9-aeb3-f696fb1901a6/versions/2023_Q4_2",
      • "self": "/api/projects/opc/assets/prj_soa/node_background_tasks/43e3ff66-65ad-4287-8d29-d11fcd29dc9c",
      • "asset": "/api/projects/opc/assets/prj_soa",
      • "log_lines": "/api/node_background_task_log_lines?node_background_task_id=43e3ff66-65ad-4287-8d29-d11fcd29dc9c"
      }
    }
}
List generate actions requests 
Lists all generate actions requests made for the asset's current template version.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[request_number_eq]=1
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "3c2ad164-6963-4268-a117-baccae6ab699",
      • "type": "node_background_task",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": false
      }
    }
}
Show generate actions request 
Show a specific actions generation request.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


node_background_task_id
required
string
 
 Example:  3e7426c3-60b6-47be-85f2-6a30668abeef
generate actions request id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "611f378b-c01c-4d24-b357-3e1180d129bb",
    • "type": "node_background_task",
    • "attributes": {
      • "request_number": 1,
      • "status_code": "success",
      • "error_message": null,
      • "created_by": "florinda",
      • "actions": [
        ],
      • "task_type": "GenerateActionsRequest",
      • "created_at": "2026-06-29T07:53:25.436281Z",
      • "updated_at": "2026-06-29T07:53:25.446363Z"
      },
    • "relationships": {
      • "template_version_history": {
        },
      • "owner": {
        }
      },
    • "links": {
      • "template_version": "/api/projects/opc/templates/651bd6b9-3bd5-446e-9efd-b33a9c6d8ba8/versions/2023_Q4_2",
      • "self": "/api/projects/opc/assets/prj_soa/node_background_tasks/611f378b-c01c-4d24-b357-3e1180d129bb",
      • "asset": "/api/projects/opc/assets/prj_soa",
      • "log_lines": "/api/node_background_task_log_lines?node_background_task_id=611f378b-c01c-4d24-b357-3e1180d129bb"
      }
    }
}
Cancel generate actions request 
Cancels the generate actions request.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


node_background_task_id
required
string
 
 Example:  3e7426c3-60b6-47be-85f2-6a30668abeef
generate actions request id


Responses
 Response samples 
Content type
text/plain
List properties history 
Lists all properties versions and template versions for the asset and its parents.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "128ccff8-b0cb-4534-8894-c3642b4f6201",
      • "type": "project",
      • "attributes": {
        }
      },
    • {
      • "id": "e75b2e9d-4dc1-44e3-b444-686d45549edf",
      • "type": "asset",
      • "attributes": {
        }
      }
    ]
}
List template version history 
Lists the template versions that have been assigned to the asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_eq]=Test
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "437fc7f5-3790-48b0-8a25-9b857de2fe77",
      • "type": "template_version_history",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show template version history 
Shows a specific project asset's template version history record.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


id
required
string
 
 Example:  3c0494e0-b39e-43a6-b3c7-a5e6d47a5ce6
version history id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "03921596-f6b7-4b2e-a84b-850327f25707",
    • "type": "template_version_history",
    • "attributes": {
      • "created_by": "yong.medhurst",
      • "active_from": "2026-06-29T07:53:50.040415Z",
      • "active_to": null
      },
    • "relationships": {
      • "owner": {
        },
      • "template_version": {
        },
      • "node_background_tasks": {
        }
      },
    • "links": {
      • "template_version": "/api/projects/opc/templates/48a3efab-53d4-423b-80e0-4a6bcaf443ae/versions/2023_Q4_2",
      • "self": "/api/projects/opc/assets/prj_soa/version_history/03921596-f6b7-4b2e-a84b-850327f25707",
      • "asset": "/api/projects/opc/assets/prj_soa"
      }
    },
  • "included": [
    • {
      • "id": "eec58057-017d-4593-a2ec-8d4ee50126d1",
      • "type": "asset",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "9e62a458-bbb0-4d1e-a428-3cba64ff1eaa",
      • "type": "template_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Templates
Templates provide the available actions and a base set of
repository properties that
will be used to configure the asset.


List template versions 
Lists all versions of a specific template.


path Parameters
project_code
required
string
 
 Example:  opc
project code


template_id
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[version_cont]=1.0
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "1b5ed5b1-b947-42e5-98e4-c21dea2375eb",
      • "type": "template_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create or update a template version 
Create or update a template version.


path Parameters
project_code
required
string
 
 Example:  opc
project code


template_id
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


version
required
string
 
 Example:  2023_Q4_2
template version


Request Body schema: application/vnd.api+json
required
object
 
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "description": "Added additional configuration options",
      • "git_rev": "virtual",
      • "archived": "false",
      • "locked": "false"
      }
    },
  • "meta": {
    • "ignore_in_use": false,
    • "fetch_revision": false
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4c13953f-2ad5-495f-ac60-38a9479a402e",
    • "type": "template_version",
    • "attributes": {
      • "version": "2023_Q4_2",
      • "description": "Aut perspiciatis quae aspernatur porro quidem eveniet voluptatum",
      • "state": "initializing",
      • "created_by": "logged_in_user",
      • "archived": false,
      • "initialization_error": null,
      • "locked": false,
      • "created_at": "2026-06-29T07:53:51.266449Z",
      • "updated_at": "2026-06-29T07:53:51.266449Z",
      • "has_mintmodel": false,
      • "git_rev": "bluetooth",
      • "commit_sha": null,
      • "git_remote_name": "github"
      },
    • "relationships": {
      • "properties": {
        },
      • "settings": {
        },
      • "project": {
        },
      • "template": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/91592476-9c54-4939-b675-eebb692664d6/versions/2023_Q4_2",
      • "template": "/api/projects/opc/templates/91592476-9c54-4939-b675-eebb692664d6"
      }
    }
}
Show template version 
Shows a specific template version.


path Parameters
project_code
required
string
 
 Example:  opc
project code


template_id
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


version
required
string
 
 Example:  2023_Q4_2
template version


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c327296f-2ec9-4c18-9995-41fafe12905c",
    • "type": "template_version",
    • "attributes": {
      • "version": "2023_Q4_2",
      • "description": "Added additional configuration options",
      • "state": "ready",
      • "created_by": "tasha_cremin",
      • "archived": false,
      • "initialization_error": null,
      • "locked": false,
      • "created_at": "2026-06-29T07:53:51.849981Z",
      • "updated_at": "2026-06-29T07:53:51.849981Z",
      • "has_mintmodel": true,
      • "git_rev": "haptic",
      • "commit_sha": "bc30aa46b91b87eff7c04bc2b9f0cd7d3b66cf69",
      • "git_remote_name": "github"
      },
    • "relationships": {
      • "properties": {
        },
      • "settings": {
        },
      • "project": {
        },
      • "template": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/fea29b33-9995-4918-8495-cf12a999a10d/versions/2023_Q4_2",
      • "template": "/api/projects/opc/templates/fea29b33-9995-4918-8495-cf12a999a10d"
      }
    },
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Bulk assign assets to template versions 
Assign assets to the template version.


path Parameters
project_code
required
string
 
 Example:  opc
project code


template_id
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


version
required
string
 
 Example:  2023_Q4_2
template version


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "asset_paths": [
        ]
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "73c5505c-4e4b-44ef-b58e-d5aab2b3bcd9",
    • "type": "template_version",
    • "attributes": {
      • "version": "2023_Q4_2",
      • "description": "Added additional configuration options",
      • "state": "ready",
      • "created_by": "renaldo",
      • "archived": false,
      • "initialization_error": null,
      • "locked": false,
      • "created_at": "2026-06-29T07:53:52.135239Z",
      • "updated_at": "2026-06-29T07:53:52.135239Z",
      • "has_mintmodel": true,
      • "git_rev": "optical",
      • "commit_sha": "70f03ba8b6a0084da1bcc67432a266b0621624f4",
      • "git_remote_name": "github"
      },
    • "relationships": {
      • "properties": {
        },
      • "settings": {
        },
      • "project": {
        },
      • "template": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/7144f94e-c2f4-4143-a0ca-ed99b6382478/versions/2023_Q4_2",
      • "template": "/api/projects/opc/templates/7144f94e-c2f4-4143-a0ca-ed99b6382478"
      }
    }
}
Create template 
Create a template.


path Parameters
project_code
required
string
 
 Example:  opc
project code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "code": "soa",
      • "name": "Oracle SOA template",
      • "template_type": "asset",
      • "description": "Oracle SOA Suite 12c (12.2.1.4.0)",
      • "git_remote_name": "github"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "6bb98a62-ae4e-436a-ba8c-82e6e94737f9",
    • "type": "template",
    • "attributes": {
      • "code": "64gza",
      • "name": "danilo_turner",
      • "description": "Unde ut quod at.",
      • "archived": false,
      • "disabled": false,
      • "template_type": "asset",
      • "created_at": "2026-06-29T07:53:52.844519Z",
      • "updated_at": "2026-06-29T07:53:52.844519Z"
      },
    • "relationships": {
      • "git_remote": {
        },
      • "template_versions": {
        },
      • "nodes": {
        },
      • "project": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/6bb98a62-ae4e-436a-ba8c-82e6e94737f9",
      • "template_versions": "/api/projects/opc/templates/6bb98a62-ae4e-436a-ba8c-82e6e94737f9/versions",
      • "project": "/api/projects/opc"
      }
    }
}
List templates 
Lists all templates for a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_cont]=base
exclude_archived_nodes
boolean
 
 Example:  exclude_archived_nodes=true
when true, excludes archived nodes from each template's nodes relationship


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "ee11bd4e-f150-420a-b645-f14de0754de2",
      • "type": "template",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show template 
Shows a project template.


path Parameters
project_code
required
string
 
 Example:  opc
project code


template_id
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


query Parameters
exclude_archived_nodes
boolean
 
 Example:  exclude_archived_nodes=true
when true, excludes archived nodes from each template's nodes relationship


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4a38f3d8-9878-49cc-a450-a6a8c587e285",
    • "type": "template",
    • "attributes": {
      • "code": "soa",
      • "name": "Oracle SOA template",
      • "description": "Oracle SOA Suite 12c (12.2.1.4.0)",
      • "archived": false,
      • "disabled": false,
      • "template_type": "asset",
      • "created_at": "2026-06-29T07:53:53.552501Z",
      • "updated_at": "2026-06-29T07:53:53.552501Z"
      },
    • "relationships": {
      • "git_remote": {
        },
      • "template_versions": {
        },
      • "nodes": {
        },
      • "project": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/4a38f3d8-9878-49cc-a450-a6a8c587e285",
      • "template_versions": "/api/projects/opc/templates/4a38f3d8-9878-49cc-a450-a6a8c587e285/versions",
      • "project": "/api/projects/opc"
      }
    },
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Archive template 
Archives/unarchives a template.


path Parameters
project_code
required
string
 
 Example:  opc
project code


id_to_archive
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "archived": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "40ae4297-bdcf-4122-82e9-b79eaf162474",
    • "type": "template",
    • "attributes": {
      • "code": "soa",
      • "name": "Oracle SOA template",
      • "description": "Oracle SOA Suite 12c (12.2.1.4.0)",
      • "archived": true,
      • "disabled": false,
      • "template_type": "asset",
      • "created_at": "2026-06-29T07:53:53.763806Z",
      • "updated_at": "2026-06-29T07:53:53.790894Z"
      },
    • "relationships": {
      • "git_remote": {
        },
      • "template_versions": {
        },
      • "nodes": {
        },
      • "project": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/40ae4297-bdcf-4122-82e9-b79eaf162474",
      • "template_versions": "/api/projects/opc/templates/40ae4297-bdcf-4122-82e9-b79eaf162474/versions",
      • "project": "/api/projects/opc"
      }
    }
}
Update template 
Update a templates details.


path Parameters
project_code
required
string
 
 Example:  opc
project code


id_to_update
required
string
 
 Example:  949944df-9da9-4904-8f9b-ac9753164aae
template id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "name": "Oracle SOA template",
      • "description": "Oracle SOA Suite 12c (12.2.1.4.0)",
      • "git_remote_name": "github",
      • "disabled": false
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "cd27b7e6-458b-4668-81fd-d37a72c63185",
    • "type": "template",
    • "attributes": {
      • "code": "soa",
      • "name": "updated_name",
      • "description": "updated_description",
      • "archived": false,
      • "disabled": false,
      • "template_type": "asset",
      • "created_at": "2026-06-29T07:53:54.096209Z",
      • "updated_at": "2026-06-29T07:53:54.118633Z"
      },
    • "relationships": {
      • "git_remote": {
        },
      • "template_versions": {
        },
      • "nodes": {
        },
      • "project": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/templates/cd27b7e6-458b-4668-81fd-d37a72c63185",
      • "template_versions": "/api/projects/opc/templates/cd27b7e6-458b-4668-81fd-d37a72c63185/versions",
      • "project": "/api/projects/opc"
      }
    }
}
Git remotes
Endpoints to interact with git remotes.


Create Git remote 
Create a project Git remote.


For HTTP(S) remotes provide the user and password credentials. For SSH remotes provide the ssh_key_data private key and, if the key is encrypted, its passphrase. Supplying password for an SSH remote (or passphrase for an HTTP(S) remote) is rejected.


When meta.add_known_host is true and the remote uses an SSH URL, OpsChain scans the host with ssh-keyscan and stores the fetched host key in the global known_hosts setting before validating the connection, so the same request - and all future fetches - trust the host. On success the response meta.known_hosts_added lists the registered host key lines. This requires superuser access (a non-superuser receives a 403). The scanned key is trusted on first use (TOFU); verify the reported host key out of band.


path Parameters
project_code
required
string
 
 Example:  opc
project code


Request Body schema: application/vnd.api+json
required
object
 
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {}
    },
  • "meta": {
    • "add_known_host": false
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "48669258-3ca6-4ad8-911e-13bcaaf8c2b4",
    • "type": "git_remote",
    • "attributes": {
      • "name": "github",
      • "url": "https://github.com/LimePoint/opschain-getting-started",
      • "archived": false,
      • "disabled": false,
      • "created_at": "2026-06-29T07:53:07.694711Z",
      • "updated_at": "2026-06-29T07:53:07.694711Z",
      • "user": null,
      • "ssh_key_data": null,
      • "password": null,
      • "passphrase": null
      },
    • "relationships": {
      • "templates": {
        },
      • "project": {
        }
      },
    • "links": {
      • "project": "/api/projects/opc",
      • "templates": "/api/projects/opc/templates?filter%5Bgit_remote_name_eq%5D=github",
      • "self": "/api/projects/opc/git_remotes/48669258-3ca6-4ad8-911e-13bcaaf8c2b4"
      },
    • "meta": null
    }
}
List Git remotes 
Lists all Git remotes for a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_cont]=origin
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "3d7b7a8a-1c54-4bc2-b72f-75781bc991c4",
      • "type": "git_remote",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": null
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show Git remote 
Shows a project Git remote.


Note: Git remote credentials are obfuscated for security reasons.


path Parameters
project_code
required
string
 
 Example:  opc
project code


remote_id
required
string
 
 Example:  49d51471-b041-4c10-ac88-0dc5b3fc2500
remote id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "67f40bfb-960f-440c-8b2b-0ffb84c611a0",
    • "type": "git_remote",
    • "attributes": {
      • "name": "github",
      • "url": "https://github.com/LimePoint/opschain-getting-started",
      • "archived": false,
      • "disabled": false,
      • "created_at": "2026-06-29T07:53:09.365121Z",
      • "updated_at": "2026-06-29T07:53:09.365121Z",
      • "user": "{{hidden}}",
      • "ssh_key_data": null,
      • "password": "{{hidden}}",
      • "passphrase": null
      },
    • "relationships": {
      • "templates": {
        },
      • "project": {
        }
      },
    • "links": {
      • "project": "/api/projects/opc",
      • "templates": "/api/projects/opc/templates?filter%5Bgit_remote_name_eq%5D=github",
      • "self": "/api/projects/opc/git_remotes/67f40bfb-960f-440c-8b2b-0ffb84c611a0"
      },
    • "meta": null
    }
}
Archive Git remote 
Archives/unarchives a project Git remote.


path Parameters
project_code
required
string
 
 Example:  opc
project code


id_to_archive
required
string
 
 Example:  49d51471-b041-4c10-ac88-0dc5b3fc2500
remote id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "archived": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "490eaf53-89f0-4ef1-9307-ee6c8d3946fd",
    • "type": "git_remote",
    • "attributes": {
      • "name": "github",
      • "url": "https://github.com/LimePoint/opschain-getting-started",
      • "archived": true,
      • "disabled": false,
      • "created_at": "2026-06-29T07:53:09.709275Z",
      • "updated_at": "2026-06-29T07:53:09.766933Z",
      • "user": "{{hidden}}",
      • "ssh_key_data": null,
      • "password": "{{hidden}}",
      • "passphrase": null
      },
    • "relationships": {
      • "templates": {
        },
      • "project": {
        }
      },
    • "links": {
      • "project": "/api/projects/opc",
      • "templates": "/api/projects/opc/templates?filter%5Bgit_remote_name_eq%5D=github",
      • "self": "/api/projects/opc/git_remotes/490eaf53-89f0-4ef1-9307-ee6c8d3946fd"
      },
    • "meta": null
    }
}
Update Git remote 
Update the URL and/or credentials of a project Git remote. The remote must be active (not archived), and OpsChain verifies the remote is reachable with the updated values before saving. The URL may only be edited to change its credentials, scheme, or port - the host and path cannot change (delete and recreate the remote to point at a different repository).


For HTTP(S) remotes provide the user and password credentials. For SSH remotes provide the ssh_key_data private key and, if the key is encrypted, its passphrase. Supplying password for an SSH remote (or passphrase for an HTTP(S) remote) is rejected. Changing a remote's protocol clears the existing credentials - supply the new protocol's credentials in the same request.


When meta.add_known_host is true and the request changes the URL to an SSH URL, OpsChain scans the new host with ssh-keyscan and stores the fetched host key in the global known_hosts setting before validating the connection. On success the response meta.known_hosts_added lists the registered host key lines. This requires superuser access (a non-superuser receives a 403). The scanned key is trusted on first use (TOFU); verify the reported host key out of band.


path Parameters
project_code
required
string
 
 Example:  opc
project code


id_to_update
required
string
 
 Example:  49d51471-b041-4c10-ac88-0dc5b3fc2500
remote id


Request Body schema: application/vnd.api+json
required
object
 
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {},
  • "meta": {
    • "add_known_host": false
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e40d472b-c67d-4715-8df4-df0f3cfab556",
    • "type": "git_remote",
    • "attributes": {
      • "name": "github",
      • "url": "https://github.com/LimePoint/opschain-getting-started",
      • "archived": false,
      • "disabled": false,
      • "created_at": "2026-06-29T07:53:10.330653Z",
      • "updated_at": "2026-06-29T07:53:10.363449Z",
      • "user": "{{hidden}}",
      • "ssh_key_data": null,
      • "password": "{{hidden}}",
      • "passphrase": null
      },
    • "relationships": {
      • "templates": {
        },
      • "project": {
        }
      },
    • "links": {
      • "project": "/api/projects/opc",
      • "templates": "/api/projects/opc/templates?filter%5Bgit_remote_name_eq%5D=github",
      • "self": "/api/projects/opc/git_remotes/e40d472b-c67d-4715-8df4-df0f3cfab556"
      },
    • "meta": null
    }
}
Delete Git remote 
Deletes a project Git remote if it has no changes, otherwise it removes the credentials.


path Parameters
project_code
required
string
 
 Example:  opc
project code


id_to_delete
required
string
 
 Example:  49d51471-b041-4c10-ac88-0dc5b3fc2500
remote id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "031b1302-9bd5-4c10-9755-cd02edd42b50",
    • "type": "git_remote",
    • "attributes": {
      • "name": "github",
      • "url": "https://github.com/LimePoint/opschain-getting-started",
      • "archived": true,
      • "disabled": false,
      • "created_at": "2026-06-29T07:53:11.122681Z",
      • "updated_at": "2026-06-29T07:53:11.280895Z",
      • "user": null,
      • "ssh_key_data": null,
      • "password": null,
      • "passphrase": null
      },
    • "relationships": {
      • "templates": {
        },
      • "project": {
        }
      },
    • "links": {
      • "project": "/api/projects/opc",
      • "templates": "/api/projects/opc/templates?filter%5Bgit_remote_name_eq%5D=github",
      • "self": "/api/projects/opc/git_remotes/031b1302-9bd5-4c10-9755-cd02edd42b50"
      },
    • "meta": {
      • "credentials_removed": true,
      • "messages": [
        ]
      }
    }
}
Bookmarks
Endpoints to interact with bookmarks.


Notes:


    

  • The list, create, show, update and delete bookmark endpoints are available via the
/<path/to/bookmark/owner>/bookmarks path. The example endpoints in this section reflect bookmarks owned
by a project asset.
    • 



Create bookmark 
Create a bookmark for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "b2657306-1c78-4ac7-aca8-843a003d44af",
    • "type": "bookmark",
    • "attributes": {
      • "url": "https://lowe-kunze.test/oren",
      • "description": "Perferendis sit ut maxime.",
      • "created_by": "logged_in_user",
      • "created_at": "2026-06-29T07:52:48.851146Z",
      • "updated_at": "2026-06-29T07:52:48.851146Z"
      },
    • "relationships": {
      • "parent": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/bookmarks/b2657306-1c78-4ac7-aca8-843a003d44af",
      • "parent": "/api/projects/opc/assets/prj_soa"
      }
    }
}
List bookmarks 
Lists all bookmarks for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[description_cont]=server
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "b600d715-d3f2-466f-b460-c3141dd84847",
      • "type": "bookmark",
      • "attributes": {},
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show bookmark 
Show a bookmark for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


bookmark_id
required
string
 
 Example:  700994f5-ed61-4234-b2c3-b3a433fc6e15
bookmark id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "89a34982-70d0-4876-8a14-5bbd591703df",
    • "type": "bookmark",
    • "attributes": {},
    • "relationships": {
      • "parent": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/bookmarks/89a34982-70d0-4876-8a14-5bbd591703df",
      • "parent": "/api/projects/opc/assets/prj_soa"
      }
    }
}
Update bookmark 
Update a bookmark for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


bookmark_id
required
string
 
 Example:  700994f5-ed61-4234-b2c3-b3a433fc6e15
bookmark id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "7bc5ff5d-f766-4e15-aa94-876073e24c76",
    • "type": "bookmark",
    • "attributes": {
      • "url": "https://updated.server.com:8080/new/path",
      • "description": "Updated server console path",
      • "created_by": "amos",
      • "created_at": "2026-06-29T07:52:50.464936Z",
      • "updated_at": "2026-06-29T07:52:50.505082Z"
      },
    • "relationships": {
      • "parent": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/bookmarks/7bc5ff5d-f766-4e15-aa94-876073e24c76",
      • "parent": "/api/projects/opc/assets/prj_soa"
      }
    }
}
Delete bookmark 
Delete a bookmark for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


bookmark_id
required
string
 
 Example:  700994f5-ed61-4234-b2c3-b3a433fc6e15
bookmark id


Responses
 Response samples 
Content type
text/plain
MintModels
Endpoints to query and generate MintModels for assets.


Notes:


    

  • The list, show and generate MintModel endpoints are available for all assets, via the
/<path/to/mintmodel/owner>/mintmodels path. The example endpoints in this section reflect MintModels owned
by a project asset.
    • 

  • The list and show endpoints will display all MintModels for the asset, regardless whether they were
applied successfully or not. Use the parent_mintmodel_history link in the API response to access the
asset's MintModel history.
    • 



List MintModel history 
Lists the asset's MintModel history.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[created_at_gteq]=2026-01-01
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "531d4a6b-9961-4bde-8205-bae19b036e6d",
      • "type": "mintmodel_history",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Show MintModel history 
Shows an asset's MintModel history record.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


id
required
string
 
 Example:  998ce234-9f32-41a7-afa1-c7ffd55674b0
MintModel history id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "6c26ffb9-dafe-43b7-af29-79958d5ac2cd",
    • "type": "mintmodel_history",
    • "attributes": {
      • "created_at": "2026-06-29T07:53:12.918670Z",
      • "updated_at": "2026-06-29T07:53:12.918670Z"
      },
    • "relationships": {
      • "parents": {
        },
      • "mintmodel": {
        },
      • "opschain_changes": {
        },
      • "template_version": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/mintmodel_history/6c26ffb9-dafe-43b7-af29-79958d5ac2cd"
      }
    },
  • "included": [
    • {
      • "id": "ceab3346-2dce-4e9e-89cc-7608fb252ba8",
      • "type": "mintmodel",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
List MintModels 
List all MintModels for an asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[created_at_gteq]=2026-01-01
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "067d4f89-da92-4c1c-8b96-ff858a4f98f1",
      • "type": "mintmodel",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Generate MintModel diff 
Generate a MintModel of the differences between two existing MintModels.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


old_mintmodel_id
required
string
 
 Example:  c20d6888-6468-4fbb-b934-420c2bb211ca
old MintModel id


new_mintmodel_id
required
string
 
 Example:  eacbca83-d5f8-4167-9eb8-3f95ae521c32
new MintModel id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "MintModelDiff",
    • "type": "diff_mintmodel",
    • "attributes": {
      • "diff_mintmodel": {
        },
      • "step_trees": [
        ]
      },
    • "links": {
      • "old_mintmodel": "/projects/opc/assets/prj_soa/mintmodels/04444ff2-57b7-4a77-8aaf-84c500dc97f2",
      • "new_mintmodel": "/projects/opc/assets/prj_soa/mintmodels/9c55fdf3-708b-4d07-ac1c-90535a895095",
      • "parent": "/projects/opc/assets/prj_soa"
      }
    }
}
Show MintModel 
Shows an asset MintModel.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


mintmodel_id
required
string
 
 Example:  79c61314-ab7c-4333-a420-8059407d764c
MintModel id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "1f887dd2-41c8-4810-8e5b-097ed82d2a09",
    • "type": "mintmodel",
    • "attributes": {
      • "data": {
        },
      • "sha256": "77526a9ef926aee8c98f90ec845f5bd12f58cd7afb29fb2db5ef8f95deec44f8",
      • "created_at": "2026-06-29T07:53:14.158993Z",
      • "updated_at": "2026-06-29T07:53:14.158993Z",
      • "render_logs": [
        ],
      • "phase_output": { }
      },
    • "relationships": {
      • "mintmodel_history": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/mintmodels/1f887dd2-41c8-4810-8e5b-097ed82d2a09",
      • "parent_mintmodel_history": "/api/projects/opc/assets/prj_soa/mintmodel_history"
      }
    }
}
Generate MintModel 
Generate the MintModel for this asset, using the latest properties and template version.


Note: The endpoint does not store the MintModel, rather it provides a point in time reference for the
MintModel content that will be used by a change if one is executed for the asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "18d7e9f8-31cd-48ad-890d-c83796a84b48",
    • "type": "mintmodel",
    • "attributes": {
      • "data": {
        },
      • "sha256": "77526a9ef926aee8c98f90ec845f5bd12f58cd7afb29fb2db5ef8f95deec44f8",
      • "created_at": "2026-06-29T07:53:14.796687Z",
      • "updated_at": "2026-06-29T07:53:14.796687Z",
      • "render_logs": [
        ],
      • "phase_output": { }
      },
    • "relationships": {
      • "mintmodel_history": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/assets/prj_soa/mintmodels/18d7e9f8-31cd-48ad-890d-c83796a84b48",
      • "parent_mintmodel_history": "/api/projects/opc/assets/prj_soa/mintmodel_history"
      }
    }
}
Workflows
Endpoints to interact with enterprise project workflows


List workflows 
Lists all workflows for a project.


path Parameters
project_code
required
string
 
 Example:  opc
project code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_cont]=deploy
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "a71c2a45-bca5-4689-8d5f-c38c1038e036",
      • "type": "workflow",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Create workflow 
Create a workflow


path Parameters
project_code
required
string
 
 Example:  opc
project code


Request Body schema: application/vnd.api+json
required
object
 
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "code": "hukxu",
      • "archived": false,
      • "name": "pthc4kxmym",
      • "description": "If we copy the driver, we can get to the HDD panel through the cross-platform HTTP port!",
      • "steps": [
        ],
      • "draft": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "3b09bb4e-9a99-4be0-b300-026e571a7ef9",
    • "type": "workflow",
    • "attributes": {
      • "code": "assets_new",
      • "name": "assets workflow_new",
      • "description": null,
      • "draft": false,
      • "archived": false,
      • "created_by": "logged_in_user",
      • "created_at": "2026-06-29T07:55:01.347868Z",
      • "updated_at": "2026-06-29T07:55:01.347868Z",
      • "source_yaml": "---\nsteps:\n- type: change\n  name: run asset action\n  target: \"/projects/opc/assets/prj_soa\"\n  action: run\n",
      • "steps": [
        ],
      • "resolved_steps": [ ],
      • "sample_properties": { },
      • "latest_version": 1,
      • "latest_published_version": 1
      },
    • "relationships": {
      • "parent": {
        },
      • "versions": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets_new",
      • "runs": "/api/projects/opc/workflows/assets_new/runs",
      • "versions": "/api/projects/opc/workflows/assets_new/versions",
      • "latest_version": "/api/projects/opc/workflows/assets_new/versions/1",
      • "latest_published_version": "/api/projects/opc/workflows/assets_new/versions/1"
      }
    }
}
Show workflow 
Shows a workflow.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "24de767e-68e2-4f86-b1d7-ff2419e2e693",
    • "type": "workflow",
    • "attributes": {
      • "code": "assets",
      • "name": "assets workflow",
      • "description": "workflow for assets",
      • "draft": false,
      • "archived": false,
      • "created_by": "shirl",
      • "created_at": "2026-06-29T07:55:02.538798Z",
      • "updated_at": "2026-06-29T07:55:02.538798Z",
      • "source_yaml": "---\nsteps:\n- type: change\n  name: run asset action\n  target: \"/projects/opc/assets/prj_soa\"\n  action: run\n",
      • "steps": [
        ],
      • "resolved_steps": [ ],
      • "sample_properties": {
        },
      • "latest_version": 2,
      • "latest_published_version": 2
      },
    • "relationships": {
      • "parent": {
        },
      • "versions": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets",
      • "runs": "/api/projects/opc/workflows/assets/runs",
      • "versions": "/api/projects/opc/workflows/assets/versions",
      • "latest_version": "/api/projects/opc/workflows/assets/versions/2",
      • "latest_published_version": "/api/projects/opc/workflows/assets/versions/2"
      }
    }
}
Update workflow 
Update a workflow.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "archived": false,
      • "name": "tlzvkceixa",
      • "description": "Use the digital PCI card, then you can navigate the open-source matrix!",
      • "steps": [
        ],
      • "draft": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "a09285e1-ee39-4ab6-93cb-58605adcb3e4",
    • "type": "workflow",
    • "attributes": {
      • "code": "assets",
      • "name": "new workflow name",
      • "description": "new description",
      • "draft": false,
      • "archived": false,
      • "created_by": "sara_mcglynn",
      • "created_at": "2026-06-29T07:55:03.311939Z",
      • "updated_at": "2026-06-29T07:55:03.378161Z",
      • "source_yaml": "---\nsteps:\n- type: change\n  name: run asset action\n  target: \"/projects/opc/assets/prj_soa\"\n  action: run\n",
      • "steps": [
        ],
      • "resolved_steps": [
        ],
      • "sample_properties": {
        },
      • "latest_version": 2,
      • "latest_published_version": 2
      },
    • "relationships": {
      • "parent": {
        },
      • "versions": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets",
      • "runs": "/api/projects/opc/workflows/assets/runs",
      • "versions": "/api/projects/opc/workflows/assets/versions",
      • "latest_version": "/api/projects/opc/workflows/assets/versions/2",
      • "latest_published_version": "/api/projects/opc/workflows/assets/versions/2"
      }
    }
}
Delete workflow 
Delete or archive a workflow.


    

  • If the workflow has not been run before, it will be deleted.
    • 

  • If the workflow has been run before, it will be archived.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


Responses
 Response samples 
Content type
text/plain
Workflow versions
List workflow versions 
Lists all versions for a workflow.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "f6511a35-bb6a-482c-a3a8-04f28649b6b0",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "8b4e7999-38a2-49d7-a68c-99f59838e9df",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Delete draft workflow versions 
Deletes all draft versions of a workflow.


Note: At least one version will remain. If all versions are drafts, the latest draft version will be kept.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "0d59e9a6-fa36-4484-899e-a133505cb100",
    • "type": "workflow",
    • "attributes": {
      • "code": "assets",
      • "name": "assets workflow",
      • "description": "workflow for assets",
      • "draft": false,
      • "archived": false,
      • "created_by": "katia.kulas",
      • "created_at": "2026-06-29T07:54:56.283161Z",
      • "updated_at": "2026-06-29T07:54:56.283161Z",
      • "source_yaml": "---\nsteps:\n- type: change\n  name: run asset action\n  target: \"/projects/opc/assets/prj_soa\"\n  action: run\n",
      • "steps": [
        ],
      • "resolved_steps": [ ],
      • "sample_properties": {
        },
      • "latest_version": 2,
      • "latest_published_version": 2
      },
    • "relationships": {
      • "parent": {
        },
      • "versions": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets",
      • "runs": "/api/projects/opc/workflows/assets/runs",
      • "versions": "/api/projects/opc/workflows/assets/versions",
      • "latest_version": "/api/projects/opc/workflows/assets/versions/2",
      • "latest_published_version": "/api/projects/opc/workflows/assets/versions/2"
      }
    }
}
Show workflow version 
Shows a workflow version.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


version
required
string
 
 Example:  2
version


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "5328aa5d-9cac-4a96-b897-11ff72ce2a73",
    • "type": "workflow_version",
    • "attributes": {
      • "code": "assets",
      • "name": "assets workflow",
      • "description": "workflow for assets",
      • "draft": false,
      • "archived": false,
      • "created_by": "sharmaine.pfannerstill",
      • "created_at": "2026-06-29T07:54:57.150111Z",
      • "updated_at": "2026-06-29T07:54:57.164412Z",
      • "source_yaml": "---\nsteps:\n- type: change\n  name: run asset action\n  target: \"/projects/opc/assets/prj_soa\"\n  action: run\n",
      • "steps": [
        ],
      • "resolved_steps": [ ],
      • "sample_properties": {
        },
      • "version": 2
      },
    • "relationships": {
      • "parent": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/versions/2",
      • "runs": "/api/projects/opc/workflows/assets/versions/2/runs",
      • "workflow": "/api/projects/opc/workflows/assets"
      }
    }
}
Update workflow 
Update a workflow version.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


version
required
string
 
 Example:  2
version


Request Body schema: application/vnd.api+json
required
object
 
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "code": "wiefz",
      • "node_id": "97e9fc0e-7ffd-496f-9ea1-2083f92844c4",
      • "archived": false,
      • "name": "gtximmyazb",
      • "description": "Compressing the program won't do anything, we need to synthesize the online http bus!",
      • "steps": [
        ],
      • "draft": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "3d1de421-616f-4721-9957-ae7860dddf8b",
    • "type": "workflow_version",
    • "attributes": {
      • "code": "assets",
      • "name": "new workflow name",
      • "description": "new description",
      • "draft": true,
      • "archived": false,
      • "created_by": "rina.haag",
      • "created_at": "2026-06-29T07:54:58.567159Z",
      • "updated_at": "2026-06-29T07:54:58.613797Z",
      • "source_yaml": "---\nsteps:\n- type: change\n  name: run asset action\n  target: \"/projects/opc/assets/prj_soa\"\n  action: run\n",
      • "steps": [
        ],
      • "resolved_steps": [ ],
      • "sample_properties": {
        },
      • "version": 2
      },
    • "relationships": {
      • "parent": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/versions/2",
      • "runs": "/api/projects/opc/workflows/assets/versions/2/runs",
      • "workflow": "/api/projects/opc/workflows/assets"
      }
    }
}
Delete workflow version 
Delete or archive a workflow version.


    

  • If the workflow version has not been run before, it will be deleted.
    • 

  • If the workflow version has been run before, it will be archived.
    • 



path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


version
required
string
 
 Example:  2
version


Responses
 Response samples 
Content type
text/plain
Properties
Endpoints to interact with properties.


Show properties 
Shows the current properties JSON and its version.


path Parameters
properties_id
required
string
 
 Example:  4acc59d6-a293-416f-a847-9c812cc0a2c0
properties id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "02e57f53-e38a-42a7-8e7d-1325da62cf00",
    • "type": "properties",
    • "attributes": {
      • "data": {
        },
      • "version": 1,
      • "created_at": "2026-06-29T07:53:38.050977Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/properties/02e57f53-e38a-42a7-8e7d-1325da62cf00",
      • "current_version": "/api/properties/02e57f53-e38a-42a7-8e7d-1325da62cf00/versions/1",
      • "versions": "/api/properties/02e57f53-e38a-42a7-8e7d-1325da62cf00/versions"
      }
    }
}
Update properties 
Updates a properties JSON if the included version matches the current properties version.


path Parameters
id_to_update
required
string
 
 Example:  4acc59d6-a293-416f-a847-9c812cc0a2c0
properties id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "data": {
        },
      • "version": 1
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "a8c6f4b6-fc7f-4ed4-839f-6cf7f290b322",
    • "type": "properties",
    • "attributes": {
      • "data": {
        },
      • "version": 2,
      • "created_at": "2026-06-29T07:53:38.266765Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/properties/a8c6f4b6-fc7f-4ed4-839f-6cf7f290b322",
      • "current_version": "/api/properties/a8c6f4b6-fc7f-4ed4-839f-6cf7f290b322/versions/2",
      • "versions": "/api/properties/a8c6f4b6-fc7f-4ed4-839f-6cf7f290b322/versions"
      }
    }
}
Update properties (unsafe) 
Updates a properties JSON, without any version checking (always updates).


path Parameters
id_to_set
required
string
 
 Example:  4acc59d6-a293-416f-a847-9c812cc0a2c0
properties id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "data": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "47e40e26-e144-48f4-9a19-d7f27a48f6e2",
    • "type": "properties",
    • "attributes": {
      • "data": {
        },
      • "version": 2,
      • "created_at": "2026-06-29T07:53:38.723069Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/properties/47e40e26-e144-48f4-9a19-d7f27a48f6e2",
      • "current_version": "/api/properties/47e40e26-e144-48f4-9a19-d7f27a48f6e2/versions/2",
      • "versions": "/api/properties/47e40e26-e144-48f4-9a19-d7f27a48f6e2/versions"
      }
    }
}
Update file property 
Update a file property in the properties.


path Parameters
properties_id
required
string
 
 Example:  4acc59d6-a293-416f-a847-9c812cc0a2c0
properties id


Request Body schema: multipart/form-data
file_path
string (Path to write the file within /opt/opschain) 
 
mode
string (Linux octal file mode) 
 
format
string (Valid values are 'raw' (default), 'json' or 'base64') 
 
replace_file
string (Replace the file property if it exists (default: false)) 
 
secret_path
string (Path to write the secret key into) 
 
secret_key
string
 
replace_secret
string (Replace the secret vault value if it exists (default: false)) 
 
file
string <binary> 
 
File to use. The filename is ignored.


Responses
 Request samples 
Content type
multipart/form-data
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="mode"

0600
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="file_path"

/opt/opschain/sample.txt
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="format"

raw
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="replace_file"

true
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="file"; filename="sample.txt"
content-type: text/plain
content-length: 21

Sample file property

------------XnJLe9ZIbbGUYtzPQJ16u1--

 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "992855fd-3ab9-467a-852a-43d9da8ec7c4",
    • "type": "properties",
    • "attributes": {
      • "data": {
        },
      • "version": 2,
      • "created_at": "2026-06-29T07:53:39.045609Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/properties/992855fd-3ab9-467a-852a-43d9da8ec7c4",
      • "current_version": "/api/properties/992855fd-3ab9-467a-852a-43d9da8ec7c4/versions/2",
      • "versions": "/api/properties/992855fd-3ab9-467a-852a-43d9da8ec7c4/versions"
      }
    }
}
Properties versions
Endpoints to interact with the version history for
properties.


List properties versions 
Lists all versions of an OpsChain properties.


path Parameters
properties_id
required
string
 
 Example:  4acc59d6-a293-416f-a847-9c812cc0a2c0
properties id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "ef4e3ec6-167e-4650-80dd-7e44a6718350",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Show properties version 
Shows the properties JSON for this properties version.


path Parameters
properties_id
required
string
 
 Example:  4acc59d6-a293-416f-a847-9c812cc0a2c0
properties id


version_number
required
integer
 
 Example:  1
version number


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4dd5fbb0-e43d-4be2-ab22-b1d6c9da8cf9",
    • "type": "properties_version",
    • "attributes": {
      • "data": {
        },
      • "version": 1,
      • "created_at": "2026-06-29T07:53:39.384489Z",
      • "owner_type": "Project"
      },
    • "relationships": {
      • "properties": {
        }
      },
    • "links": {
      • "versions": "/api/properties/e31b6e52-40b9-4e9c-8782-092cfa465769/versions",
      • "owner": "/api/projects/opc",
      • "self": "/api/properties/e31b6e52-40b9-4e9c-8782-092cfa465769/versions/1"
      },
    • "meta": { }
    }
}
Activities
Endpoints to interact with activities (changes and workflow runs combined).


List activities 
Lists all activities (changes and workflow runs) accessible to the user.


query Parameters
limit
integer
 
 Example:  limit=100
The maximum number of activities to return (defaults to 100, maximum 1000).


filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[created_by_cont]=opschain
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "f68b00c3-2e32-4a14-80c7-ae82726a96f2",
      • "type": "workflow_run",
      • "attributes": {
        },
      • "links": {
        }
      },
    • {
      • "id": "a8bb35c0-e4de-4c46-af7b-db6d4a6898c1",
      • "type": "change",
      • "attributes": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false,
    • "has_any": true,
    • "total_matching_filter": 2
    }
}
Changes
Endpoints to interact with changes.


List changes 
Lists all changes.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[environment_code_eq]=dev
download
string
 
 Example:  download=changes.csv
Download changes in CSV format with the specified file name. The changes will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


include
string
 
 Example:  include=steps,parents
Include the change steps and parents in the response


fields[<resource_type>]
string
 
 Example:  fields[<resource_type>]=code,status,action
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "0f7014d2-32c1-43ae-ac1f-9c4c84183bec",
      • "type": "change",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ],
  • "included": [
    • {
      • "id": "d705d97b-00cd-4987-8b81-52faa8d2ebd2",
      • "type": "step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "9c6dde3c-b4de-440e-80cf-ad67b32b72d7",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "3d0040c3-dbcc-42b3-96a6-0e3ec5986471",
      • "type": "environment",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false,
    • "has_any": true
    }
}
Create change 
Creates a change in a specific project, environment or asset.


Notes:


    

  1. When creating changes via a project, environment or asset changes path
(e.g. POST to /api/projects/{project_code}/changes) the parent_path request attributes must not be supplied
as the parent will be derived from the path.
    2. 

  2. When creating changes for assets (e.g. POST to /api/projects/{project_code}/assets/{asset_code}/changes)
the git_remote_name and git_rev attributes must not be supplied as the Git remote and revision will be
derived from the asset's template.
    3. 



Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "metadata": {
        },
      • "scheduled_activity_id": null,
      • "build_without_cache": false,
      • "pod_per_step": true,
      • "action_path": null,
      • "static_settings": { },
      • "state_timing_summary": { },
      • "notify": { },
      • "api_key_id": null,
      • "skip_steps": [ ],
      • "action": "index",
      • "parent_path": "/projects/opc/environments/dev/assets/env_soa",
      • "template_version": "2023_Q4_2"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "9030b19b-f96e-43db-8f1c-14ae3f87464d",
    • "type": "change",
    • "attributes": {
      • "created_by": "logged_in_user",
      • "name": null,
      • "action": "program",
      • "build_without_cache": false,
      • "initial_step_tree": { },
      • "metadata": {
        },
      • "scheduled": false,
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "cancelled_by": null,
      • "state_timing": {
        },
      • "state_timing_summary": { },
      • "notify": { },
      • "skip_steps": [ ],
      • "status_code": "initializing",
      • "mintmodel_change": false,
      • "created_at": "2026-06-29T07:52:52.959341Z",
      • "started_at": "2026-06-29T07:52:52.956881Z",
      • "finished_at": null,
      • "updated_at": "2026-06-29T07:52:52.969926Z",
      • "asset_name": null,
      • "environment_name": "Development",
      • "project_name": "OpsChain",
      • "git_remote_name": "github",
      • "git_rev": "main",
      • "commit_sha": null,
      • "requires_approval_from": null
      },
    • "relationships": {
      • "parents": {
        },
      • "root_step": {
        },
      • "steps": {
        },
      • "workflow_run": {
        },
      • "workflow": {
        },
      • "override_properties": {
        },
      • "override_settings": {
        }
      },
    • "links": {
      • "git_remote": "/api/projects/opc/git_remotes/81cafdb7-8a82-473f-acdb-de038c3ffe42",
      • "project": "/api/projects/opc",
      • "parent": "/api/projects/opc/environments/dev",
      • "self": "/api/projects/opc/environments/dev/changes/9030b19b-f96e-43db-8f1c-14ae3f87464d",
      • "log_lines": "/api/changes/9030b19b-f96e-43db-8f1c-14ae3f87464d/log_lines"
      },
    • "meta": { }
    },
  • "included": [
    • {
      • "id": "f8e9fbfb-871e-4f77-bf42-d648e63c1d87",
      • "type": "step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ]
}
Show change 
Shows a change, including it's parent nodes.


path Parameters
change_id
required
string
 
 Example:  ed4c881c-5d67-463f-8831-f4acb62721a8
change id


query Parameters
include
string
 
 Example:  include=steps,parents
Include the change steps and parents in the response


fields[<resource_type>]
string
 
 Example:  fields[<resource_type>]=code,status,action
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "fbb1015f-cafa-4164-9dcf-5179c12e5832",
    • "type": "change",
    • "attributes": {
      • "created_by": "yoko",
      • "name": "parse",
      • "action": "parse",
      • "build_without_cache": false,
      • "initial_step_tree": { },
      • "metadata": {
        },
      • "scheduled": false,
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "cancelled_by": null,
      • "state_timing": {
        },
      • "state_timing_summary": { },
      • "notify": { },
      • "skip_steps": [ ],
      • "status_code": "success",
      • "mintmodel_change": false,
      • "created_at": "2026-06-29T07:52:53.784270Z",
      • "started_at": "2026-06-29T07:47:46.480228Z",
      • "finished_at": "2026-06-29T07:48:15.321061Z",
      • "updated_at": "2026-06-29T07:52:53.801701Z",
      • "asset_name": null,
      • "environment_name": "Development",
      • "project_name": "OpsChain",
      • "git_remote_name": "github",
      • "git_rev": "main",
      • "commit_sha": "e59440c9720c177b4bf1d9e985a421d3fd65d0fc",
      • "requires_approval_from": null
      },
    • "relationships": {
      • "properties": {
        },
      • "parents": {
        },
      • "root_step": {
        },
      • "steps": {
        },
      • "workflow_run": {
        },
      • "workflow": {
        },
      • "override_properties": {
        },
      • "override_settings": {
        }
      },
    • "links": {
      • "git_remote": "/api/projects/opc/git_remotes/1d9b6f6c-a0b6-48a6-976d-cb2288a18ad9",
      • "project": "/api/projects/opc",
      • "parent": "/api/projects/opc/environments/dev",
      • "self": "/api/projects/opc/environments/dev/changes/fbb1015f-cafa-4164-9dcf-5179c12e5832",
      • "log_lines": "/api/changes/fbb1015f-cafa-4164-9dcf-5179c12e5832/log_lines"
      },
    • "meta": {
      • "wait_queue": [ ],
      • "blocking_queue": [ ]
      }
    },
  • "included": [
    • {
      • "id": "ae828b69-dae0-4946-b8ce-2c6b45ce2245",
      • "type": "step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "ae9b7462-24fc-4b30-b8d2-71ef3ab56b74",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "e5667ecb-86be-4ccd-b64b-3c6c82732ff1",
      • "type": "environment",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ]
}
Cancel change 
Cancels a change.


path Parameters
change_id
required
string
 
 Example:  ed4c881c-5d67-463f-8831-f4acb62721a8
change id


Responses
 Response samples 
Content type
text/plain
Show change settings 
Show the converged settings for a change, including any change-specific setting overrides merged on top of the asset's settings hierarchy.


The response includes a setting_sources meta object that attributes each setting value to its originating source.


path Parameters
change_id
required
string
 
 Example:  ed4c881c-5d67-463f-8831-f4acb62721a8
change id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "80d56a4a-3263-455b-af95-bf94944e2360",
    • "type": "converged_settings",
    • "attributes": {
      • "data": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev/converged_settings"
      },
    • "meta": {
      • "setting_sources": {
        }
      }
    }
}
Show change properties 
Converge the root step properties for a change.


The optional action_stage argument can be:


    

  • "pre" - to converge the properties as they were supplied to the root step action before it executed
    • 

  • "post" - to converge the properties as they were at the end of the latest completed step in the change
    • 



path Parameters
change_id
required
string
 
 Example:  ed4c881c-5d67-463f-8831-f4acb62721a8
change id


query Parameters
action_stage
string
 
 Example:  action_stage=pre
Converge the pre or post action properties


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "transmit (post)",
    • "type": "converged_properties",
    • "attributes": {
      • "data": {
        }
      },
    • "relationships": {
      • "repository_properties": {
        },
      • "properties": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev/converged_properties"
      },
    • "meta": {
      • "property_sources": {
        }
      }
    },
  • "included": [
    • {
      • "id": "6e8ffa56-7496-4c90-be17-0e0d25fad7a1",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "434ad5e5-80e3-4443-a96f-3a2167de683c",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "3434999b-3556-40f9-90d7-e502dc651501",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ]
}
Scheduled activities
List activities 
Lists all scheduled activities.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[project_code_eq]=opc
include
string
 
 Example:  include=parents
Include the scheduled change parents in the response


fields[<resource_type>]
string
 
 Example:  fields[<resource_type>]=code,status
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "ebec3d4c-33b8-44e0-85b2-3effb68c3516",
      • "type": "scheduled_change",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "cee0daf3-8591-47c1-9ede-7473b90c9816",
      • "type": "scheduled_workflow",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "included": [
    • {
      • "id": "e9cde789-3879-41c7-b9e7-6eb53b1456db",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "816be779-7799-4577-81c2-9d2b3a6a59f3",
      • "type": "environment",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "has_any": true
    }
}
Create activities 
Creates a scheduled activity in a specific project, environment or asset.


Notes:


    

  1. When creating scheduled activities via a project, environment or asset scheduled_activities path
(e.g. POST to /api/projects/{project_code}/scheduled_activities) the parent_path request attributes must not be supplied
as the parent will be derived from the path.
    

    2. 

  2. When creating scheduled activities for assets (e.g. POST to /api/projects/{project_code}/assets/{asset_code}/scheduled_activities)
the git_remote_name and git_rev attributes must not be supplied as the Git remote and revision will be
derived from the asset's template.
    

    3. 

  3. See the various payload examples to understand the required fields for each possible request to this endpoint.
    

    4. 



Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "git_rev": "master",
      • "action": "install_os",
      • "cron_schedule": "20 1 28 5 *",
      • "new_commits_only": true,
      • "repeat": true,
      • "metadata": {
        },
      • "run_at": null,
      • "run_count": 0,
      • "maximum_run_count": null,
      • "end_at": null,
      • "allow_parallel_execution": false,
      • "property_overrides": {
        },
      • "settings_overrides": {
        },
      • "notify": {
        },
      • "skip_steps": [ ],
      • "parent_path": "/projects/opc/environments/dev",
      • "git_remote_name": "github"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "3df2d601-2caf-4921-9739-08e42227aed3",
    • "type": "scheduled_change",
    • "attributes": {
      • "created_by": "logged_in_user",
      • "cron_schedule": "36 13 9 7 3",
      • "repeat": true,
      • "run_count": 0,
      • "maximum_run_count": null,
      • "enabled": true,
      • "allow_parallel_execution": false,
      • "metadata": {
        },
      • "property_overrides": {
        },
      • "notify": {
        },
      • "skip_steps": [ ],
      • "created_at": "2026-06-29T07:52:43.419668Z",
      • "updated_at": "2026-06-29T07:52:43.419668Z",
      • "next_run_at": "2026-07-01T03:36:00.000000Z",
      • "run_at": null,
      • "end_at": null,
      • "action": "different_action",
      • "new_commits_only": true,
      • "git_rev": "virtual",
      • "project_name": "OpsChain",
      • "project_code": "opc",
      • "settings_overrides": {
        },
      • "asset_code": null,
      • "asset_name": null,
      • "environment_code": "dev",
      • "environment_name": "Development",
      • "git_remote_name": "github"
      },
    • "relationships": {
      • "parents": {
        }
      },
    • "links": {
      • "git_remote": "/api/projects/opc/git_remotes/6fe7204e-47a9-435a-9ac1-14a4dca6a9a0",
      • "project": "/api/projects/opc",
      • "parent": "/api/projects/opc/environments/dev",
      • "self": "/api/scheduled_activities/3df2d601-2caf-4921-9739-08e42227aed3"
      }
    }
}
Show activity 
Shows a scheduled activity.


path Parameters
scheduled_change_id
required
string
 
 Example:  11fab180-bf41-46a7-a164-d6e973855cca
scheduled change id


query Parameters
include
string
 
 Example:  include=parents
Include the scheduled change parents in the response


fields[<resource_type>]
string
 
 Example:  fields[<resource_type>]=code,status
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "efae7f27-b266-48ea-86db-fece7c8f9df3",
    • "type": "scheduled_change",
    • "attributes": {
      • "created_by": "danette",
      • "cron_schedule": "16 13 7 9 3",
      • "repeat": true,
      • "run_count": 0,
      • "maximum_run_count": null,
      • "enabled": true,
      • "allow_parallel_execution": false,
      • "metadata": {
        },
      • "property_overrides": {
        },
      • "notify": {
        },
      • "skip_steps": [ ],
      • "created_at": "2026-06-29T07:52:44.106391Z",
      • "updated_at": "2026-06-29T07:52:44.106391Z",
      • "next_run_at": "2026-09-02T03:16:00.000000Z",
      • "run_at": null,
      • "end_at": null,
      • "action": "connect",
      • "new_commits_only": true,
      • "git_rev": "online",
      • "project_name": "OpsChain",
      • "project_code": "opc",
      • "settings_overrides": {
        },
      • "asset_code": null,
      • "asset_name": null,
      • "environment_code": "dev",
      • "environment_name": "Development",
      • "git_remote_name": "github"
      },
    • "relationships": {
      • "parents": {
        }
      },
    • "links": {
      • "git_remote": "/api/projects/opc/git_remotes/1d060f5a-6c29-4b3e-9219-f627615bfcfe",
      • "project": "/api/projects/opc",
      • "parent": "/api/projects/opc/environments/dev",
      • "self": "/api/scheduled_activities/efae7f27-b266-48ea-86db-fece7c8f9df3"
      }
    },
  • "included": [
    • {
      • "id": "5ad7f1f1-6adb-4a3d-8111-5255037c6d9a",
      • "type": "project",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      },
    • {
      • "id": "a0216a4b-ecca-4422-8804-82746986f2af",
      • "type": "environment",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": {
        }
      }
    ]
}
Update activity 
Updates a scheduled activity in a specific project, environment or asset.


Notes:


    

  1. When updating activities via a project, environment or asset scheduled_activities path
(e.g. POST to /api/projects/{project_code}/scheduled_activities) the parent_path request attributes must not be supplied
as the parent will be derived from the path.
    2. 

  2. When updating activities for assets (e.g. POST to /api/projects/{project_code}/assets/{asset_code}/scheduled_activities)
the git_remote_name and git_rev attributes must not be supplied as the Git remote and revision will be
derived from the asset's template.
    3. 

  3. See the various payload examples to understand the attributes you can supply to this endpoint.
    4. 

  4. The payload need only consist of the attributes you wish to modify. There is no need to supply the entire scheduled activity.
    5. 



path Parameters
scheduled_change_id
required
string
 
 Example:  11fab180-bf41-46a7-a164-d6e973855cca
scheduled change id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "git_rev": "master",
      • "action": "install_os",
      • "cron_schedule": "59 12 26 3 4",
      • "new_commits_only": true,
      • "repeat": true,
      • "metadata": {
        },
      • "run_at": null,
      • "run_count": 0,
      • "maximum_run_count": null,
      • "end_at": null,
      • "allow_parallel_execution": false,
      • "property_overrides": {
        },
      • "settings_overrides": {
        },
      • "notify": {
        },
      • "skip_steps": [ ],
      • "parent_path": "/projects/opc/environments/dev",
      • "git_remote_name": "github"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4a08a0bf-b5f4-43bf-a67d-b950d44c2382",
    • "type": "scheduled_change",
    • "attributes": {
      • "created_by": "edgardo_trantow",
      • "cron_schedule": "56 22 12 11 1",
      • "repeat": true,
      • "run_count": 0,
      • "maximum_run_count": 5,
      • "enabled": true,
      • "allow_parallel_execution": false,
      • "metadata": {
        },
      • "property_overrides": {
        },
      • "notify": {
        },
      • "skip_steps": [ ],
      • "created_at": "2026-06-29T07:52:45.256594Z",
      • "updated_at": "2026-06-29T07:52:45.937301Z",
      • "next_run_at": "2026-11-02T11:56:00.000000Z",
      • "run_at": null,
      • "end_at": null,
      • "action": "new_action",
      • "new_commits_only": false,
      • "git_rev": "wireless",
      • "project_name": "OpsChain",
      • "project_code": "opc",
      • "settings_overrides": {
        },
      • "asset_code": null,
      • "asset_name": null,
      • "environment_code": "dev",
      • "environment_name": "Development",
      • "git_remote_name": "github"
      },
    • "relationships": {
      • "parents": {
        }
      },
    • "links": {
      • "git_remote": "/api/projects/opc/git_remotes/335eb916-c77b-43fb-92fb-f6ef9bafe56e",
      • "project": "/api/projects/opc",
      • "parent": "/api/projects/opc/environments/dev",
      • "self": "/api/scheduled_activities/4a08a0bf-b5f4-43bf-a67d-b950d44c2382"
      }
    }
}
Delete activity 
Delete a scheduled activity.


path Parameters
scheduled_change_id
required
string
 
 Example:  11fab180-bf41-46a7-a164-d6e973855cca
scheduled change id


Responses
 Response samples 
Content type
text/plain
Steps
Endpoints to interact with change steps.


List steps 
Lists all steps.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[action_eq]=provision
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "4faaa076-58e2-47cd-866e-cc3b25d90667",
      • "type": "step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ]
}
Show step 
Shows a change step.


path Parameters
step_id
required
string
 
 Example:  1849304b-6953-487a-88ed-9630129c2e9e
step id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "0b5ece63-2923-445a-a3ae-1233cd1a0877",
    • "type": "step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": null,
      • "action": "reboot",
      • "change_id": "d8bc8301-5dd4-462e-8b49-0d342e26a5a2",
      • "child_execution_strategy": "sequential",
      • "full_path": "reboot",
      • "ignore_failure": false,
      • "input_arguments": [ ],
      • "state_timing": {
        },
      • "step_sequence": 1,
      • "step_type": "standard",
      • "description": null,
      • "name": "reboot",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:46:31.814821Z",
      • "started_at": "2026-06-29T07:47:31.814821Z",
      • "finished_at": "2026-06-29T07:52:27.156195Z",
      • "updated_at": "2026-06-29T07:53:43.336013Z",
      • "status_code": "success"
      },
    • "relationships": {
      • "properties": {
        },
      • "children": {
        },
      • "pre_properties_versions": {
        },
      • "post_properties_versions": {
        },
      • "change": {
        }
      },
    • "links": {
      • "parent": "/api/changes/d8bc8301-5dd4-462e-8b49-0d342e26a5a2",
      • "change": "/api/projects/opc/environments/dev/changes/d8bc8301-5dd4-462e-8b49-0d342e26a5a2",
      • "log_lines": "/api/steps/0b5ece63-2923-445a-a3ae-1233cd1a0877/log_lines",
      • "self": "/api/steps/0b5ece63-2923-445a-a3ae-1233cd1a0877"
      },
    • "meta": {
      • "property_sources": {
        }
      }
    },
  • "included": [
    • {
      • "id": "2e58bec2-77e1-4cf5-8cc2-c191860adb40",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "7c348e62-f924-44b0-be8d-e6507e98be89",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "ea22807e-ff38-48b1-acc5-e64ba8bd4681",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "9228c2f5-de5d-4fb1-b2cf-25b5100c327d",
      • "type": "properties",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Update step 
Update a step to flag it to be skipped on retry.


path Parameters
step_id
required
string
 
 Example:  1849304b-6953-487a-88ed-9630129c2e9e
step id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "skip_on_retry": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c116efd1-5d34-4ad7-8027-954474a2f6ea",
    • "type": "step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": null,
      • "action": "parse",
      • "change_id": "a42fd1c4-f85a-4f47-842b-860116ee5691",
      • "child_execution_strategy": "sequential",
      • "full_path": "parse",
      • "ignore_failure": false,
      • "input_arguments": [ ],
      • "state_timing": {
        },
      • "step_sequence": 1,
      • "step_type": "standard",
      • "description": null,
      • "name": "parse",
      • "skip_requested": true,
      • "skip_on_retry": true,
      • "created_at": "2026-06-29T07:44:41.255276Z",
      • "started_at": "2026-06-29T07:45:41.255276Z",
      • "finished_at": "2026-06-29T07:49:36.719776Z",
      • "updated_at": "2026-06-29T07:53:43.867089Z",
      • "status_code": "error"
      },
    • "relationships": {
      • "properties": {
        },
      • "children": {
        },
      • "pre_properties_versions": {
        },
      • "post_properties_versions": {
        },
      • "change": {
        }
      },
    • "links": {
      • "parent": "/api/changes/a42fd1c4-f85a-4f47-842b-860116ee5691",
      • "change": "/api/projects/opc/environments/dev/changes/a42fd1c4-f85a-4f47-842b-860116ee5691",
      • "log_lines": "/api/steps/c116efd1-5d34-4ad7-8027-954474a2f6ea/log_lines",
      • "self": "/api/steps/c116efd1-5d34-4ad7-8027-954474a2f6ea"
      },
    • "meta": { }
    }
}
Continue step 
Continues a "waiting" change step.


path Parameters
step_id
required
string
 
 Example:  0b7a3b1f-5a1f-4af6-b9a7-4a131a440a37
step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Manually removed from load balancer."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "dcad86d0-8fb9-497f-bbef-4abb62ae2ee3",
    • "type": "step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": null,
      • "action": "opschain_wait_step_2",
      • "change_id": "571cc996-26ee-455e-8672-79dbce1a18ab",
      • "child_execution_strategy": "sequential",
      • "full_path": "opschain_wait_step_2",
      • "ignore_failure": false,
      • "input_arguments": [ ],
      • "state_timing": {
        },
      • "step_sequence": 1,
      • "step_type": "wait_step",
      • "description": null,
      • "name": "opschain_wait_step_2",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:46:50.137926Z",
      • "started_at": "2026-06-29T07:47:50.137926Z",
      • "finished_at": "2026-06-29T07:53:45.738493Z",
      • "updated_at": "2026-06-29T07:53:45.768916Z",
      • "status_code": "success"
      },
    • "relationships": {
      • "properties": {
        },
      • "children": {
        },
      • "pre_properties_versions": {
        },
      • "post_properties_versions": {
        },
      • "change": {
        }
      },
    • "links": {
      • "parent": "/api/changes/571cc996-26ee-455e-8672-79dbce1a18ab",
      • "change": "/api/projects/opc/environments/dev/changes/571cc996-26ee-455e-8672-79dbce1a18ab",
      • "log_lines": "/api/steps/dcad86d0-8fb9-497f-bbef-4abb62ae2ee3/log_lines",
      • "self": "/api/steps/dcad86d0-8fb9-497f-bbef-4abb62ae2ee3"
      },
    • "meta": { }
    }
}
Approve step 
Approves a change step that needs approval.


path Parameters
step_id
required
string
 
 Example:  0b7a3b1f-5a1f-4af6-b9a7-4a131a440a37
step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "As per CR 7 👍"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "0093f47d-47e0-4829-a7d0-3152dfe5c53e",
    • "type": "step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": [
        ],
      • "action": "opschain_wait_step_4",
      • "change_id": "af542975-8ab2-4fd6-b0c9-eafa61b5a94c",
      • "child_execution_strategy": "sequential",
      • "full_path": "opschain_wait_step_4",
      • "ignore_failure": false,
      • "input_arguments": [ ],
      • "state_timing": {
        },
      • "step_sequence": 1,
      • "step_type": "wait_step",
      • "description": null,
      • "name": "opschain_wait_step_4",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:46:30.359839Z",
      • "started_at": "2026-06-29T07:47:30.359839Z",
      • "finished_at": null,
      • "updated_at": "2026-06-29T07:53:46.559903Z",
      • "status_code": "queued"
      },
    • "relationships": {
      • "properties": {
        },
      • "children": {
        },
      • "pre_properties_versions": {
        },
      • "post_properties_versions": {
        },
      • "change": {
        }
      },
    • "links": {
      • "parent": "/api/changes/af542975-8ab2-4fd6-b0c9-eafa61b5a94c",
      • "change": "/api/projects/opc/environments/dev/changes/af542975-8ab2-4fd6-b0c9-eafa61b5a94c",
      • "log_lines": "/api/steps/0093f47d-47e0-4829-a7d0-3152dfe5c53e/log_lines",
      • "self": "/api/steps/0093f47d-47e0-4829-a7d0-3152dfe5c53e"
      },
    • "meta": { }
    }
}
Reject step 
Rejects a change step that needs approval.


path Parameters
step_id
required
string
 
 Example:  0b7a3b1f-5a1f-4af6-b9a7-4a131a440a37
step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Failed user acceptance testing"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e4b05c0a-94f0-4d36-866d-5f2ff12cc2de",
    • "type": "step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": [
        ],
      • "action": "opschain_wait_step_7",
      • "change_id": "c85767b8-e1d6-49a9-8c88-eae441de65c4",
      • "child_execution_strategy": "sequential",
      • "full_path": "opschain_wait_step_7",
      • "ignore_failure": false,
      • "input_arguments": [ ],
      • "state_timing": {
        },
      • "step_sequence": 1,
      • "step_type": "wait_step",
      • "description": null,
      • "name": "opschain_wait_step_7",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:47:13.090103Z",
      • "started_at": "2026-06-29T07:48:13.090103Z",
      • "finished_at": "2026-06-29T07:53:47.590669Z",
      • "updated_at": "2026-06-29T07:53:47.600931Z",
      • "status_code": "aborted"
      },
    • "relationships": {
      • "properties": {
        },
      • "children": {
        },
      • "pre_properties_versions": {
        },
      • "post_properties_versions": {
        },
      • "change": {
        }
      },
    • "links": {
      • "parent": "/api/changes/c85767b8-e1d6-49a9-8c88-eae441de65c4",
      • "change": "/api/projects/opc/environments/dev/changes/c85767b8-e1d6-49a9-8c88-eae441de65c4",
      • "log_lines": "/api/steps/e4b05c0a-94f0-4d36-866d-5f2ff12cc2de/log_lines",
      • "self": "/api/steps/e4b05c0a-94f0-4d36-866d-5f2ff12cc2de"
      },
    • "meta": { }
    }
}
Show step settings 
Show the converged settings for the change containing this step, including any change-specific setting overrides.


The response includes a setting_sources meta object that attributes each setting value to its originating source.


path Parameters
step_id
required
string
 
 Example:  1849304b-6953-487a-88ed-9630129c2e9e
step id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4ede2372-ae1a-4cf5-98b4-e6e0ab86efc2",
    • "type": "converged_settings",
    • "attributes": {
      • "data": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev/converged_settings"
      },
    • "meta": {
      • "setting_sources": {
        }
      }
    }
}
Show step properties 
Converge the properties for a step.


The optional action_stage argument can be:


    

  • "pre" - to converge the properties as they were supplied to the step action before it executed
    • 

  • "post" - to converge the properties as they were after the step action was complete (does not take into account any changes made by the step's children)
    • 



path Parameters
step_id
required
string
 
 Example:  1849304b-6953-487a-88ed-9630129c2e9e
step id


query Parameters
action_stage
string
 
 Example:  action_stage=pre
Converge the pre or post action properties


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "copy (post)",
    • "type": "converged_properties",
    • "attributes": {
      • "data": {
        }
      },
    • "relationships": {
      • "repository_properties": {
        },
      • "properties": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/environments/dev/converged_properties"
      },
    • "meta": {
      • "property_sources": {
        }
      }
    },
  • "included": [
    • {
      • "id": "82d8e2b1-d9be-44ef-9f51-4fe5f44911dd",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "09ce8cfc-27af-41c8-9c27-7f9a8e9c044a",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      },
    • {
      • "id": "61b51342-379e-47eb-9b71-05b45fbbb812",
      • "type": "properties_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ]
}
Log lines
Endpoints to query log lines for changes and individual change steps.


List change log lines 
List the log lines for a change.


path Parameters
change_id
required
string
 
 Example:  ed4c881c-5d67-463f-8831-f4acb62721a8
query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
download
string
 
 Example:  download=change.log
Download the log lines wth the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "6238aaca-5bef-49d8-9f17-18fa2528afa4",
      • "type": "log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
List step log lines 
List the log lines for a change step.


path Parameters
step_id
required
string
 
 Example:  1849304b-6953-487a-88ed-9630129c2e9e
query Parameters
include_child_steps
boolean
 
 Example:  include_child_steps=true
Whether to include logs for steps that are children of this step


filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
download
string
 
 Example:  download=step.log
Download the log lines wth the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "c856f179-0039-4f0f-9e63-ca962cdf873f",
      • "type": "log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
List filtered log lines 
List filtered log lines.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
limit
integer  [ 1 .. null ] 
 Default:  10000
 
 Example:  limit=50
Limit the number of log lines returned


download
string
 
 Example:  download=opschain.log
Download the filtered log lines wth the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "7c49666c-d25d-4e61-bbde-e4e0e7022395",
      • "type": "log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
List workflow run log lines 
List the workflow run log lines for a workflow run.


path Parameters
workflow_run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
download
string
 
 Example:  download=workflow_run.log
Download the log lines wth the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "f20635a9-e4cb-4450-8218-1f5c929c278a",
      • "type": "log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
List workflow step log lines 
List the log lines for a workflow step.


path Parameters
workflow_step_id
required
string
 
 Example:  cc1524a7-f7bb-489b-a794-55d27964ed30
query Parameters
include_child_steps
boolean
 
 Example:  include_child_steps=true
Whether to include logs for steps that are children of this step


filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
download
string
 
 Example:  download=workflow_step.log
Download the log lines wth the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "9a0e639b-4deb-44df-907e-eeb66cac9727",
      • "type": "log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
List filtered workflow run log lines 
List filtered workflow run log lines.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[message_cont]=dolorem
limit
integer  [ 1 .. null ] 
 Default:  10000
 
 Example:  limit=50
Limit the number of workflow run log lines returned


download
string
 
 Example:  download=opschain.log
Download the filtered log lines wth the specified file name. The logs will be ordered from oldest to newest when this parameter is specified, irrespective of the sort order requested.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "cadff1e1-e211-41b0-b8ac-4d69c22c5e00",
      • "type": "log_line",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Workflow runs
Endpoints to interact with workflow runs


Notes:


    

  • The list and show endpoints are available via the following paths:
      

    1. /workflow_runs - will return all workflow runs accessible to the user.
      2. 

    2. /project/{project_code}/workflow_runs - will return all workflow runs for all this project's workflows.
      3. 

    3. /project/{project_code}/workflows/{workflow_code}/workflow_runs - will return all workflow runs this workflow.
      4. 

    4. /<path/to/asset>/workflow_runs - will return all workflow runs that include a change for this asset.
      5. 

    

    • 



List all workflow runs 
Lists all workflow runs.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[created_by_cont]=opschain
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "d5c1f9d4-6e92-4cff-baf2-dd4af1276dc5",
      • "type": "workflow_run",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ],
  • "included": [
    • {
      • "id": "b969994f-f1e8-4c3c-bdfc-c30e215117e6",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Run a workflow 
Runs a pre-defined workflow


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "project_code": "opc",
      • "workflow_code": "assets",
      • "version": 2,
      • "property_overrides": {
        },
      • "metadata": {
        },
      • "notify": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "8699048f-a7c9-4ea4-bec0-5d1cbcde1d5d",
    • "type": "workflow_run",
    • "attributes": {
      • "step_tree": {
        },
      • "scheduled": false,
      • "metadata": { },
      • "created_by": "logged_in_user",
      • "cancelled_by": null,
      • "skip_steps": [ ],
      • "status_code": "pending",
      • "created_at": "2026-06-29T07:54:01.670732Z",
      • "started_at": null,
      • "finished_at": null,
      • "updated_at": "2026-06-29T07:54:01.689345Z",
      • "project_name": "OpsChain",
      • "workflow_code": "assets"
      },
    • "relationships": {
      • "workflow_version": {
        },
      • "workflow": {
        },
      • "parent_workflow_step": {
        },
      • "root_step": {
        },
      • "steps": {
        },
      • "override_properties": {
        }
      },
    • "links": {
      • "parent": "/api/projects/opc",
      • "self": "/api/projects/opc/workflows/assets/runs/8699048f-a7c9-4ea4-bec0-5d1cbcde1d5d",
      • "log_lines": "/api/workflow_runs/8699048f-a7c9-4ea4-bec0-5d1cbcde1d5d/log_lines"
      },
    • "meta": { }
    },
  • "included": [
    • {
      • "id": "548dd3df-5662-43a7-9253-5530b7696d0c",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "93ddd165-7bd4-4e89-b36f-a564260facd0",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "3a4d73cf-f952-44f9-9f9c-e5a487cc3cd7",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Show workflow run 
Shows a workflow run.


path Parameters
run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "5f04ce79-880e-4c3d-9397-5281f92d9e91",
    • "type": "workflow_run",
    • "attributes": {
      • "step_tree": {
        },
      • "scheduled": false,
      • "metadata": {
        },
      • "created_by": "huey",
      • "cancelled_by": null,
      • "skip_steps": [ ],
      • "status_code": "success",
      • "created_at": "2026-06-29T07:54:03.670386Z",
      • "started_at": "2026-06-29T07:44:50.772961Z",
      • "finished_at": "2026-06-29T07:46:05.755788Z",
      • "updated_at": "2026-06-29T07:54:03.679735Z",
      • "project_name": "OpsChain",
      • "workflow_code": "assets"
      },
    • "relationships": {
      • "workflow_version": {
        },
      • "workflow": {
        },
      • "parent_workflow_step": {
        },
      • "root_step": {
        },
      • "steps": {
        },
      • "override_properties": {
        }
      },
    • "links": {
      • "parent": "/api/projects/opc",
      • "self": "/api/projects/opc/workflows/assets/runs/5f04ce79-880e-4c3d-9397-5281f92d9e91",
      • "log_lines": "/api/workflow_runs/5f04ce79-880e-4c3d-9397-5281f92d9e91/log_lines"
      },
    • "meta": {
      • "wait_queue": [ ],
      • "blocking_queue": [ ]
      }
    },
  • "included": [
    • {
      • "id": "9403c75f-bf96-48d6-894d-93d99f9dda6b",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "38d7600d-3172-43fd-bc8d-1b4c621f64b9",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "ba34a817-c27a-446a-bd30-55ea227c652a",
      • "type": "workflow_wait_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "81635b47-5bf9-411f-8e13-cd1535cea033",
      • "type": "workflow_workflow_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "7df5553f-11e4-43af-a951-c8ebf90cfef0",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "7a43ce1c-1382-4152-96bc-6f7f396ba9e1",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "00b5391b-d4e2-4706-8616-899a81bd371a",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Cancel workflow run 
Cancels a workflow run.


path Parameters
run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


Responses
 Response samples 
Content type
text/plain
List workflow runs (workflow specific) 
Lists all runs for a workflow.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[created_by_cont]=opschain
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "3a219047-deda-47f3-8252-aac702de14e2",
      • "type": "workflow_run",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        },
      • "meta": { }
      }
    ],
  • "included": [
    • {
      • "id": "7d3c89c3-f07d-40cb-9d07-a11d76ecdc3a",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Run a workflow (workflow specific) 
Runs a pre-defined workflow


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "version": 2,
      • "property_overrides": {
        },
      • "metadata": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "231ae198-2ad5-4206-9a46-130acff91c20",
    • "type": "workflow_run",
    • "attributes": {
      • "step_tree": {
        },
      • "scheduled": false,
      • "metadata": { },
      • "created_by": "logged_in_user",
      • "cancelled_by": null,
      • "skip_steps": [ ],
      • "status_code": "pending",
      • "created_at": "2026-06-29T07:54:10.590622Z",
      • "started_at": null,
      • "finished_at": null,
      • "updated_at": "2026-06-29T07:54:10.607731Z",
      • "project_name": "OpsChain",
      • "workflow_code": "assets"
      },
    • "relationships": {
      • "workflow_version": {
        },
      • "workflow": {
        },
      • "parent_workflow_step": {
        },
      • "root_step": {
        },
      • "steps": {
        },
      • "override_properties": {
        }
      },
    • "links": {
      • "parent": "/api/projects/opc",
      • "self": "/api/projects/opc/workflows/assets/runs/231ae198-2ad5-4206-9a46-130acff91c20",
      • "log_lines": "/api/workflow_runs/231ae198-2ad5-4206-9a46-130acff91c20/log_lines"
      },
    • "meta": { }
    },
  • "included": [
    • {
      • "id": "6535d2cc-8a3b-4866-8f0e-35a838d4a8b7",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "ee271530-6582-4e77-891d-a8236bad353a",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "61fef55a-99ff-4750-9040-a6e94f34d6cd",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Show workflow run (workflow specific) 
Shows a workflow run.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e6e984da-0076-4420-8081-7dd657a551f6",
    • "type": "workflow_run",
    • "attributes": {
      • "step_tree": {
        },
      • "scheduled": false,
      • "metadata": {
        },
      • "created_by": "denita.blick",
      • "cancelled_by": null,
      • "skip_steps": [ ],
      • "status_code": "success",
      • "created_at": "2026-06-29T07:54:13.660930Z",
      • "started_at": "2026-06-29T07:46:58.439238Z",
      • "finished_at": "2026-06-29T07:47:51.900187Z",
      • "updated_at": "2026-06-29T07:54:13.672226Z",
      • "project_name": "OpsChain",
      • "workflow_code": "assets"
      },
    • "relationships": {
      • "workflow_version": {
        },
      • "workflow": {
        },
      • "parent_workflow_step": {
        },
      • "root_step": {
        },
      • "steps": {
        },
      • "override_properties": {
        }
      },
    • "links": {
      • "parent": "/api/projects/opc",
      • "self": "/api/projects/opc/workflows/assets/runs/e6e984da-0076-4420-8081-7dd657a551f6",
      • "log_lines": "/api/workflow_runs/e6e984da-0076-4420-8081-7dd657a551f6/log_lines"
      },
    • "meta": {
      • "wait_queue": [ ],
      • "blocking_queue": [ ]
      }
    },
  • "included": [
    • {
      • "id": "2327d33c-e75d-49f7-96a5-6997c7183b1f",
      • "type": "workflow_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "0ed57e9c-b6b1-4ed6-9769-513d3de1f253",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "94b1af9a-e808-4a18-9ab3-26b0a48a01a3",
      • "type": "workflow_wait_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "2292a772-6b4e-4924-9404-69fb4fd33d34",
      • "type": "workflow_workflow_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "09eb5406-ed8b-4186-a7a3-6312fd92dbca",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "dac231eb-8824-41a2-b203-144e3c963d16",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "09b67dac-67bc-4927-b22b-303e850ea1ec",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Cancel workflow run (workflow specific) 
Cancels a workflow run.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


Responses
 Response samples 
Content type
text/plain
Workflow steps
Endpoints to interact with the steps in a workflow run


List all workflow steps 
Lists all workflow steps.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[status_code_eq]=running
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "6593c7df-af3f-427b-bb63-0a684157dcf7",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "05859e0f-31b8-40de-916f-946e78f7c28d",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "9970605e-962b-4058-97ce-98cd89b16425",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "e467285e-2ea3-4ada-8e61-267366b61a89",
      • "type": "workflow_wait_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "ae127aff-dcf4-4560-993a-eebc96c3405e",
      • "type": "workflow_workflow_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "52a9f6a7-3f5d-48d2-ad77-4b6fd5c3bea0",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "410167fe-bc17-424a-9c34-90f721f1c803",
      • "type": "workflow_wait_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "f4f48162-5f4e-4d79-bef5-7107ebf0e5d1",
      • "type": "workflow_workflow_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "ec0c2bf2-1637-48e1-b8ab-df5ce78b4b0f",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Show a workflow step 
Shows a workflow step.


path Parameters
step_id
required
string
 
 Example:  f18cfc6e-ff6a-481d-9735-f989419e651f
workflow step id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e214e813-5352-47df-8fbb-e78d58f18f0d",
    • "type": "workflow_noop_step",
    • "attributes": {
      • "lock_version": 1,
      • "created_by": "mohammed.ankunding",
      • "name": "molestiae",
      • "step_sequence": 1,
      • "status_code": "success",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:54:19.837639Z",
      • "started_at": "2026-06-29T07:47:24.575832Z",
      • "finished_at": "2026-06-29T07:52:25.331529Z",
      • "updated_at": "2026-06-29T07:54:19.842452Z",
      • "child_execution_strategy": "sequential"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/3c762f29-e169-4393-8e01-9b36d6da2294/steps/e214e813-5352-47df-8fbb-e78d58f18f0d",
      • "log_lines": "/api/workflow_steps/e214e813-5352-47df-8fbb-e78d58f18f0d/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/3c762f29-e169-4393-8e01-9b36d6da2294",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/3c762f29-e169-4393-8e01-9b36d6da2294"
      }
    }
}
Update a workflow step 
Update a workflow step to flag it to be skipped on retry.


path Parameters
step_id
required
string
 
 Example:  f18cfc6e-ff6a-481d-9735-f989419e651f
workflow step id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "skip_on_retry": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "58109564-fdb0-473f-9704-4029a359a1cb",
    • "type": "workflow_change_step",
    • "attributes": {
      • "lock_version": 2,
      • "created_by": "rayford",
      • "name": "transmit",
      • "step_sequence": 5,
      • "status_code": "error",
      • "skip_requested": true,
      • "skip_on_retry": true,
      • "created_at": "2026-06-29T07:54:22.941887Z",
      • "started_at": "2026-06-29T07:54:22.986239Z",
      • "finished_at": "2026-06-29T07:55:22.986244Z",
      • "updated_at": "2026-06-29T07:54:22.987297Z",
      • "action": "transmit",
      • "property_overrides": {
        }
      },
    • "relationships": {
      • "change": {
        },
      • "change_parent": {
        },
      • "action_template_version": {
        },
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/e8d2a956-0545-44e1-85be-60f3c700285a/steps/58109564-fdb0-473f-9704-4029a359a1cb",
      • "log_lines": "/api/workflow_steps/58109564-fdb0-473f-9704-4029a359a1cb/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/e8d2a956-0545-44e1-85be-60f3c700285a/steps/85f24384-f416-465e-8fce-37e0c415a827",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/e8d2a956-0545-44e1-85be-60f3c700285a"
      }
    }
}
Continue workflow step 
Continues a "waiting" workflow step. To approve/reject a workflow step that needs approval see the
approve workflow step API endpoint.


path Parameters
step_id
required
string
 
 Example:  c24ec840-f03e-4473-a14e-2208a5c93f77
workflow step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Done sanity checks. Ok to continue."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "25181584-9de2-4e98-848f-77a1885840e8",
    • "type": "workflow_wait_step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [
        ],
      • "requires_approval_from": null,
      • "lock_version": 3,
      • "created_by": "dorsey",
      • "name": "Wait",
      • "step_sequence": 8,
      • "status_code": "continued",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:43:32.788180Z",
      • "started_at": "2026-06-29T07:44:32.788180Z",
      • "finished_at": "2026-06-29T07:54:25.981279Z",
      • "updated_at": "2026-06-29T07:54:26.011281Z"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/ed5736b7-b8a4-4fce-aeb5-1e274536b148/steps/25181584-9de2-4e98-848f-77a1885840e8",
      • "log_lines": "/api/workflow_steps/25181584-9de2-4e98-848f-77a1885840e8/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/ed5736b7-b8a4-4fce-aeb5-1e274536b148/steps/ea6e83bf-c69f-4c77-92ab-494b2d2ffa8f",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/ed5736b7-b8a4-4fce-aeb5-1e274536b148"
      }
    }
}
Approve workflow step 
Approve a workflow step that requires approval. To continue a workflow step that does need approval see the
continue workflow step API endpoint


path Parameters
step_id
required
string
 
 Example:  ebf59e6b-763a-4cc6-8bfd-8e96366df20c
workflow step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Ok to proceed."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "76023fa2-d602-4e18-be5a-ba37a1ad0a26",
    • "type": "workflow_wait_step",
    • "attributes": {
      • "approved_by": [
        ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": {
        },
      • "lock_version": 3,
      • "created_by": "suzann_leannon",
      • "name": "Approval",
      • "step_sequence": 8,
      • "status_code": "approved",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:47:07.682568Z",
      • "started_at": "2026-06-29T07:48:07.682568Z",
      • "finished_at": "2026-06-29T07:54:29.265530Z",
      • "updated_at": "2026-06-29T07:54:29.347633Z"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/9adc6871-2173-44d5-8074-d3e576327dc7/steps/76023fa2-d602-4e18-be5a-ba37a1ad0a26",
      • "log_lines": "/api/workflow_steps/76023fa2-d602-4e18-be5a-ba37a1ad0a26/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/9adc6871-2173-44d5-8074-d3e576327dc7/steps/dd7bac54-b7d8-44e5-9218-edca748d9f70",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/9adc6871-2173-44d5-8074-d3e576327dc7"
      }
    }
}
Reject workflow step 
Reject a workflow step that requires approval.


path Parameters
step_id
required
string
 
 Example:  e4e44480-d9ba-4e83-a47d-5383d5ada4e5
workflow step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Ok to proceed."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "a5083fd9-7a29-4b04-a36a-663dfd4736b4",
    • "type": "workflow_wait_step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [
        ],
      • "continued_by": [ ],
      • "requires_approval_from": {
        },
      • "lock_version": 3,
      • "created_by": "lawanda.howe",
      • "name": "Approval",
      • "step_sequence": 8,
      • "status_code": "rejected",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:48:18.720576Z",
      • "started_at": "2026-06-29T07:49:18.720576Z",
      • "finished_at": "2026-06-29T07:54:33.453782Z",
      • "updated_at": "2026-06-29T07:54:33.461984Z"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/deec6b68-b1a3-4c66-aa3d-9065b49b2193/steps/a5083fd9-7a29-4b04-a36a-663dfd4736b4",
      • "log_lines": "/api/workflow_steps/a5083fd9-7a29-4b04-a36a-663dfd4736b4/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/deec6b68-b1a3-4c66-aa3d-9065b49b2193/steps/52f9f63d-1111-4157-8ad3-c2b730ad575b",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/deec6b68-b1a3-4c66-aa3d-9065b49b2193"
      }
    }
}
List workflow steps (run specific) 
Lists all steps in a workflow run.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "bbe08054-950d-4ba0-854c-8a8d2ea9e1ab",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "f156cecb-2481-43ea-8829-3202eef5d161",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "35c5c19f-64b8-41c6-9dc9-d882c42bda6e",
      • "type": "workflow_noop_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "b2635fac-4376-429f-97b0-1532b718ecc7",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "70e42c00-1a07-4be1-9d35-7aba4003b332",
      • "type": "workflow_wait_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "184baa8b-9924-46a8-96b2-08d512df6964",
      • "type": "workflow_workflow_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "344614bc-fe29-454b-8163-607a92c4ab21",
      • "type": "workflow_change_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "c0e9ad4f-4be1-421a-85cd-b810ea6b5085",
      • "type": "workflow_wait_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "718343bf-fb38-4531-b51f-ebba2548a140",
      • "type": "workflow_workflow_step",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Show workflow step (run specific) 
Shows a step of a workflow run.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


step_id
required
string
 
 Example:  f18cfc6e-ff6a-481d-9735-f989419e651f
workflow step id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "6705ca8d-7c59-4eae-a7de-0dc6fb6bf702",
    • "type": "workflow_noop_step",
    • "attributes": {
      • "lock_version": 1,
      • "created_by": "quinton",
      • "name": "officia",
      • "step_sequence": 1,
      • "status_code": "success",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:54:39.719080Z",
      • "started_at": "2026-06-29T07:48:20.053404Z",
      • "finished_at": "2026-06-29T07:53:01.828137Z",
      • "updated_at": "2026-06-29T07:54:39.725468Z",
      • "child_execution_strategy": "sequential"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/172c8a07-7524-4d08-b3c1-1e147d9ef3ef/steps/6705ca8d-7c59-4eae-a7de-0dc6fb6bf702",
      • "log_lines": "/api/workflow_steps/6705ca8d-7c59-4eae-a7de-0dc6fb6bf702/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/172c8a07-7524-4d08-b3c1-1e147d9ef3ef",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/172c8a07-7524-4d08-b3c1-1e147d9ef3ef"
      }
    }
}
Continue workflow step (run specific) 
Continues a "waiting" workflow step. To approve/reject a workflow step that needs approval see the
approve workflow step API endpoint.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


step_id
required
string
 
 Example:  c24ec840-f03e-4473-a14e-2208a5c93f77
workflow step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Done sanity checks. Ok to continue."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "2e001b60-e7f2-4424-9d52-4f52582ec962",
    • "type": "workflow_wait_step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [ ],
      • "continued_by": [
        ],
      • "requires_approval_from": null,
      • "lock_version": 3,
      • "created_by": "trish_boehm",
      • "name": "Wait",
      • "step_sequence": 8,
      • "status_code": "continued",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:47:05.704451Z",
      • "started_at": "2026-06-29T07:48:05.704451Z",
      • "finished_at": "2026-06-29T07:54:43.441461Z",
      • "updated_at": "2026-06-29T07:54:43.465358Z"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/58795c0d-fd28-439c-b424-f5db36210e19/steps/2e001b60-e7f2-4424-9d52-4f52582ec962",
      • "log_lines": "/api/workflow_steps/2e001b60-e7f2-4424-9d52-4f52582ec962/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/58795c0d-fd28-439c-b424-f5db36210e19/steps/da015206-9724-4da1-a604-43f4cdb92fcb",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/58795c0d-fd28-439c-b424-f5db36210e19"
      }
    }
}
Approve workflow step (run specific) 
Approve a workflow step that requires approval. To continue a workflow step that does need approval see the
continue workflow step API endpoint


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


step_id
required
string
 
 Example:  ebf59e6b-763a-4cc6-8bfd-8e96366df20c
workflow step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Ok to proceed."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "edaee97a-743f-4882-99b6-610a3abcfa00",
    • "type": "workflow_wait_step",
    • "attributes": {
      • "approved_by": [
        ],
      • "rejected_by": [ ],
      • "continued_by": [ ],
      • "requires_approval_from": {
        },
      • "lock_version": 3,
      • "created_by": "elton",
      • "name": "Approval",
      • "step_sequence": 8,
      • "status_code": "approved",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:48:11.457689Z",
      • "started_at": "2026-06-29T07:49:11.457689Z",
      • "finished_at": "2026-06-29T07:54:46.589259Z",
      • "updated_at": "2026-06-29T07:54:46.616581Z"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/7edf1ee6-bbe8-4239-bbe0-055c0e7b4698/steps/edaee97a-743f-4882-99b6-610a3abcfa00",
      • "log_lines": "/api/workflow_steps/edaee97a-743f-4882-99b6-610a3abcfa00/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/7edf1ee6-bbe8-4239-bbe0-055c0e7b4698/steps/934273f2-77c1-4557-a320-ca93b81576d9",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/7edf1ee6-bbe8-4239-bbe0-055c0e7b4698"
      }
    }
}
Reject workflow step (run specific) 
Reject a workflow step that requires approval.


path Parameters
project_code
required
string
 
 Example:  opc
project code


workflow_code
required
string
 
 Example:  assets
workflow code


run_id
required
string
 
 Example:  6cc73d95-8f70-4920-9a43-604caecee6b9
workflow run id


step_id
required
string
 
 Example:  e4e44480-d9ba-4e83-a47d-5383d5ada4e5
workflow step id


Request Body schema: application/vnd.api+json
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "message": "Ok to proceed."
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c983f584-3c30-402b-b6d9-fb461e1ef7fb",
    • "type": "workflow_wait_step",
    • "attributes": {
      • "approved_by": [ ],
      • "rejected_by": [
        ],
      • "continued_by": [ ],
      • "requires_approval_from": {
        },
      • "lock_version": 3,
      • "created_by": "hyman.lemke",
      • "name": "Approval",
      • "step_sequence": 8,
      • "status_code": "rejected",
      • "skip_requested": false,
      • "skip_on_retry": false,
      • "created_at": "2026-06-29T07:45:51.179710Z",
      • "started_at": "2026-06-29T07:46:51.179710Z",
      • "finished_at": "2026-06-29T07:54:50.807069Z",
      • "updated_at": "2026-06-29T07:54:50.815136Z"
      },
    • "relationships": {
      • "workflow_run": {
        },
      • "children": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/workflows/assets/runs/1be78263-f465-4dd4-b246-de029fe37373/steps/c983f584-3c30-402b-b6d9-fb461e1ef7fb",
      • "log_lines": "/api/workflow_steps/c983f584-3c30-402b-b6d9-fb461e1ef7fb/log_lines",
      • "parent": "/api/projects/opc/workflows/assets/runs/1be78263-f465-4dd4-b246-de029fe37373/steps/ebfac607-7ff0-432b-aab0-fae0315358f4",
      • "workflow_run": "/api/projects/opc/workflows/assets/runs/1be78263-f465-4dd4-b246-de029fe37373"
      }
    }
}
Events
Endpoints to interact with events.


List events 
Lists all events.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[query_param_code_eq]=opc
limit
integer  [ 1 .. 1000 ] 
 Default:  10
 
 Example:  limit=50
Limit the number of events returned


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "13f0ba1a-ea75-4235-b95b-586212eebcf5",
      • "type": "event",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Create event 
Creates an event.


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "type": "custom event",
      • "any_key": "with a value",
      • "another_key": "with a different value",
      • "nested": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "05e6347a-fcc5-4a9a-adf9-8d7465999afe",
    • "type": "event",
    • "attributes": {
      • "some": "event data",
      • "username": "logged_in_user",
      • "system": false,
      • "type": "my event",
      • "event_node_path": null,
      • "created_at": "2026-06-29T07:53:06.700991Z"
      },
    • "relationships": {
      • "source": {
        }
      },
    • "links": {
      • "self": "/api/events/05e6347a-fcc5-4a9a-adf9-8d7465999afe"
      }
    }
}
Show event 
Shows an event.


path Parameters
event_id
required
string
 
 Example:  a2e3949a-3e3b-4d7b-984e-e8193ee7f84a
event id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "12a4d820-3e50-447d-97b1-38572ce3c8ff",
    • "type": "event",
    • "attributes": {
      • "nested": {
        },
      • "any_key": "with a value",
      • "another_key": "with a different value",
      • "username": "cathy_farrell",
      • "system": false,
      • "type": "my custom event",
      • "event_node_path": "/projects/opc",
      • "created_at": "2026-06-29T07:53:07.157730Z"
      },
    • "relationships": {
      • "source": {
        }
      },
    • "links": {
      • "self": "/api/events/12a4d820-3e50-447d-97b1-38572ce3c8ff"
      }
    }
}
Event filters
List event filters 
Lists all event filters.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[code_eq]=changes_success
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "7664d03c-3a86-432b-96c3-ac794dc5c01e",
      • "type": "event_filter",
      • "attributes": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create event filter 
Create an event filter.


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "code": "change_success",
      • "description": "Filter for successful changes in dev",
      • "rules": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e3103cb4-3198-4bf7-9f22-557b45e169ed",
    • "type": "event_filter",
    • "attributes": {
      • "rules": {
        },
      • "code": "4miu1",
      • "description": "Consectetur reprehenderit sequi nihil.",
      • "created_by": "logged_in_user",
      • "created_at": "2026-06-29T07:53:01.289888Z",
      • "updated_at": "2026-06-29T07:53:01.289888Z"
      },
    • "links": {
      • "self": "/api/event_filters/4miu1",
      • "subscribers": "/api/event_filters/4miu1/event_subscribers"
      }
    }
}
Show event filter 
Show an event filter.


path Parameters
event_filter_code
required
string
 
 Example:  change_success
event filter code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "86273cfe-3509-4c6f-9e2c-d05bc4c72cca",
    • "type": "event_filter",
    • "attributes": {
      • "rules": {
        },
      • "code": "change_success",
      • "description": "Filter for successful changes in dev",
      • "created_by": "#<User:0x00007fabc37ba8d8>",
      • "created_at": "2026-06-29T07:53:01.787350Z",
      • "updated_at": "2026-06-29T07:53:01.787350Z"
      },
    • "links": {
      • "self": "/api/event_filters/change_success",
      • "subscribers": "/api/event_filters/change_success/event_subscribers"
      }
    }
}
Update event filter 
Update an event filter.


path Parameters
event_filter_code
required
string
 
 Example:  change_success
event filter code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "rules": {
        },
      • "description": "hello world errors filter"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "9ecc06ff-d3f2-4c90-a475-cb78e2216301",
    • "type": "event_filter",
    • "attributes": {
      • "rules": {
        },
      • "code": "change_success",
      • "description": "hello world errors filter",
      • "created_by": "#<User:0x00007fabc37d43a0>",
      • "created_at": "2026-06-29T07:53:02.133122Z",
      • "updated_at": "2026-06-29T07:53:02.149693Z"
      },
    • "links": {
      • "self": "/api/event_filters/change_success",
      • "subscribers": "/api/event_filters/change_success/event_subscribers"
      }
    }
}
Delete event filter 
Delete an event filter.


path Parameters
event_filter_code
required
string
 
 Example:  change_success
event filter code


Responses
 Response samples 
Content type
text/plain
Event subscribers
List event subscribers 
Lists all event subscribers.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[enabled_eq]=true
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "f11f1697-1290-4597-80d5-e76ff868de64",
      • "type": "event_subscriber",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
List event node subscribers 
List event subscribers for a specific project, environment or asset.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[enabled_eq]=true
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "8be45bde-f025-4d06-a0c7-9db13ceb77b0",
      • "type": "event_subscriber",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create event subscriber 
Create an event subscriber.


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "event_filter_code": "change_success",
      • "channel_parent_path": "/system_configuration",
      • "channel_code": "system_email",
      • "channel_kwargs": {
        },
      • "enabled": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c6d2cc7a-0412-4151-a578-6d44f7a5c38b",
    • "type": "event_subscriber",
    • "attributes": {
      • "channel_kwargs": {
        },
      • "enabled": true,
      • "created_by": "#<User:0x00007fabc3179898>",
      • "created_at": "2026-06-29T07:53:03.786504Z",
      • "updated_at": "2026-06-29T07:53:03.786504Z"
      },
    • "relationships": {
      • "event_filter": {
        },
      • "notification_channel": {
        }
      },
    • "links": {
      • "self": "/api/event_subscribers/c6d2cc7a-0412-4151-a578-6d44f7a5c38b"
      }
    }
}
Show event subscriber 
Show an event subscriber.


path Parameters
event_subscriber_id
required
string
 
 Example:  9bda5771-e56e-4291-8143-7131cf009c24
event subscriber id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "72eec34f-4a91-4890-97cd-54384f54ee88",
    • "type": "event_subscriber",
    • "attributes": {
      • "channel_kwargs": { },
      • "enabled": true,
      • "created_by": "damion.wintheiser",
      • "created_at": "2026-06-29T07:53:04.646113Z",
      • "updated_at": "2026-06-29T07:53:04.646113Z"
      },
    • "relationships": {
      • "event_filter": {
        },
      • "notification_channel": {
        }
      },
    • "links": {
      • "self": "/api/event_subscribers/72eec34f-4a91-4890-97cd-54384f54ee88"
      }
    }
}
Update event subscriber 
Update an event subscriber.


path Parameters
event_subscriber_id
required
string
 
 Example:  9bda5771-e56e-4291-8143-7131cf009c24
event subscriber id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "event_filter_code": "change_success",
      • "channel_parent_path": "/projects/opc",
      • "channel_code": "project_direct",
      • "channel_kwargs": {
        },
      • "enabled": false
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "9e51d195-7286-4890-ba2b-621ef914ce9b",
    • "type": "event_subscriber",
    • "attributes": {
      • "channel_kwargs": {
        },
      • "enabled": false,
      • "created_by": "noelle_lindgren",
      • "created_at": "2026-06-29T07:53:05.280746Z",
      • "updated_at": "2026-06-29T07:53:05.329230Z"
      },
    • "relationships": {
      • "event_filter": {
        },
      • "notification_channel": {
        }
      },
    • "links": {
      • "self": "/api/event_subscribers/9e51d195-7286-4890-ba2b-621ef914ce9b"
      }
    }
}
Delete event subscriber 
Delete an event subscriber.


path Parameters
event_subscriber_id
required
string
 
 Example:  9bda5771-e56e-4291-8143-7131cf009c24
event subscriber id


Responses
 Response samples 
Content type
text/plain
Global notification channels
List notification channels 
Lists all global notification channels.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[code_eq]=slack
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "1b51209f-6ced-4bcb-a874-340217469e80",
      • "type": "notification_channel",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show notification channel 
Show a global notification channel.


path Parameters
notification_channel_code
required
string
 
 Example:  system_email
notification channel code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "2a234bdc-8b1b-408b-bc0a-4930cabaf2f2",
    • "type": "notification_channel",
    • "attributes": {
      • "format": "html",
      • "code": "system_email",
      • "description": "System channel for email notifications",
      • "default_channel": true,
      • "internal": false,
      • "enabled": true,
      • "kwargs": {
        },
      • "created_by": "anjanette.oconnell",
      • "created_at": "2026-06-29T07:53:29.717644Z",
      • "updated_at": "2026-06-29T07:53:29.717644Z",
      • "job_code": "email_job"
      },
    • "relationships": {
      • "notification_job": {
        }
      },
    • "links": {
      • "self": "/api/system_configuration/notification_channels/system_email",
      • "parent": "/api/system_configuration"
      }
    }
}
Update notification channel 
Update a global notification channel.


path Parameters
notification_channel_code
required
string
 
 Example:  system_email
notification channel code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "notification_job_code": "direct_job",
      • "format": "slack",
      • "default_channel": false,
      • "enabled": false,
      • "kwargs": {},
      • "description": "New channel description"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "aef6be35-b6c6-468d-931e-7e715c72df74",
    • "type": "notification_channel",
    • "attributes": {
      • "format": "slack",
      • "code": "system_email",
      • "description": "New channel description",
      • "default_channel": false,
      • "internal": false,
      • "enabled": false,
      • "kwargs": {},
      • "created_by": "edgar",
      • "created_at": "2026-06-29T07:53:29.992206Z",
      • "updated_at": "2026-06-29T07:53:30.011587Z",
      • "job_code": "direct_job"
      },
    • "relationships": {
      • "notification_job": {
        }
      },
    • "links": {
      • "self": "/api/system_configuration/notification_channels/system_email",
      • "parent": "/api/system_configuration"
      }
    }
}
Delete notification channel 
Delete a global notification channel.


path Parameters
notification_channel_code
required
string
 
 Example:  system_email
notification channel code


Responses
 Response samples 
Content type
text/plain
Notification channels
List notification channels 
List notification channels for a specific project, environment or asset.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[code_eq]=slack
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "2eb8f542-13d4-4c4d-bef7-e945ffa31593",
      • "type": "notification_channel",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show a notification channel 
Show a notification channel for a specific project, environment or asset..


path Parameters
notification_channel_code
required
string
 
 Example:  system_email
notification channel code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "fd762de9-b60e-4eec-81b9-d95bde0ccfe6",
    • "type": "notification_channel",
    • "attributes": {
      • "format": "slack",
      • "code": "project_direct",
      • "description": "Project specific channel for slack notifications",
      • "default_channel": true,
      • "internal": false,
      • "enabled": true,
      • "kwargs": {
        },
      • "created_by": "rhett",
      • "created_at": "2026-06-29T07:53:30.722092Z",
      • "updated_at": "2026-06-29T07:53:30.722092Z",
      • "job_code": "direct_job"
      },
    • "relationships": {
      • "notification_job": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/notification_channels/project_direct",
      • "parent": "/api/projects/opc"
      }
    }
}
Update notification channel 
Update a notification channel for a specific project, environment or asset.


path Parameters
notification_channel_code
required
string
 
 Example:  system_email
notification channel code


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "notification_job_code": "direct_job",
      • "format": "slack",
      • "default_channel": false,
      • "enabled": false,
      • "kwargs": {},
      • "description": "New channel description"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "96b57dc7-d640-4ef3-8f73-7198107a1909",
    • "type": "notification_channel",
    • "attributes": {
      • "format": "slack",
      • "code": "project_direct",
      • "description": "New channel description",
      • "default_channel": false,
      • "internal": false,
      • "enabled": false,
      • "kwargs": {},
      • "created_by": "leighann.lindgren",
      • "created_at": "2026-06-29T07:53:30.968018Z",
      • "updated_at": "2026-06-29T07:53:30.990658Z",
      • "job_code": "direct_job"
      },
    • "relationships": {
      • "notification_job": {
        }
      },
    • "links": {
      • "self": "/api/projects/opc/notification_channels/project_direct",
      • "parent": "/api/projects/opc"
      }
    }
}
Delete notification channel 
Delete a notification channel for a specific project, environment or asset..


path Parameters
notification_channel_code
required
string
 
 Example:  system_email
notification channel code


Responses
 Response samples 
Content type
text/plain
Notification jobs
List notification jobs 
Lists all notification jobs.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[code_eq]=notify_targets
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "d8a516b3-e694-4631-932d-7d7203097ae2",
      • "type": "notification_job",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show notification job 
Show a notification job.


path Parameters
notification_job_code
required
string
 
 Example:  email_job
notification job code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "8ca1adce-3754-4e40-a327-9b2dae32594f",
    • "type": "notification_job",
    • "attributes": {
      • "job_class": "Notifications::SendEmailJob",
      • "target_type": "smtp",
      • "valid_formats": [
        ],
      • "code": "email_job",
      • "description": "Send an email to the target user(s)",
      • "created_at": "2026-06-29T07:53:31.747997Z",
      • "updated_at": "2026-06-29T07:53:31.747997Z",
      • "all_kwargs": [
        ]
      },
    • "relationships": {
      • "notification_channels": {
        }
      },
    • "links": {
      • "self": "/api/notification_jobs/email_job"
      }
    }
}
Jobs
Endpoint to fetch information about the jobs processed by the OpsChain.


Get information about the jobs that are being processed by the OpsChain 
Returns information about the jobs that are being processed by the OpsChain.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[status_eq]=finished
limit
integer  [ 1 .. 1000 ] 
 Default:  100
 
 Example:  limit=50
Limit the number of jobs returned


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "578284",
      • "type": "job",
      • "attributes": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false,
    • "has_any": true,
    • "total_matching_filter": 1
    }
}
Settings
Endpoints to interact with settings.


Show settings 
Shows the current settings.


path Parameters
settings_id
required
string
 
 Example:  17c98828-c426-4c0a-802a-62450bb3ec11
settings id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "bd0c9cdd-d4bc-4f44-82bf-a41911f20840",
    • "type": "settings",
    • "attributes": {
      • "data": {
        },
      • "version": 1,
      • "created_at": "2026-06-29T07:53:39.814730Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/settings/bd0c9cdd-d4bc-4f44-82bf-a41911f20840",
      • "current_version": "/api/settings/bd0c9cdd-d4bc-4f44-82bf-a41911f20840/versions/1",
      • "versions": "/api/settings/bd0c9cdd-d4bc-4f44-82bf-a41911f20840/versions"
      }
    }
}
Update settings 
Updates a settings JSON if the included version matches the current settings version.


path Parameters
id_to_update
required
string
 
 Example:  17c98828-c426-4c0a-802a-62450bb3ec11
settings id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "data": {
        },
      • "version": 1
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "bd712d8e-72ee-405b-8e8b-c5c6f9e2be80",
    • "type": "settings",
    • "attributes": {
      • "data": {
        },
      • "version": 1,
      • "created_at": "2026-06-29T07:53:40.035221Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/settings/bd712d8e-72ee-405b-8e8b-c5c6f9e2be80",
      • "current_version": "/api/settings/bd712d8e-72ee-405b-8e8b-c5c6f9e2be80/versions/1",
      • "versions": "/api/settings/bd712d8e-72ee-405b-8e8b-c5c6f9e2be80/versions"
      }
    }
}
Update settings (unsafe) 
Updates a settings JSON, without any version checking (always updates).


path Parameters
id_to_set
required
string
 
 Example:  17c98828-c426-4c0a-802a-62450bb3ec11
settings id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "data": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c0ae7c83-8bbd-4897-93db-e3d0d6575a7d",
    • "type": "settings",
    • "attributes": {
      • "data": {
        },
      • "version": 1,
      • "created_at": "2026-06-29T07:53:40.526445Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/settings/c0ae7c83-8bbd-4897-93db-e3d0d6575a7d",
      • "current_version": "/api/settings/c0ae7c83-8bbd-4897-93db-e3d0d6575a7d/versions/1",
      • "versions": "/api/settings/c0ae7c83-8bbd-4897-93db-e3d0d6575a7d/versions"
      }
    }
}
Settings versions
Endpoints to interact with the version history for
settings.


List settings versions 
Lists all versions of an OpsChain settings.


path Parameters
settings_id
required
string
 
 Example:  17c98828-c426-4c0a-802a-62450bb3ec11
settings id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "5b655ff7-ecb8-4673-aec5-22855735f469",
      • "type": "settings_version",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "partial_response": false
    }
}
Show settings version 
Shows the settings values for this settings version.


path Parameters
settings_id
required
string
 
 Example:  17c98828-c426-4c0a-802a-62450bb3ec11
settings id


version_number
required
integer
 
 Example:  1
version number


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "5a1b0fb6-b0f6-4cde-99ce-cd02a6d77d59",
    • "type": "settings_version",
    • "attributes": {
      • "data": {
        },
      • "version": 1,
      • "created_at": "2026-06-29T07:53:41.084074Z"
      },
    • "relationships": {
      • "settings": {
        }
      },
    • "links": {
      • "versions": "/api/settings/65ab3b14-20d7-4c07-a123-f9c5172cc7fb/versions",
      • "owner": "/api/projects/opc",
      • "self": "/api/settings/65ab3b14-20d7-4c07-a123-f9c5172cc7fb/versions/1"
      }
    }
}
Authorisation rules
Endpoints to interact with authorisation rules.


List rules 
Lists all authorisation rules.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name]=rule_name
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "69ed5da6-a408-424e-ae97-d691a42a9b83",
      • "type": "authorisation_rule",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "b9e069f4-dda0-4f6e-a645-ab264a6fbf95",
      • "type": "authorisation_rule",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "6e62790e-34e2-48e1-90cb-d8a26f2adb8b",
      • "type": "authorisation_rule",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create rule 
Create an authorisation rule.


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "path": "^/projects/opc/environments/dev",
      • "readable": false,
      • "updatable": false,
      • "deletable": false,
      • "executable": false,
      • "name": "Deny access to Development"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "1c364788-0e66-4e7b-b163-8cb54350cb23",
    • "type": "authorisation_rule",
    • "attributes": {
      • "name": "navigate",
      • "path": "^/projects/rrocb/environments/srtov",
      • "readable": false,
      • "updatable": false,
      • "deletable": false,
      • "executable": false,
      • "created_by": "logged_in_user",
      • "created_at": "2026-06-29T07:52:39.241598Z",
      • "updated_at": "2026-06-29T07:52:39.241598Z"
      },
    • "relationships": {
      • "authorisation_policies": {
        }
      },
    • "links": {
      • "self": "/api/authorisation_rules/1c364788-0e66-4e7b-b163-8cb54350cb23"
      }
    }
}
Show rule 
Shows an authorisation rule.


path Parameters
authorisation_rule_id
required
string
 
 Example:  ecb1de9c-5c6a-47a7-973d-01c27520b370
authorisation rule id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "f2ad93ab-5394-4092-91c8-258ed5d4a209",
    • "type": "authorisation_rule",
    • "attributes": {
      • "name": "Deny access to Development",
      • "path": "^/projects/opc/environments/dev",
      • "readable": false,
      • "updatable": false,
      • "deletable": false,
      • "executable": false,
      • "created_by": "opschain",
      • "created_at": "2026-06-29T07:52:39.832492Z",
      • "updated_at": "2026-06-29T07:52:39.832492Z"
      },
    • "relationships": {
      • "authorisation_policies": {
        }
      },
    • "links": {
      • "self": "/api/authorisation_rules/f2ad93ab-5394-4092-91c8-258ed5d4a209"
      }
    }
}
Update authorisation rule 
Update an authorisation rule.


path Parameters
authorisation_rule_id
required
string
 
 Example:  ecb1de9c-5c6a-47a7-973d-01c27520b370
authorisation rule id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "path": "/projects/demo/environments/dev",
      • "readable": false,
      • "updatable": false,
      • "deletable": false,
      • "executable": false,
      • "name": "Deny all on dev environment"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "4876ca76-a77a-47f7-a0a5-4f22ef573d29",
    • "type": "authorisation_rule",
    • "attributes": {
      • "name": "Deny all on dev environment",
      • "path": "^/projects/demo/environments/dev",
      • "readable": false,
      • "updatable": false,
      • "deletable": false,
      • "executable": false,
      • "created_by": "logged_in_user",
      • "created_at": "2026-06-29T07:52:40.578614Z",
      • "updated_at": "2026-06-29T07:52:40.660740Z"
      },
    • "relationships": {
      • "authorisation_policies": {
        }
      },
    • "links": {
      • "self": "/api/authorisation_rules/4876ca76-a77a-47f7-a0a5-4f22ef573d29"
      }
    }
}
Delete rule 
Delete an authorisation rule.


path Parameters
authorisation_rule_id
required
string
 
 Example:  ecb1de9c-5c6a-47a7-973d-01c27520b370
authorisation rule id


Responses
 Response samples 
Content type
text/plain
Authorisation policies
Endpoints to interact with authorisation policies.


List policies 
Lists all authorisation policies.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_eq]=secure
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "b45278e9-2a74-49a3-a126-7445ddf1c92d",
      • "type": "authorisation_policy",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "e447dc08-a8c3-4303-b969-559aa13cab82",
      • "type": "authorisation_policy",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create policy 
Create an authorisation policy with a list of authorisation rules.


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "name": "marhta_stanton",
      • "description": "Reprehenderit animi aut et.",
      • "authorisation_rules": [
        ]
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "08410233-0da2-4baf-b466-fa6162aa19d3",
    • "type": "authorisation_policy",
    • "attributes": {
      • "name": "marcelene.doyle",
      • "description": "Inventore et ut neque.",
      • "system": false,
      • "created_by": "logged_in_user",
      • "created_at": "2026-06-29T07:52:35.131674Z",
      • "updated_at": "2026-06-29T07:52:35.131674Z"
      },
    • "relationships": {
      • "policy_rules": {
        },
      • "policy_assignments": {
        },
      • "authorisation_rules": {
        }
      },
    • "links": {
      • "self": "/api/authorisation_policies/08410233-0da2-4baf-b466-fa6162aa19d3",
      • "policy_rules": "/api/authorisation_policies/08410233-0da2-4baf-b466-fa6162aa19d3/rules",
      • "policy_assignments": "/api/authorisation_policies/08410233-0da2-4baf-b466-fa6162aa19d3/assignments"
      }
    }
}
Show policy 
Shows an authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "82d560ee-1f73-418d-afc8-0c90ee67a640",
    • "type": "authorisation_policy",
    • "attributes": {
      • "name": "New users policy",
      • "description": "Access for all incoming users",
      • "system": false,
      • "created_by": "nettie_rippin",
      • "created_at": "2026-06-29T07:52:35.970395Z",
      • "updated_at": "2026-06-29T07:52:35.970395Z"
      },
    • "relationships": {
      • "policy_rules": {
        },
      • "policy_assignments": {
        },
      • "authorisation_rules": {
        }
      },
    • "links": {
      • "self": "/api/authorisation_policies/82d560ee-1f73-418d-afc8-0c90ee67a640",
      • "policy_rules": "/api/authorisation_policies/82d560ee-1f73-418d-afc8-0c90ee67a640/rules",
      • "policy_assignments": "/api/authorisation_policies/82d560ee-1f73-418d-afc8-0c90ee67a640/assignments"
      }
    }
}
Update authorisation policy and its rules 
Update an authorisation policy and its authorisation rules. If no authorisation rules are provided, all associated rules will be removed from the policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "name": "oda",
      • "description": "Voluptas ea recusandae at.",
      • "authorisation_rules": [
        ]
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "e5c52784-4366-41fb-9883-b610ff3823a5",
    • "type": "authorisation_policy",
    • "attributes": {
      • "name": "Updated policy name",
      • "description": "Access for all incoming users",
      • "system": false,
      • "created_by": "shaun.west",
      • "created_at": "2026-06-29T07:52:36.781515Z",
      • "updated_at": "2026-06-29T07:52:36.845046Z"
      },
    • "relationships": {
      • "policy_rules": {
        },
      • "policy_assignments": {
        },
      • "authorisation_rules": {
        }
      },
    • "links": {
      • "self": "/api/authorisation_policies/e5c52784-4366-41fb-9883-b610ff3823a5",
      • "policy_rules": "/api/authorisation_policies/e5c52784-4366-41fb-9883-b610ff3823a5/rules",
      • "policy_assignments": "/api/authorisation_policies/e5c52784-4366-41fb-9883-b610ff3823a5/assignments"
      }
    }
}
Delete policy 
Delete an authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


Responses
 Response samples 
Content type
text/plain
Authorisation policy assignments
Endpoints to interact with authorisation policy assignments.


List policy assignments 
Lists all policy assignments for a specific authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[username_eq]=opschain
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "be1018b8-c8b3-4b9b-a3ff-45160a37f5df",
      • "type": "policy_assignment",
      • "attributes": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Assign a policy to users or groups 
Assign an authorisation policy to one or more users and/or groups.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "auth_provider": null,
      • "assignments": [
        ]
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "ade4cd2d-60c6-48ef-8846-41ddeec515ce",
      • "type": "policy_assignment",
      • "attributes": {
        },
      • "links": {
        }
      }
    ]
}
Show assignment 
Show a policy assignment for a specific authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


policy_assignment_id
required
string
 
 Example:  2a88ef3c-2d05-465c-a3b4-57b4f36cbbec
policy assignment id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "f85f39a0-b685-4255-926f-7d9d6cac23be",
    • "type": "policy_assignment",
    • "attributes": {
      • "username": "limepoint",
      • "auth_provider": "ldap",
      • "groupname": "ldap-group",
      • "created_by": "rita",
      • "created_at": "2026-06-29T07:53:34.336259Z",
      • "updated_at": "2026-06-29T07:53:34.336259Z"
      },
    • "links": {
      • "self": "/api/authorisation_policies/8157f9e8-b0eb-4ee2-ae68-572ea38fa675/assignments/f85f39a0-b685-4255-926f-7d9d6cac23be"
      }
    }
}
Authorisation policy rules
Endpoints to interact with authorisation policy rules.


List policy rules 
Lists all policy rules for a specific authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[username_eq]=opschain
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "fb3e8428-c1b9-4acd-95d6-e754f65920f1",
      • "type": "policy_rule",
      • "attributes": {
        },
      • "links": {
        }
      },
    • {
      • "id": "16c56771-5a19-42f1-84ba-ad66db6588bd",
      • "type": "policy_rule",
      • "attributes": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create policy rule(s) 
Add one or more authorisation rules to a specific authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "authorisation_rule_id": "ecb1de9c-5c6a-47a7-973d-01c27520b370"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "5b7953a2-2eea-4310-83ab-7fdd47c68f17",
      • "type": "policy_rule",
      • "attributes": {
        },
      • "links": {
        }
      }
    ]
}
Delete a policy rule 
Remove an authorisation rule from a specific authorisation policy.


path Parameters
authorisation_policy_id
required
string
 
 Example:  83f52b82-584f-4a1a-8ef4-11f86dd5637a
authorisation policy id


policy_rule_id
required
string
 
 Example:  26f1c2da-b206-40af-8e8a-ec1d42a9f13a
policy rule id


Responses
 Response samples 
Content type
text/plain
Tokens
List tokens 
List all authorisation tokens.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[description_cont]=automation
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "3a960840-48e7-43f5-acf6-81a0923e38d4",
      • "type": "authentication_token",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      },
    • {
      • "id": "4ce28659-fe45-4942-8f45-a305ab4e1b2a",
      • "type": "authentication_token",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create access token 
Creates an access token for the current user.


Notes:


    

  • When the token.enable_cookies setting is true (default) a new refresh_token cookie is set in the response and the supplied refresh token is rotated (destroyed and replaced). The response body contains only the access token.
    • 

  • When the token.enable_cookies setting is false and the refresh token is supplied to authenticate the request a new refresh token is included in the response meta and the supplied refresh token is rotated (destroyed and replaced). The new refresh token JWT is available in data.meta.refresh_token.
    • 



Authorizations:
cookieAuthbearerAuthbasicAuthNone
Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "username": "username",
      • "password": "password"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "c58efec1-6a1e-4e02-b660-a4fae70d667b",
    • "type": "authentication_token",
    • "attributes": {
      • "type": "AccessToken",
      • "expires_at": "2026-06-29T11:52:33.000000Z",
      • "created_at": "2026-06-29T07:52:33.145784Z",
      • "updated_at": "2026-06-29T07:52:33.145784Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/tokens/c58efec1-6a1e-4e02-b660-a4fae70d667b"
      },
    • "meta": {
      • "bearer_token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJjNThlZmVjMS02YTFlLTRlMDItYjY2MC1hNGZhZTcwZDY2N2IiLCJpc3MiOiJPcHNDaGFpbiIsImF1ZCI6Im9wc2NoYWluX2FwaSIsImV4cCI6MTc4MjczMzk1MywiaWF0IjoxNzgyNzE5NTUzfQ.JWHZ4KnXsBe68x2ROd9c1Ms8dwn3Umb_8PJW2d0dFKM"
      }
    }
}
Create API key token 
Creates an API key token for the current user.


Note: LDAP or local login credentials, or an access token are required to use this endpoint.


Authorizations:
bearerAuthbasicAuth
Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "username": "username",
      • "password": "password",
      • "description": "CI token for API access",
      • "expiry_date": "2026-12-29T07:52:14.203104Z"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "a3be86be-c23b-40fd-833d-8745c10ecba5",
    • "type": "authentication_token",
    • "attributes": {
      • "type": "ApiKeyToken",
      • "description": "Eius doloribus hic molestiae.",
      • "expires_at": "2026-07-13T23:59:59.999999Z",
      • "created_at": "2026-06-29T07:52:33.368911Z",
      • "updated_at": "2026-06-29T07:52:33.368911Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/tokens/a3be86be-c23b-40fd-833d-8745c10ecba5"
      },
    • "meta": {
      • "bearer_token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJhM2JlODZiZS1jMjNiLTQwZmQtODMzZC04NzQ1YzEwZWNiYTUiLCJpc3MiOiJPcHNDaGFpbiIsImF1ZCI6Im9wc2NoYWluX2FwaSIsImV4cCI6MTc4Mzk4NzE5OSwiaWF0IjoxNzgyNzE5NTUzfQ.N_6rMz45FYVBCdk55IYHP-mp104QxQMX8xwJX1dExgo"
      }
    }
}
Show token 
Show an authorisation token.


path Parameters
token_id
required
string
 
 Example:  829ffed6-6666-4e93-be31-ee52fbb27a66
authorisation token id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "aaf1fec6-93b1-42d0-8f66-18848ebb9755",
    • "type": "authentication_token",
    • "attributes": {
      • "type": "ApiKeyToken",
      • "description": "CI token for API access",
      • "expires_at": "2026-12-29T23:59:59.999999Z",
      • "created_at": "2026-06-29T07:52:33.536070Z",
      • "updated_at": "2026-06-29T07:52:33.536070Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/tokens/aaf1fec6-93b1-42d0-8f66-18848ebb9755"
      }
    }
}
Delete token 
Delete an authorisation token if it exists.


path Parameters
token_id
required
string
 
 Example:  829ffed6-6666-4e93-be31-ee52fbb27a66
authorisation token id


Responses
 Response samples 
Content type
text/plain
Show access token 
Shows the active access token(s) in use by the current user.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "f26473a8-7811-41d7-a477-ef8ba6ee8886",
    • "type": "authentication_token",
    • "attributes": {
      • "type": "AccessToken",
      • "expires_at": "2026-06-29T11:52:33.000000Z",
      • "created_at": "2026-06-29T07:52:33.892365Z",
      • "updated_at": "2026-06-29T07:52:33.892365Z"
      },
    • "relationships": {
      • "owner": {
        }
      },
    • "links": {
      • "self": "/api/tokens/f26473a8-7811-41d7-a477-ef8ba6ee8886"
      }
    }
}
Delete access token 
Deletes the active access token(s) in use by the current user.


Responses
 Response samples 
Content type
text/plain
Users
Endpoints to interact with the users in the system.


List users 
Lists users in the system


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[username_eq]=opschain
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "f55edf78-2680-4f0f-ba3c-e86d94890bee",
      • "type": "user",
      • "attributes": {
        },
      • "meta": { },
      • "links": {
        }
      }
    ]
}
Show user 
Show a user.


path Parameters
user_id
required
string
 
 Example:  cb2a16a7-1c50-42f4-acb2-c83e5a1a3254
user id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "896a2273-82fa-42a3-a128-285bcc50ea50",
    • "type": "user",
    • "attributes": {
      • "username": "logged_in_user",
      • "groupnames": [
        ],
      • "auth_provider": "ldap",
      • "email_address": "logged_in_user@limepoint.com",
      • "default_notification_methods": [
        ],
      • "direct_message_ids": {
        },
      • "created_at": "2026-06-29T07:53:55.149720Z",
      • "updated_at": "2026-06-29T07:53:55.149720Z"
      },
    • "meta": {
      • "superuser": true
      },
    • "links": {
      • "self": "/api/users/896a2273-82fa-42a3-a128-285bcc50ea50"
      }
    }
}
Update user 
Update a user's notification preferences.


path Parameters
user_id
required
string
 
 Example:  cb2a16a7-1c50-42f4-acb2-c83e5a1a3254
user id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "email_address": "user@limepoint.com",
      • "default_notification_methods": [
        ],
      • "direct_message_ids": {
        }
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "6f29dcdb-9c75-4a0f-b1d5-9b87a9b3dff4",
    • "type": "user",
    • "attributes": {
      • "username": "logged_in_user",
      • "groupnames": [
        ],
      • "auth_provider": "ldap",
      • "email_address": "logged_in_user@limepoint.com",
      • "default_notification_methods": [
        ],
      • "direct_message_ids": {
        },
      • "created_at": "2026-06-29T07:53:55.291883Z",
      • "updated_at": "2026-06-29T07:53:55.358393Z"
      },
    • "meta": { },
    • "links": {
      • "self": "/api/users/6f29dcdb-9c75-4a0f-b1d5-9b87a9b3dff4"
      }
    }
}
Show current user 
Show the currently logged in user.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "ad45c1ef-df68-414b-8b5a-cb45db11a878",
    • "type": "user",
    • "attributes": {
      • "username": "logged_in_user",
      • "groupnames": [
        ],
      • "auth_provider": "ldap",
      • "email_address": "logged_in_user@limepoint.com",
      • "default_notification_methods": [
        ],
      • "direct_message_ids": {
        },
      • "created_at": "2026-06-29T07:53:55.505573Z",
      • "updated_at": "2026-06-29T07:53:55.505573Z"
      },
    • "meta": {
      • "superuser": true
      },
    • "links": {
      • "self": "/api/users/ad45c1ef-df68-414b-8b5a-cb45db11a878"
      }
    }
}
User notifications
Endpoints to interact with a users notification settings.


List notifications 
Lists notifications the user has configured for a specific project, environment or asset (that do not
reference a specific action or workflow).


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "6cae9c5a-de6e-4e5f-b136-bf13622fb59d",
      • "type": "change_notifications",
      • "attributes": {
        }
      },
    • {
      • "id": "6cae9c5a-de6e-4e5f-b136-bf13622fb59d",
      • "type": "settings_notifications",
      • "attributes": {
        }
      },
    • {
      • "id": "6cae9c5a-de6e-4e5f-b136-bf13622fb59d",
      • "type": "properties_notifications",
      • "attributes": {
        }
      }
    ]
}
List change notifications 
Lists all change specific notifications the user has configured for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "f4b6d235-1ca9-43f4-8cfd-d0dc50c21ca4",
    • "type": "action_notifications",
    • "attributes": {
      • "custom_proj_action": {
        },
      • "proj_action_1": {
        },
      • "proj_action_2": {
        },
      • "provision": {
        }
      }
    }
}
List workflow notifications 
Lists all workflow specific notifications the user has configured for a specific project, environment or asset.


path Parameters
project_code
required
string
 
 Example:  opc
project code


asset_code
required
string
 
 Example:  prj_soa
asset code


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "ae256e68-cffd-45fb-a826-b9694a59c9fe",
    • "type": "workflow_run_notifications",
    • "attributes": { }
    }
}
Groups
Endpoints to interact with the user LDAP groups.


Secrets
Endpoints to interact with secrets from the vault or decrypting AES encrypted strings.


Resolve secrets 
Returns the decrypted values of the supplied secrets


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "owner_type": "settings",
      • "owner_id": "ae7ff3b8-8136-4195-8e76-70639c126d56",
      • "source": "settings",
      • "mintmodel_owner_path": "/projects/opc/assets/prj_soa",
      • "converge_date": "2026-06-29T07:52:21.755923Z",
      • "values_to_decrypt": [
        ]
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "secrets",
    • "type": "secrets",
    • "attributes": {
      • "results": [
        ]
      }
    }
}
Info
Get version and other information about the running OpsChain instance.


Get OpsChain server info 
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "0",
    • "type": "info",
    • "attributes": {
      • "cluster_name": "opschain-db",
      • "version": "edge",
      • "runner_image": "limepoint/opschain-runner-enterprise:edge",
      • "db_version": "17.2",
      • "api_version": "7.1.5.1",
      • "ldap_available?": true,
      • "banners": [ ],
      • "instance_info": { },
      • "licence_info": {
        }
      },
    • "links": {
      • "self": "/api/info"
      },
    • "meta": {
      • "authorisations": {
        }
      }
    }
}
Trust store
Endpoint to manage the trust store and certificates.


List certificates 
Lists certificates in the trust store.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[filename_cont]=root
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "ca_self.pem",
      • "type": "certificate",
      • "attributes": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Create certificate 
Creates a certificate in the trust store.


Request Body schema: multipart/form-data
description
string or null
 
file
string <binary> 
 
certificate file, the uploaded file's filename is used to name the new certificate


Responses
 Request samples 
Content type
multipart/form-data
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="description"

New certificate description
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="file"; filename="remote_system.crt"
content-type: application/x-x509-ca-cert
content-length: 1887

-----BEGIN CERTIFICATE-----
MIIFQzCCAyugAwIBAgIUeNS0f9lqaJhC2apc91FbPRBVPNwwDQYJKoZIhvcNAQEL
BQAwMTEQMA4GA1UEAwwHUm9vdCBDQTEdMBsGA1UECgwUTGltZVBvaW50RW5naW5l
ZXJpbmcwHhcNMjUwNDI5MDA0NzAxWhcNMzAwNDI5MDA0NzAxWjAxMRAwDgYDVQQD
DAdSb290IENBMR0wGwYDVQQKDBRMaW1lUG9pbnRFbmdpbmVlcmluZzCCAiIwDQYJ
KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJoUxJkyK3VKbBhVwQPRmA9MqUOocn16
SOZm5KVPVyR2F9OZ4xIyZTkUalUFGrguoDAyvKAI+AgGRhNJG+kKQ7PLAAEbSWBE
gdXNNtSAj4Yvo0Bw3XbxqZM7kBO7GfysKMjqKsEeR0wiwshAQPsBjAYa78ayDRC5
RqN1jR9al65UdLcE5yDbbpMd7GwR3b9ythahsox8PfHL60sZf7NfI4q+SkgbOVzt
dxppCZqwZRuMVWdvvQk069UkOYoRXniQEIFU6Ugd8FWIIzleHyKEodTsRhhXUjBS
GbA3v+x66mS87r6bE6ffFwLO0reFgfx4a7dMmhd5djrOfZtZ0L8zizXwsyee5j6v
iNokciyLHgRfWYHsYZ3OgHC8p7i02Xd9vcCsaPuoGopo0G/+wog289ObTqGbxu28
X8Bk5/kIVkn79LDA4zWz7VwYY0uoK0TxWpdMg2yuvE5nH94qGlnJisopxVhrZ7qH
E+QEqUYhelJNCi62Z8gmT0z3d7lmsq9gH23o1Zngdhnygdrm3rh404bjK/xFL6Hf
0YmiYhQw8ydHKGWY8rfhjL8eXl1gURZTqLTZC6J3sF3SAS1hj2nrePsPGt7S1OqI
djd/vGLSLz/SGyE9d5sOeTvza9pmKKXKqcvPFbwgF496dZmAu6xtVC+6pa8hOXJW
YlC0xn/xXnTFAgMBAAGjUzBRMB0GA1UdDgQWBBRdN8nNGCxpxe0zHXz3BrrtlYvV
LjAfBgNVHSMEGDAWgBRdN8nNGCxpxe0zHXz3BrrtlYvVLjAPBgNVHRMBAf8EBTAD
AQH/MA0GCSqGSIb3DQEBCwUAA4ICAQB6jtlLzWd6yjbye2SsB04ns6B6WskdOAkk
pjGz7MyARCEvgfHh5HtMzBi9l5mxXjMfYuQx3ag75lTSaA/OUgGCQOQygwD6qUXX
QKslqCh1EEbNfDUuBt31OhAFECkKl194euhuIjUugyL+D07Oscg+k77WDEesBif0
R8ei+j+AX/sK4RFacFMgAAWHaI3chGu2qrnFHoKEB/R9OUieEb6c8CbVEXyOzCbW
xerP1sxPBuqvw5/UMwdafXlVmPfC/7C1dJzdw5/yAE6gwEB0ztaaEMsA22smd8dk
NDugbmY9yTLRWFN2XIs9jgCaDM0hZOFDPbxkX7oD30z3FVkbuSII3EK0GAqHYy15
ZLD5xaxolyKOvQwXYoHVJD95KX1OVuNcILsd2iVGAKpI8IWOu2A1Kvq/Kr5qtxRW
hcP+nL5XVu/mGP/GABI/zggORdjfAezb9mWi2ozfmSHyJsN8qfVOvK4urDj2YdbR
tMybK+X7KpN947oZQwJ8WgfO3mTt4jkYPEFgUyVDFRuMcx25ewxy/5+HcpZvgmKd
esPTYnR/q+kdQ+IO2OrOoBGUJ8F7bmiAKVThBWZKUn9jGAym+A4CEMrklCYwqZT5
AuA0rI1AjitrP74YqylXtmP2IUJkxCOXBthnlt1oC2UPYXyACPdp5K4+KZbK/63B
WbrO/ELdag==
-----END CERTIFICATE-----

------------XnJLe9ZIbbGUYtzPQJ16u1--

 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "remote_system.crt",
    • "type": "certificate",
    • "attributes": {
      • "filename": "remote_system.crt",
      • "content": "-----BEGIN CERTIFICATE-----\nMIIFQzCCAyugAwIBAgIUeNS0f9lqaJhC2apc91FbPRBVPNwwDQYJKoZIhvcNAQEL\nBQAwMTEQMA4GA1UEAwwHUm9vdCBDQTEdMBsGA1UECgwUTGltZVBvaW50RW5naW5l\nZXJpbmcwHhcNMjUwNDI5MDA0NzAxWhcNMzAwNDI5MDA0NzAxWjAxMRAwDgYDVQQD\nDAdSb290IENBMR0wGwYDVQQKDBRMaW1lUG9pbnRFbmdpbmVlcmluZzCCAiIwDQYJ\nKoZIhvcNAQEBBQADggIPADCCAgoCggIBAJoUxJkyK3VKbBhVwQPRmA9MqUOocn16\nSOZm5KVPVyR2F9OZ4xIyZTkUalUFGrguoDAyvKAI+AgGRhNJG+kKQ7PLAAEbSWBE\ngdXNNtSAj4Yvo0Bw3XbxqZM7kBO7GfysKMjqKsEeR0wiwshAQPsBjAYa78ayDRC5\nRqN1jR9al65UdLcE5yDbbpMd7GwR3b9ythahsox8PfHL60sZf7NfI4q+SkgbOVzt\ndxppCZqwZRuMVWdvvQk069UkOYoRXniQEIFU6Ugd8FWIIzleHyKEodTsRhhXUjBS\nGbA3v+x66mS87r6bE6ffFwLO0reFgfx4a7dMmhd5djrOfZtZ0L8zizXwsyee5j6v\niNokciyLHgRfWYHsYZ3OgHC8p7i02Xd9vcCsaPuoGopo0G/+wog289ObTqGbxu28\nX8Bk5/kIVkn79LDA4zWz7VwYY0uoK0TxWpdMg2yuvE5nH94qGlnJisopxVhrZ7qH\nE+QEqUYhelJNCi62Z8gmT0z3d7lmsq9gH23o1Zngdhnygdrm3rh404bjK/xFL6Hf\n0YmiYhQw8ydHKGWY8rfhjL8eXl1gURZTqLTZC6J3sF3SAS1hj2nrePsPGt7S1OqI\ndjd/vGLSLz/SGyE9d5sOeTvza9pmKKXKqcvPFbwgF496dZmAu6xtVC+6pa8hOXJW\nYlC0xn/xXnTFAgMBAAGjUzBRMB0GA1UdDgQWBBRdN8nNGCxpxe0zHXz3BrrtlYvV\nLjAfBgNVHSMEGDAWgBRdN8nNGCxpxe0zHXz3BrrtlYvVLjAPBgNVHRMBAf8EBTAD\nAQH/MA0GCSqGSIb3DQEBCwUAA4ICAQB6jtlLzWd6yjbye2SsB04ns6B6WskdOAkk\npjGz7MyARCEvgfHh5HtMzBi9l5mxXjMfYuQx3ag75lTSaA/OUgGCQOQygwD6qUXX\nQKslqCh1EEbNfDUuBt31OhAFECkKl194euhuIjUugyL+D07Oscg+k77WDEesBif0\nR8ei+j+AX/sK4RFacFMgAAWHaI3chGu2qrnFHoKEB/R9OUieEb6c8CbVEXyOzCbW\nxerP1sxPBuqvw5/UMwdafXlVmPfC/7C1dJzdw5/yAE6gwEB0ztaaEMsA22smd8dk\nNDugbmY9yTLRWFN2XIs9jgCaDM0hZOFDPbxkX7oD30z3FVkbuSII3EK0GAqHYy15\nZLD5xaxolyKOvQwXYoHVJD95KX1OVuNcILsd2iVGAKpI8IWOu2A1Kvq/Kr5qtxRW\nhcP+nL5XVu/mGP/GABI/zggORdjfAezb9mWi2ozfmSHyJsN8qfVOvK4urDj2YdbR\ntMybK+X7KpN947oZQwJ8WgfO3mTt4jkYPEFgUyVDFRuMcx25ewxy/5+HcpZvgmKd\nesPTYnR/q+kdQ+IO2OrOoBGUJ8F7bmiAKVThBWZKUn9jGAym+A4CEMrklCYwqZT5\nAuA0rI1AjitrP74YqylXtmP2IUJkxCOXBthnlt1oC2UPYXyACPdp5K4+KZbK/63B\nWbrO/ELdag==\n-----END CERTIFICATE-----\n",
      • "description": "New certificate description",
      • "created_at": "2026-06-29T07:53:54.565031Z",
      • "updated_at": "2026-06-29T07:53:54.565031Z"
      },
    • "links": {
      • "self": "/api/trust_store/remote_system.crt"
      }
    }
}
Show certificate 
Shows a certificate from the trust store.


path Parameters
certificate_filename
required
string
 
 Example:  ca_self.pem
certificate filename


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "ca_self.pem",
    • "type": "certificate",
    • "attributes": {
      • "filename": "ca_self.pem",
      • "content": "-----BEGIN CERTIFICATE-----\nMIIFQzCCAyugAwIBAgIUeNS0f9lqaJhC2apc91FbPRBVPNwwDQYJKoZIhvcNAQEL\nBQAwMTEQMA4GA1UEAwwHUm9vdCBDQTEdMBsGA1UECgwUTGltZVBvaW50RW5naW5l\nZXJpbmcwHhcNMjUwNDI5MDA0NzAxWhcNMzAwNDI5MDA0NzAxWjAxMRAwDgYDVQQD\nDAdSb290IENBMR0wGwYDVQQKDBRMaW1lUG9pbnRFbmdpbmVlcmluZzCCAiIwDQYJ\nKoZIhvcNAQEBBQADggIPADCCAgoCggIBAJoUxJkyK3VKbBhVwQPRmA9MqUOocn16\nSOZm5KVPVyR2F9OZ4xIyZTkUalUFGrguoDAyvKAI+AgGRhNJG+kKQ7PLAAEbSWBE\ngdXNNtSAj4Yvo0Bw3XbxqZM7kBO7GfysKMjqKsEeR0wiwshAQPsBjAYa78ayDRC5\nRqN1jR9al65UdLcE5yDbbpMd7GwR3b9ythahsox8PfHL60sZf7NfI4q+SkgbOVzt\ndxppCZqwZRuMVWdvvQk069UkOYoRXniQEIFU6Ugd8FWIIzleHyKEodTsRhhXUjBS\nGbA3v+x66mS87r6bE6ffFwLO0reFgfx4a7dMmhd5djrOfZtZ0L8zizXwsyee5j6v\niNokciyLHgRfWYHsYZ3OgHC8p7i02Xd9vcCsaPuoGopo0G/+wog289ObTqGbxu28\nX8Bk5/kIVkn79LDA4zWz7VwYY0uoK0TxWpdMg2yuvE5nH94qGlnJisopxVhrZ7qH\nE+QEqUYhelJNCi62Z8gmT0z3d7lmsq9gH23o1Zngdhnygdrm3rh404bjK/xFL6Hf\n0YmiYhQw8ydHKGWY8rfhjL8eXl1gURZTqLTZC6J3sF3SAS1hj2nrePsPGt7S1OqI\ndjd/vGLSLz/SGyE9d5sOeTvza9pmKKXKqcvPFbwgF496dZmAu6xtVC+6pa8hOXJW\nYlC0xn/xXnTFAgMBAAGjUzBRMB0GA1UdDgQWBBRdN8nNGCxpxe0zHXz3BrrtlYvV\nLjAfBgNVHSMEGDAWgBRdN8nNGCxpxe0zHXz3BrrtlYvVLjAPBgNVHRMBAf8EBTAD\nAQH/MA0GCSqGSIb3DQEBCwUAA4ICAQB6jtlLzWd6yjbye2SsB04ns6B6WskdOAkk\npjGz7MyARCEvgfHh5HtMzBi9l5mxXjMfYuQx3ag75lTSaA/OUgGCQOQygwD6qUXX\nQKslqCh1EEbNfDUuBt31OhAFECkKl194euhuIjUugyL+D07Oscg+k77WDEesBif0\nR8ei+j+AX/sK4RFacFMgAAWHaI3chGu2qrnFHoKEB/R9OUieEb6c8CbVEXyOzCbW\nxerP1sxPBuqvw5/UMwdafXlVmPfC/7C1dJzdw5/yAE6gwEB0ztaaEMsA22smd8dk\nNDugbmY9yTLRWFN2XIs9jgCaDM0hZOFDPbxkX7oD30z3FVkbuSII3EK0GAqHYy15\nZLD5xaxolyKOvQwXYoHVJD95KX1OVuNcILsd2iVGAKpI8IWOu2A1Kvq/Kr5qtxRW\nhcP+nL5XVu/mGP/GABI/zggORdjfAezb9mWi2ozfmSHyJsN8qfVOvK4urDj2YdbR\ntMybK+X7KpN947oZQwJ8WgfO3mTt4jkYPEFgUyVDFRuMcx25ewxy/5+HcpZvgmKd\nesPTYnR/q+kdQ+IO2OrOoBGUJ8F7bmiAKVThBWZKUn9jGAym+A4CEMrklCYwqZT5\nAuA0rI1AjitrP74YqylXtmP2IUJkxCOXBthnlt1oC2UPYXyACPdp5K4+KZbK/63B\nWbrO/ELdag==\n-----END CERTIFICATE-----\n",
      • "description": "Main CA cert.",
      • "created_at": "2026-06-29T07:53:54.647068Z",
      • "updated_at": "2026-06-29T07:53:54.647068Z"
      },
    • "links": {
      • "self": "/api/trust_store/ca_self.pem"
      }
    }
}
Delete certificate 
Delete certificate from the trust store.


path Parameters
certificate_filename
required
string
 
 Example:  ca_self.pem
certificate filename


Responses
 Response samples 
Content type
text/plain
Update certificate 
Updates a certificate in the trust store.


path Parameters
certificate_filename
required
string
 
 Example:  ca_self.pem
certificate filename


Request Body schema: multipart/form-data
description
string or null
 
file
string <binary> 
 
certificate file (the filename is ignored)


Responses
 Request samples 
Content type
multipart/form-data
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="description"

Updated certificate description
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="file"; filename="remote_system.crt"
content-type: application/x-x509-ca-cert
content-length: 1887

-----BEGIN CERTIFICATE-----
MIIFQzCCAyugAwIBAgIUeNS0f9lqaJhC2apc91FbPRBVPNwwDQYJKoZIhvcNAQEL
BQAwMTEQMA4GA1UEAwwHUm9vdCBDQTEdMBsGA1UECgwUTGltZVBvaW50RW5naW5l
ZXJpbmcwHhcNMjUwNDI5MDA0NzAxWhcNMzAwNDI5MDA0NzAxWjAxMRAwDgYDVQQD
DAdSb290IENBMR0wGwYDVQQKDBRMaW1lUG9pbnRFbmdpbmVlcmluZzCCAiIwDQYJ
KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJoUxJkyK3VKbBhVwQPRmA9MqUOocn16
SOZm5KVPVyR2F9OZ4xIyZTkUalUFGrguoDAyvKAI+AgGRhNJG+kKQ7PLAAEbSWBE
gdXNNtSAj4Yvo0Bw3XbxqZM7kBO7GfysKMjqKsEeR0wiwshAQPsBjAYa78ayDRC5
RqN1jR9al65UdLcE5yDbbpMd7GwR3b9ythahsox8PfHL60sZf7NfI4q+SkgbOVzt
dxppCZqwZRuMVWdvvQk069UkOYoRXniQEIFU6Ugd8FWIIzleHyKEodTsRhhXUjBS
GbA3v+x66mS87r6bE6ffFwLO0reFgfx4a7dMmhd5djrOfZtZ0L8zizXwsyee5j6v
iNokciyLHgRfWYHsYZ3OgHC8p7i02Xd9vcCsaPuoGopo0G/+wog289ObTqGbxu28
X8Bk5/kIVkn79LDA4zWz7VwYY0uoK0TxWpdMg2yuvE5nH94qGlnJisopxVhrZ7qH
E+QEqUYhelJNCi62Z8gmT0z3d7lmsq9gH23o1Zngdhnygdrm3rh404bjK/xFL6Hf
0YmiYhQw8ydHKGWY8rfhjL8eXl1gURZTqLTZC6J3sF3SAS1hj2nrePsPGt7S1OqI
djd/vGLSLz/SGyE9d5sOeTvza9pmKKXKqcvPFbwgF496dZmAu6xtVC+6pa8hOXJW
YlC0xn/xXnTFAgMBAAGjUzBRMB0GA1UdDgQWBBRdN8nNGCxpxe0zHXz3BrrtlYvV
LjAfBgNVHSMEGDAWgBRdN8nNGCxpxe0zHXz3BrrtlYvVLjAPBgNVHRMBAf8EBTAD
AQH/MA0GCSqGSIb3DQEBCwUAA4ICAQB6jtlLzWd6yjbye2SsB04ns6B6WskdOAkk
pjGz7MyARCEvgfHh5HtMzBi9l5mxXjMfYuQx3ag75lTSaA/OUgGCQOQygwD6qUXX
QKslqCh1EEbNfDUuBt31OhAFECkKl194euhuIjUugyL+D07Oscg+k77WDEesBif0
R8ei+j+AX/sK4RFacFMgAAWHaI3chGu2qrnFHoKEB/R9OUieEb6c8CbVEXyOzCbW
xerP1sxPBuqvw5/UMwdafXlVmPfC/7C1dJzdw5/yAE6gwEB0ztaaEMsA22smd8dk
NDugbmY9yTLRWFN2XIs9jgCaDM0hZOFDPbxkX7oD30z3FVkbuSII3EK0GAqHYy15
ZLD5xaxolyKOvQwXYoHVJD95KX1OVuNcILsd2iVGAKpI8IWOu2A1Kvq/Kr5qtxRW
hcP+nL5XVu/mGP/GABI/zggORdjfAezb9mWi2ozfmSHyJsN8qfVOvK4urDj2YdbR
tMybK+X7KpN947oZQwJ8WgfO3mTt4jkYPEFgUyVDFRuMcx25ewxy/5+HcpZvgmKd
esPTYnR/q+kdQ+IO2OrOoBGUJ8F7bmiAKVThBWZKUn9jGAym+A4CEMrklCYwqZT5
AuA0rI1AjitrP74YqylXtmP2IUJkxCOXBthnlt1oC2UPYXyACPdp5K4+KZbK/63B
WbrO/ELdag==
-----END CERTIFICATE-----

------------XnJLe9ZIbbGUYtzPQJ16u1--

 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "remote_system.crt",
    • "type": "certificate",
    • "attributes": {
      • "filename": "remote_system.crt",
      • "content": "-----BEGIN CERTIFICATE-----\nMIIFQzCCAyugAwIBAgIUeNS0f9lqaJhC2apc91FbPRBVPNwwDQYJKoZIhvcNAQEL\nBQAwMTEQMA4GA1UEAwwHUm9vdCBDQTEdMBsGA1UECgwUTGltZVBvaW50RW5naW5l\nZXJpbmcwHhcNMjUwNDI5MDA0NzAxWhcNMzAwNDI5MDA0NzAxWjAxMRAwDgYDVQQD\nDAdSb290IENBMR0wGwYDVQQKDBRMaW1lUG9pbnRFbmdpbmVlcmluZzCCAiIwDQYJ\nKoZIhvcNAQEBBQADggIPADCCAgoCggIBAJoUxJkyK3VKbBhVwQPRmA9MqUOocn16\nSOZm5KVPVyR2F9OZ4xIyZTkUalUFGrguoDAyvKAI+AgGRhNJG+kKQ7PLAAEbSWBE\ngdXNNtSAj4Yvo0Bw3XbxqZM7kBO7GfysKMjqKsEeR0wiwshAQPsBjAYa78ayDRC5\nRqN1jR9al65UdLcE5yDbbpMd7GwR3b9ythahsox8PfHL60sZf7NfI4q+SkgbOVzt\ndxppCZqwZRuMVWdvvQk069UkOYoRXniQEIFU6Ugd8FWIIzleHyKEodTsRhhXUjBS\nGbA3v+x66mS87r6bE6ffFwLO0reFgfx4a7dMmhd5djrOfZtZ0L8zizXwsyee5j6v\niNokciyLHgRfWYHsYZ3OgHC8p7i02Xd9vcCsaPuoGopo0G/+wog289ObTqGbxu28\nX8Bk5/kIVkn79LDA4zWz7VwYY0uoK0TxWpdMg2yuvE5nH94qGlnJisopxVhrZ7qH\nE+QEqUYhelJNCi62Z8gmT0z3d7lmsq9gH23o1Zngdhnygdrm3rh404bjK/xFL6Hf\n0YmiYhQw8ydHKGWY8rfhjL8eXl1gURZTqLTZC6J3sF3SAS1hj2nrePsPGt7S1OqI\ndjd/vGLSLz/SGyE9d5sOeTvza9pmKKXKqcvPFbwgF496dZmAu6xtVC+6pa8hOXJW\nYlC0xn/xXnTFAgMBAAGjUzBRMB0GA1UdDgQWBBRdN8nNGCxpxe0zHXz3BrrtlYvV\nLjAfBgNVHSMEGDAWgBRdN8nNGCxpxe0zHXz3BrrtlYvVLjAPBgNVHRMBAf8EBTAD\nAQH/MA0GCSqGSIb3DQEBCwUAA4ICAQB6jtlLzWd6yjbye2SsB04ns6B6WskdOAkk\npjGz7MyARCEvgfHh5HtMzBi9l5mxXjMfYuQx3ag75lTSaA/OUgGCQOQygwD6qUXX\nQKslqCh1EEbNfDUuBt31OhAFECkKl194euhuIjUugyL+D07Oscg+k77WDEesBif0\nR8ei+j+AX/sK4RFacFMgAAWHaI3chGu2qrnFHoKEB/R9OUieEb6c8CbVEXyOzCbW\nxerP1sxPBuqvw5/UMwdafXlVmPfC/7C1dJzdw5/yAE6gwEB0ztaaEMsA22smd8dk\nNDugbmY9yTLRWFN2XIs9jgCaDM0hZOFDPbxkX7oD30z3FVkbuSII3EK0GAqHYy15\nZLD5xaxolyKOvQwXYoHVJD95KX1OVuNcILsd2iVGAKpI8IWOu2A1Kvq/Kr5qtxRW\nhcP+nL5XVu/mGP/GABI/zggORdjfAezb9mWi2ozfmSHyJsN8qfVOvK4urDj2YdbR\ntMybK+X7KpN947oZQwJ8WgfO3mTt4jkYPEFgUyVDFRuMcx25ewxy/5+HcpZvgmKd\nesPTYnR/q+kdQ+IO2OrOoBGUJ8F7bmiAKVThBWZKUn9jGAym+A4CEMrklCYwqZT5\nAuA0rI1AjitrP74YqylXtmP2IUJkxCOXBthnlt1oC2UPYXyACPdp5K4+KZbK/63B\nWbrO/ELdag==\n-----END CERTIFICATE-----\n",
      • "description": "Updated certificate description",
      • "created_at": "2026-06-29T07:53:55.059676Z",
      • "updated_at": "2026-06-29T07:53:55.059676Z"
      },
    • "links": {
      • "self": "/api/trust_store/remote_system.crt"
      }
    }
}
System configuration
Endpoint to fetch the current system configuration.


Update licence 
Updates the system licence.


Request Body schema: multipart/form-data
licence
string
 
Responses
 Request samples 
Content type
multipart/form-data
------------XnJLe9ZIbbGUYtzPQJ16u1
content-disposition: form-data; name="licence"; filename="expired_opschain.licence"
content-type: application/json
content-length: 924

{"data":{"license_issuer":"LimePoint Pty Ltd","license_issuer_contact":"support@limepoint.com","license_version":"1","customer_identifier":"Engineering","start_date":"2023-11-14T00:00:00Z","end_date":"2024-02-14T00:00:00Z"},"signature":"m/hevqjjrYYjOS8ZtgVGGerm028UpKWw/I1cGB4vcJCwI805OtAo1PmszCxWQGOXilgAqyLERLluimRBckFYVL8yx7+rTFxF4D13FqwbwRL5HcKKkV1wwGgzuMpaGE8JGpAq/CkBq6l3xL+jPv/CSYaEyE55+20UdmkZdkvR2vKoJtqDzA1q/4T9tiPA0YIKDjjxSasLBpqokl0iUuaDWksaIhXjdsKmj0FSPfVD2VyPyrBSc1sv0pR+qz98Ny9ef7t6/pIaphLo8Yaa2dnJykeXtAWiaLe+25/OWxEHZoZBvKjentD5dzvqiA8Xo1qhm/tMurTQq4BGJvWYK70LQY9EXlxd+1XLbFX0qdNBNFnzf+rjbGfrLIMw2NFhsODDordSh5P3xNGGG4JyXrwXVRPUaw30celB+uYK3vvDzis0DSBXSA+D9JV3E9YxbI4xuT9Kf+bl0+cr/BajEBhuzATk30a8y5Zqn2MfCBmMb1iLkoFWWvFA+cfUsKsWk3O4YDmR3paOz+HVrSA5HlwaOMOU/P15/q5YFfN6ZEz4DW28I+lfFE3PtgkCsjcPCd99Ca4ZSmiok/l55zRxxrYl6Xc1TNOuq58yp05U798VaEEvmCaVvp5Fk/+TrbGMWKUlPPvc86RzsOlI8Qkdn75SJM3WMEl931m4A52g6jF6+T0="}

------------XnJLe9ZIbbGUYtzPQJ16u1--

 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "expired_opschain.licence",
    • "type": "licence",
    • "attributes": {
      • "licence": "licence data"
      }
    }
}
Get OpsChain system configuration 
Shows the current system configuration node.


query Parameters
include
string
 
 Example:  include=settings
Include the settings in the response


fields[<resource_type>]
string
 
 Example:  fields[<resource_type>]=code,name
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "9dbe39a9-4496-415f-babc-b392c0d2c7b6",
    • "type": "system_configuration",
    • "attributes": {
      • "code": "system",
      • "name": "System Configuration",
      • "description": "System configuration node"
      },
    • "relationships": {
      • "settings": {
        },
      • "properties": {
        }
      },
    • "links": {
      • "self": "/api/system_configuration",
      • "settings": "/api/settings/f5f91e33-fdfb-43b2-bf7a-c923e6839a7c",
      • "properties": "/api/properties/0805af51-20e5-4c4d-b60a-ca89142582bb"
      },
    • "meta": {
      • "can_have_changes": false,
      • "can_have_children": false,
      • "can_have_properties": true,
      • "can_have_settings": true,
      • "can_have_templates": false,
      • "requires_template": false,
      • "child_node_types": [ ],
      • "can_have_workflows": false,
      • "authorisations": {
        }
      }
    },
  • "included": [
    • {
      • "id": "f5f91e33-fdfb-43b2-bf7a-c923e6839a7c",
      • "type": "settings",
      • "attributes": {
        },
      • "relationships": {
        },
      • "links": {
        }
      }
    ]
}
Admin operations
Endpoints to monitor the status of your OpsChain instance.


Get status information about the OpsChain database 
Returns status information about the OpsChain database.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "0",
      • "type": "database_status",
      • "attributes": {
        },
      • "links": {
        }
      }
    ]
}
Get the status of the OpsChain nodes 
Returns the status of all the OpsChain nodes.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "opschain.limepoint.engineering",
      • "type": "node_status",
      • "attributes": {
        }
      }
    ]
}
Get the status of the OpsChain queues 
Returns the status of the OpsChain queues and details about their jobs.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "default",
      • "type": "queue_status",
      • "attributes": {
        }
      }
    ]
}
Get the status of the OpsChain API workers 
Returns the status of all the OpsChain API workers in the configured namespace.


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "opschain-api-worker-1",
      • "type": "worker",
      • "attributes": {
        }
      }
    ]
}
Data cleanup definitions
Endpoints to interact with data cleanup definitions.


List data cleanup definitions 
Lists all data cleanup definitions.


query Parameters
filter[<query/sort filter>]=
string
 
 Example:  filter[<query/sort filter>]==> filter[name_eq]=test
Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": [
    • {
      • "id": "eed4bf81-d41c-4286-97ed-bb113c2936f0",
      • "type": "data_cleanup_definition",
      • "attributes": {
        },
      • "links": {
        }
      }
    ],
  • "meta": {
    • "authorisations": {
      • "update": true
      },
    • "has_any": true
    }
}
Create data cleanup definition 
Notes:


    

  1. See the various payload examples to understand the required fields for each possible request to this endpoint.
    2. 

  2. Either the cron_schedule or run_at fields must be provided.
    3. 

  3. The keys accepted for the filters field are changes, events, jobs, and workflow_runs. The agent image cleanup job accepts template_version_history and the build_agent_image_task. Each of these can have ransack filters for the specific type they refer to.
IMPORTANT: If no filters are provided for a data type, the cleanup will remove all data that matches the node paths.
    4. 

  4. The node_paths field is an array of strings. Each string is a path to a node. The path must start with /projects and only contain forward slashes, lowercase letters, numbers and underscores, and optionally a single "%" at the end.
Use the % wildcard to include all nodes under a specific node or node-type, note that this will apply the cleanup to all nodes that are yet to be created, as long as they match the path.
    5. 



Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "name": "bandwidth",
      • "enabled": true,
      • "node_paths": [ ],
      • "filters": { },
      • "purge_activities": true,
      • "purge_events": false,
      • "purge_jobs": true,
      • "cron_schedule": "0 0 * * *",
      • "run_at": null,
      • "end_at": null,
      • "maximum_run_count": null,
      • "repeat": true,
      • "purge_agent_images": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "a2a19a5d-ae24-4f3f-bd11-45149bb25931",
    • "type": "data_cleanup_definition",
    • "attributes": {
      • "name": "hard drive",
      • "enabled": true,
      • "created_by": "logged_in_user",
      • "cron_schedule": "39 16 25 9 1",
      • "repeat": true,
      • "maximum_run_count": null,
      • "purge_activities": false,
      • "purge_events": true,
      • "purge_jobs": false,
      • "purge_agent_images": true,
      • "filters": {
        },
      • "node_paths": [
        ],
      • "run_count": 0,
      • "created_at": "2026-06-29T07:52:58.914156Z",
      • "updated_at": "2026-06-29T07:52:58.914156Z",
      • "next_run_at": "2026-09-07T06:39:00.000000Z",
      • "run_at": null,
      • "end_at": null
      },
    • "links": {
      • "self": "/api/data_cleanup_definitions/a2a19a5d-ae24-4f3f-bd11-45149bb25931"
      }
    },
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Show a data cleanup definition 
Shows a data cleanup definition.


path Parameters
data_cleanup_definition_id
required
string
 
 Example:  741058b8-5a7b-4199-bcb1-517b27bf04fa
data cleanup definition id


Responses
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "767cb23a-2672-4441-868e-77b6a14a1ed2",
    • "type": "data_cleanup_definition",
    • "attributes": {
      • "name": "card",
      • "enabled": true,
      • "created_by": "brent",
      • "cron_schedule": "0 0 7,14,21,28 * *",
      • "repeat": true,
      • "maximum_run_count": null,
      • "purge_activities": false,
      • "purge_events": true,
      • "purge_jobs": false,
      • "purge_agent_images": false,
      • "filters": {
        },
      • "node_paths": [
        ],
      • "run_count": 0,
      • "created_at": "2026-06-29T07:52:59.307251Z",
      • "updated_at": "2026-06-29T07:52:59.307251Z",
      • "next_run_at": "2026-07-06T14:00:00.000000Z",
      • "run_at": null,
      • "end_at": null
      },
    • "links": {
      • "self": "/api/data_cleanup_definitions/767cb23a-2672-4441-868e-77b6a14a1ed2"
      }
    },
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Update the data cleanup definition 
Updates a data cleanup definition.


Notes:


    

  1. See the various payload examples in the create endpoint to understand the attributes you can supply to this endpoint.
    2. 

  2. The payload need only consist of the attributes you wish to modify. There is no need to supply the entire data cleanup definition.
    3. 



path Parameters
data_cleanup_definition_id
required
string
 
 Example:  741058b8-5a7b-4199-bcb1-517b27bf04fa
data cleanup definition id


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
Example
{
  • "data": {
    • "attributes": {
      • "name": "new_name",
      • "enabled": true,
      • "node_paths": [ ],
      • "filters": { },
      • "purge_activities": false,
      • "purge_events": false,
      • "purge_jobs": true,
      • "cron_schedule": "7 15 28 11 1",
      • "run_at": null,
      • "end_at": null,
      • "maximum_run_count": null,
      • "repeat": true,
      • "purge_agent_images": true
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "2c013f25-9e9d-4095-86d9-8493c5c1b176",
    • "type": "data_cleanup_definition",
    • "attributes": {
      • "name": "new_name",
      • "enabled": true,
      • "created_by": "nyla",
      • "cron_schedule": "0 0 7,14,21,28 * *",
      • "repeat": true,
      • "maximum_run_count": 5,
      • "purge_activities": true,
      • "purge_events": true,
      • "purge_jobs": true,
      • "purge_agent_images": true,
      • "filters": {
        },
      • "node_paths": [
        ],
      • "run_count": 0,
      • "created_at": "2026-06-29T07:52:59.676800Z",
      • "updated_at": "2026-06-29T07:52:59.757097Z",
      • "next_run_at": "2026-07-06T14:00:00.000000Z",
      • "run_at": null,
      • "end_at": null
      },
    • "links": {
      • "self": "/api/data_cleanup_definitions/2c013f25-9e9d-4095-86d9-8493c5c1b176"
      }
    },
  • "meta": {
    • "authorisations": {
      • "update": true
      }
    }
}
Delete the data cleanup definition 
Delete a data cleanup definition.


path Parameters
data_cleanup_definition_id
required
string
 
 Example:  741058b8-5a7b-4199-bcb1-517b27bf04fa
data cleanup definition id


Responses
 Response samples 
Content type
text/plain
Compare nodes
Compare two nodes 
Extracts the converged properties, converged settings, and relevant asset MintModel for the two nodes
supplied. Also includes environments and assets summaries, and most recent change for each node.


Request Body schema: application/vnd.api+json
required
object
 
Responses
 Request samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "attributes": {
      • "node_path_a": "/projects/opc/environments/dev/assets/env_soa",
      • "node_path_b": "/projects/opc/assets/prj_soa"
      }
    }
}
 Response samples 
Content type
application/vnd.api+json
{
  • "data": {
    • "id": "env_soa:prj_soa",
    • "type": "node_comparison",
    • "attributes": {
      • "nodes": {
        },
      • "properties": {
        },
      • "settings": {
        },
      • "mintmodel": {
        },
      • "environments": {
        },
      • "assets": {
        },
      • "agents": {
        }
      }
    }
}