API Reference

The Chain API endpoints provide an interface for getting information about chains and their commands.

Chain

Properties

NameTypeDescriptionRestrictions
concurrency_enabledbooleanWhether or not the chain will execute commands in parallel.
created_atstringA timestamp representing the original creation time of the chain.
descriptionstringA brief summary of what the chain does.
disabledbooleanWhether or not the chain is disabled.
idIDThe unique identifier of a resource (can be a GUID).
internal_idintegerThe unique identifier of the chain resource in the Chains environment.
namestringThe name of the chain.
runtime_inputs[object]Variables available for user input for each execution.
runtime_inputs.data_typestringThe data type of the variable.
runtime_inputs.vuidstringThe unique identifier of the variable.
schedules[ChainSchedule]An array describing the automated schedule for a chain run.
updated_atstringA timestamp representing the last updated time of the chain.

Example

{
  "concurrency_enabled": true,
  "created_at": "2018-03-14 20:10:39.520585",
  "description": "Sends an email when new changes are made to a Workiva spreadsheet.",
  "disabled": false,
  "id": "74",
  "internal_id": 74,
  "name": "Monitoring Chain",
  "runtime_inputs": [
    {
      "data_type": "file",
      "vuid": "45072337-72ee-4c52-9428-0b2ae21ac73c"
    }
  ],
  "schedules": [
    {
      "enabled": true,
      "end_at": "string",
      "properties": {
        "days_of_month": [
          "string"
        ],
        "days_of_week": [
          "string"
        ],
        "recurring_interval": 0,
        "recurring_type": "string",
        "run_at_hours": 0,
        "run_at_minutes": 0,
        "run_at_seconds": 0,
        "zone": "string"
      },
      "start_at": "string"
    }
  ],
  "updated_at": "2018-03-14 20:10:39.520585"
}

Command

Properties

NameTypeDescriptionRestrictions
descriptionstringA brief summary of what the command does.
idIDThe unique identifier of a resource (can be a GUID).
link_idstringThe link ID associated with the command.
namestringThe name of the command.

Example

{
  "description": "string",
  "id": "74",
  "link_id": "string",
  "name": "string"
}

ChainsResponse

Properties

NameTypeDescriptionRestrictions
data[Chain]

Example

{
  "data": [
    {
      "concurrency_enabled": true,
      "created_at": "2018-03-14 20:10:39.520585",
      "description": "Sends an email when new changes are made to a Workiva spreadsheet.",
      "disabled": false,
      "id": "74",
      "internal_id": 74,
      "name": "Monitoring Chain",
      "runtime_inputs": [
        {
          "data_type": "file",
          "vuid": "45072337-72ee-4c52-9428-0b2ae21ac73c"
        }
      ],
      "schedules": [
        {
          "enabled": true,
          "end_at": "string",
          "properties": {
            "days_of_month": [
              "string"
            ],
            "days_of_week": [
              "string"
            ],
            "recurring_interval": 0,
            "recurring_type": "string",
            "run_at_hours": 0,
            "run_at_minutes": 0,
            "run_at_seconds": 0,
            "zone": "string"
          },
          "start_at": "string"
        }
      ],
      "updated_at": "2018-03-14 20:10:39.520585"
    }
  ]
}

ChainSchedule

Properties

NameTypeDescriptionRestrictions
enabledboolean
end_atstring
propertiesobject
properties.days_of_month[string]
properties.days_of_week[string]
properties.recurring_intervalinteger
properties.recurring_typestring
properties.run_at_hoursinteger
properties.run_at_minutesinteger
properties.run_at_secondsinteger
properties.zonestring
start_atstring

Example

{
  "enabled": true,
  "end_at": "string",
  "properties": {
    "days_of_month": [
      "string"
    ],
    "days_of_week": [
      "string"
    ],
    "recurring_interval": 0,
    "recurring_type": "string",
    "run_at_hours": 0,
    "run_at_minutes": 0,
    "run_at_seconds": 0,
    "zone": "string"
  },
  "start_at": "string"
}