Back to top

Dataiku Govern API

Call paths

All calls in the Govern public API are relative to the /public/api path on the Govern server.

For example, if your Govern server is available at http://mymachine:10000/, and you want to call the List blueprints API, you must make a GET request on http://mymachine:10000/public/api/blueprints/

curl --user <USER_API_KEY>: -H "Content-Type: application/json" -X GET http://mymachine:port/public/api/blueprints/

Other notes

Many API calls may return additional attributes compared to the documentation. The stability of these additional attributes is not guaranteed. They may be modified or removed in future releases without notice.

All API calls will return the following two HTTP headers

  • DSS-API-Version: Version of the API server handling the request
    • DSS-Version : Version of the DSS backend answering the request

Blueprints & Blueprints Versions

Blueprints

List blueprints
GET/blueprints

Lists the blueprints.

Example URI

GET /blueprints
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "blueprint": {
      "name": "blueprintName",
      "icon": "fiber_new",
      "color": "#494eba",
      "backgroundColor": "#000000",
      "id": "bp.control"
    },
    "assignedRolesAndPermissionsCtx": {}
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Blueprint

Get blueprint
GET/blueprint/{blueprintId}

Retrieves a specific blueprint

Example URI

GET /blueprint/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "assignedRolesAndPermissionsCtx": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      }
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {}
    }
  }
}

Blueprint Versions

List blueprint versions
GET/blueprint/{blueprintId}/versions

Lists the versions of a blueprint

Example URI

GET /blueprint/bp.control/versions
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "blueprint": {
      "name": "blueprintName",
      "icon": "fiber_new",
      "color": "#494eba",
      "backgroundColor": "#000000",
      "id": "bp.control"
    },
    "blueprintVersion": {
      "name": "Version1",
      "fieldDefinitions": {},
      "workflowDefinition": {
        "stepDefinitions": [
          {
            "id": "step1",
            "name": "Step1"
          }
        ]
      },
      "logicalHookList": [],
      "hierarchicalParentFieldId": null,
      "uiDefinition": {
        "views": {
          "view1": {},
          "view2": {}
        },
        "uiStepDefinitions": {
          "step1": {
            "viewId": "view1"
          },
          "step2": {
            "viewId": "view1"
          }
        }
      },
      "instructions": "Instructions for this version",
      "id": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      }
    },
    "blueprintVersionTrace": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "status": "DRAFT",
      "originVersionId": null
    },
    "assignedRolesAndPermissionsCtx": {},
    "signoffConfigurations": [
      {
        "id": {
          "blueprintVersionId": {
            "blueprintId": "bp.control",
            "versionId": "bv.v1"
          },
          "stepId": "step1"
        },
        "title": "title",
        "description": "description",
        "mandatory": true,
        "feedbackUsersGroups": [
          {
            "id": "group1",
            "title": "Group 1",
            "users": [
              {
                "addedBy": "admin",
                "addedOn": "2021-09-02T18:26:03.748+02:00",
                "delegated": false,
                "userContainer": {
                  "type": "user",
                  "login": "UserA"
                }
              }
            ]
          }
        ],
        "approvers": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ],
        "recurrenceConfiguration": {
          "activated": true,
          "days": 0,
          "weeks": 0,
          "months": 6,
          "years": 0,
          "reloadConf": false
        }
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Blueprint Version

Get blueprint version
GET/blueprint/{blueprintId}/version/{versionId}

Retrieves a blueprint version

Example URI

GET /blueprint/bp.control/version/bv.v1
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

versionId
string (required) Example: bv.v1

the ID of the version

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "blueprintVersionTrace": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": "DRAFT",
    "originVersionId": null
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffConfigurations": [
    {
      "id": {
        "blueprintVersionId": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        },
        "stepId": "step1"
      },
      "title": "title",
      "description": "description",
      "mandatory": true,
      "feedbackUsersGroups": [
        {
          "id": "group1",
          "title": "Group 1",
          "users": [
            {
              "addedBy": "admin",
              "addedOn": "2021-09-02T18:26:03.748+02:00",
              "delegated": false,
              "userContainer": {
                "type": "user",
                "login": "UserA"
              }
            }
          ]
        }
      ],
      "approvers": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ],
      "recurrenceConfiguration": {
        "activated": true,
        "days": 0,
        "weeks": 0,
        "months": 6,
        "years": 0,
        "reloadConf": false
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "the corresponding blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "Definition of the blueprint version"
    },
    "blueprintVersionTrace": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        },
        "status": {
          "type": "string",
          "enum": [
            "DRAFT",
            "ACTIVE",
            "ARCHIVED"
          ],
          "description": "Status of the blueprint version"
        },
        "originVersionId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Version of the origin blueprint version"
        }
      },
      "description": "Trace related information of the blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffConfigurations": {
      "type": [
        "array",
        "null"
      ],
      "description": "Sign-off configurations"
    }
  },
  "definitions": {
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Artifacts

Artifacts

Create artifact
POST/artifacts

Creates an artifact

Example URI

POST /artifacts
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintVersionId": {
    "blueprintId": "bp.control",
    "versionId": "bv.v1"
  },
  "status": {
    "archived": false,
    "stepId": "step1"
  },
  "name": "",
  "fields": {
    "field1": {},
    "field2": {}
  },
  "attachments": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintVersionId": {
      "type": "object",
      "properties": {
        "blueprintId": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.'"
        },
        "versionId": {
          "type": "string",
          "description": "ID of the version, starts with 'bv.'"
        }
      },
      "description": "ID of the related blueprint version"
    },
    "status": {
      "type": "object",
      "properties": {
        "archived": {
          "type": "boolean"
        },
        "stepId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Current active workflow step of the artifact"
        }
      },
      "description": "Status of the artifact"
    },
    "name": {
      "type": "string",
      "description": "Name of the artifact"
    },
    "fields": {
      "allOf": [
        {
          "$ref": "#/definitions/field1"
        },
        {
          "$ref": "#/definitions/field2"
        }
      ],
      "description": "Map with the values of the fields"
    },
    "attachments": {
      "type": "object",
      "properties": {},
      "description": "Attachments of the artifact"
    }
  },
  "definitions": {
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "artifact": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": {
      "archived": false,
      "stepId": "step1"
    },
    "name": "",
    "fields": {
      "field1": {},
      "field2": {}
    },
    "attachments": {},
    "id": "ar.54"
  },
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffs": [
    {
      "signoffId": {
        "artifactId": "ar.57",
        "stepId": "step1"
      },
      "cycleIndex": 0,
      "configuration": {
        "id": {
          "blueprintVersionId": {
            "blueprintId": "bp.control",
            "versionId": "bv.v1"
          },
          "stepId": "step1"
        },
        "title": "title",
        "description": "description",
        "mandatory": true,
        "feedbackUsersGroups": [
          {
            "id": "group1",
            "title": "Group 1",
            "users": [
              {
                "addedBy": "admin",
                "addedOn": "2021-09-02T18:26:03.748+02:00",
                "delegated": false,
                "userContainer": {
                  "type": "user",
                  "login": "UserA"
                }
              }
            ]
          }
        ],
        "approvers": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ],
        "recurrenceConfiguration": {
          "activated": true,
          "days": 0,
          "weeks": 0,
          "months": 6,
          "years": 0,
          "reloadConf": false
        }
      },
      "status": "NOT_STARTED",
      "statusDate": "2022-09-02T18:26:03.748+02:00",
      "feedbackResponses": [
        {
          "id": "abcdef12345",
          "groupId": "groupA",
          "user": "userA",
          "status": "APPROVED",
          "creationDate": "2022-09-02T18:26:03.748+02:00",
          "editionDate": "2022-09-02T18:26:03.748+02:00",
          "comment": "comment"
        }
      ],
      "approverResponse": {
        "user": "userA",
        "status": "APPROVED",
        "creationDate": "2022-09-02T18:26:03.748+02:00",
        "editionDate": "2022-09-02T18:26:03.748+02:00",
        "comment": "comment"
      }
    }
  ],
  "uiArtifactDetails": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "artifact": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the related blueprint version"
        },
        "status": {
          "type": "object",
          "properties": {
            "archived": {
              "type": "boolean"
            },
            "stepId": {
              "type": [
                "string",
                "null"
              ],
              "description": "Current active workflow step of the artifact"
            }
          },
          "description": "Status of the artifact"
        },
        "name": {
          "type": "string",
          "description": "Name of the artifact"
        },
        "fields": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Map with the values of the fields"
        },
        "attachments": {
          "type": "object",
          "properties": {},
          "description": "Attachments of the artifact"
        },
        "id": {
          "type": "string",
          "description": "ID of the artifact"
        }
      },
      "description": "The artifact content"
    },
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "The related blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "The related blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffs": {
      "type": [
        "array",
        "null"
      ],
      "description": "List of the sign-offs"
    },
    "uiArtifactDetails": {
      "type": "object",
      "properties": {},
      "description": "Various details about this artifact"
    }
  },
  "definitions": {
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Search artifact
POST/artifacts/search

Search for artifacts. Use the parameter artifactFilters to specify a list of filter to apply on the query. Use the parameter artifactSearchSort to apply a sort on the results of the query. For example search artifacts which name contains a specific string. Use the parameter artifactSearchPagination to paginate the results.

Example URI

POST /artifacts/search
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "artifactSearchSource": {
    "type": "all"
  },
  "artifactFilters": [
    {
      "type": "blueprints",
      "blueprintIds": [
        "bp.system.govern_project"
      ]
    },
    {
      "type": "blueprintVersions",
      "blueprintVersionIds": [
        {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        }
      ]
    },
    {
      "type": "artifacts",
      "artifactIds": [
        "ar.54"
      ]
    },
    {
      "type": "field",
      "conditionType": "EQUALS",
      "condition": "name1",
      "fieldId": "field1",
      "negateCondition": false,
      "caseSensitive": false
    },
    {
      "type": "archived",
      "isArchived": true
    }
  ],
  "artifactSearchSort": {
    "column": {
      "type": "name"
    },
    "direction": "ASC"
  },
  "artifactSearchPagination": {
    "lastArtifactID": "ar.86",
    "pageSize": 20
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "artifactSearchSource": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "all"
          ],
          "description": "Type of the search source, for now, only the `all` search source is permitted and targets all artifacts."
        }
      },
      "description": "A base search source for the query"
    },
    "artifactFilters": {
      "type": "array",
      "description": "The list of filters to apply on the query"
    },
    "artifactSearchSort": {
      "type": "object",
      "properties": {
        "direction": {
          "type": "string",
          "enum": [
            "ASC",
            "DESC"
          ],
          "description": "The direction of the sort, default is 'ASC'"
        }
      },
      "oneOf": [
        {
          "properties": {
            "column": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "name"
                  ]
                }
              },
              "required": [
                "type"
              ],
              "description": "Use this object to sort artifacts on their names"
            }
          }
        },
        {
          "properties": {
            "column": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "workflow"
                  ]
                }
              },
              "required": [
                "type"
              ],
              "description": "Use this object to sort artifact on their workflow"
            }
          }
        },
        {
          "properties": {
            "column": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "field"
                  ]
                },
                "fields": {
                  "type": "array",
                  "description": "An array of field on which the artifacts will be sorted."
                }
              },
              "required": [
                "type"
              ],
              "description": "Use this object to sort artifact on a list of fields"
            }
          }
        }
      ],
      "description": "A definition of the sort to apply on the results"
    },
    "artifactSearchPagination": {
      "type": "object",
      "properties": {
        "lastArtifactID": {
          "type": [
            "string",
            "null"
          ],
          "description": "The last artifact ID of the previous search. It can be used to get the new page of result starting from this artifact. Do not provide any for the first query."
        },
        "pageSize": {
          "type": "number",
          "description": "The size of the result page",
          "default": 20
        }
      },
      "description": "A definition of a pagination to perform on the results"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "hasNextPage": true,
  "uiArtifacts": [
    {
      "artifact": {
        "blueprintVersionId": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        },
        "status": {
          "archived": false,
          "stepId": "step1"
        },
        "name": "",
        "fields": {
          "field1": {},
          "field2": {}
        },
        "attachments": {},
        "id": "ar.54"
      },
      "blueprint": {
        "name": "blueprintName",
        "icon": "fiber_new",
        "color": "#494eba",
        "backgroundColor": "#000000",
        "id": "bp.control"
      },
      "blueprintVersion": {
        "name": "Version1",
        "fieldDefinitions": {},
        "workflowDefinition": {
          "stepDefinitions": [
            {
              "id": "step1",
              "name": "Step1"
            }
          ]
        },
        "logicalHookList": [],
        "hierarchicalParentFieldId": null,
        "uiDefinition": {
          "views": {
            "view1": {},
            "view2": {}
          },
          "uiStepDefinitions": {
            "step1": {
              "viewId": "view1"
            },
            "step2": {
              "viewId": "view1"
            }
          }
        },
        "instructions": "Instructions for this version",
        "id": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        }
      },
      "assignedRolesAndPermissionsCtx": {},
      "signoffs": [
        {
          "signoffId": {
            "artifactId": "ar.57",
            "stepId": "step1"
          },
          "cycleIndex": 0,
          "configuration": {
            "id": {
              "blueprintVersionId": {
                "blueprintId": "bp.control",
                "versionId": "bv.v1"
              },
              "stepId": "step1"
            },
            "title": "title",
            "description": "description",
            "mandatory": true,
            "feedbackUsersGroups": [
              {
                "id": "group1",
                "title": "Group 1",
                "users": [
                  {
                    "addedBy": "admin",
                    "addedOn": "2021-09-02T18:26:03.748+02:00",
                    "delegated": false,
                    "userContainer": {
                      "type": "user",
                      "login": "UserA"
                    }
                  }
                ]
              }
            ],
            "approvers": [
              {
                "addedBy": "admin",
                "addedOn": "2021-09-02T18:26:03.748+02:00",
                "delegated": false,
                "userContainer": {
                  "type": "user",
                  "login": "UserA"
                }
              }
            ],
            "recurrenceConfiguration": {
              "activated": true,
              "days": 0,
              "weeks": 0,
              "months": 6,
              "years": 0,
              "reloadConf": false
            }
          },
          "status": "NOT_STARTED",
          "statusDate": "2022-09-02T18:26:03.748+02:00",
          "feedbackResponses": [
            {
              "id": "abcdef12345",
              "groupId": "groupA",
              "user": "userA",
              "status": "APPROVED",
              "creationDate": "2022-09-02T18:26:03.748+02:00",
              "editionDate": "2022-09-02T18:26:03.748+02:00",
              "comment": "comment"
            }
          ],
          "approverResponse": {
            "user": "userA",
            "status": "APPROVED",
            "creationDate": "2022-09-02T18:26:03.748+02:00",
            "editionDate": "2022-09-02T18:26:03.748+02:00",
            "comment": "comment"
          }
        }
      ],
      "uiArtifactDetails": {}
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "hasNextPage": {
      "type": "boolean",
      "description": "A boolean to indicate the presence of a next result page"
    },
    "uiArtifacts": {
      "type": "array",
      "description": "The result list"
    }
  }
}

Artifact

Get artifact
GET/artifact/{artifactId}

Gets a specific artifact

Example URI

GET /artifact/ar.54
URI Parameters
HideShow
artifactId
string (required) Example: ar.54

the ID of the artifact

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "artifact": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": {
      "archived": false,
      "stepId": "step1"
    },
    "name": "",
    "fields": {
      "field1": {},
      "field2": {}
    },
    "attachments": {},
    "id": "ar.54"
  },
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffs": [
    {
      "signoffId": {
        "artifactId": "ar.57",
        "stepId": "step1"
      },
      "cycleIndex": 0,
      "configuration": {
        "id": {
          "blueprintVersionId": {
            "blueprintId": "bp.control",
            "versionId": "bv.v1"
          },
          "stepId": "step1"
        },
        "title": "title",
        "description": "description",
        "mandatory": true,
        "feedbackUsersGroups": [
          {
            "id": "group1",
            "title": "Group 1",
            "users": [
              {
                "addedBy": "admin",
                "addedOn": "2021-09-02T18:26:03.748+02:00",
                "delegated": false,
                "userContainer": {
                  "type": "user",
                  "login": "UserA"
                }
              }
            ]
          }
        ],
        "approvers": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ],
        "recurrenceConfiguration": {
          "activated": true,
          "days": 0,
          "weeks": 0,
          "months": 6,
          "years": 0,
          "reloadConf": false
        }
      },
      "status": "NOT_STARTED",
      "statusDate": "2022-09-02T18:26:03.748+02:00",
      "feedbackResponses": [
        {
          "id": "abcdef12345",
          "groupId": "groupA",
          "user": "userA",
          "status": "APPROVED",
          "creationDate": "2022-09-02T18:26:03.748+02:00",
          "editionDate": "2022-09-02T18:26:03.748+02:00",
          "comment": "comment"
        }
      ],
      "approverResponse": {
        "user": "userA",
        "status": "APPROVED",
        "creationDate": "2022-09-02T18:26:03.748+02:00",
        "editionDate": "2022-09-02T18:26:03.748+02:00",
        "comment": "comment"
      }
    }
  ],
  "uiArtifactDetails": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "artifact": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the related blueprint version"
        },
        "status": {
          "type": "object",
          "properties": {
            "archived": {
              "type": "boolean"
            },
            "stepId": {
              "type": [
                "string",
                "null"
              ],
              "description": "Current active workflow step of the artifact"
            }
          },
          "description": "Status of the artifact"
        },
        "name": {
          "type": "string",
          "description": "Name of the artifact"
        },
        "fields": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Map with the values of the fields"
        },
        "attachments": {
          "type": "object",
          "properties": {},
          "description": "Attachments of the artifact"
        },
        "id": {
          "type": "string",
          "description": "ID of the artifact"
        }
      },
      "description": "The artifact content"
    },
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "The related blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "The related blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffs": {
      "type": [
        "array",
        "null"
      ],
      "description": "List of the sign-offs"
    },
    "uiArtifactDetails": {
      "type": "object",
      "properties": {},
      "description": "Various details about this artifact"
    }
  },
  "definitions": {
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Save artifact
PUT/artifact/{artifactId}

Saves an artifact

Example URI

PUT /artifact/ar.56
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

the ID of the artifact

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintVersionId": {
    "blueprintId": "bp.control",
    "versionId": "bv.v1"
  },
  "status": {
    "archived": false,
    "stepId": "step1"
  },
  "name": "",
  "fields": {
    "field1": {},
    "field2": {}
  },
  "attachments": {},
  "id": "ar.54"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintVersionId": {
      "type": "object",
      "properties": {
        "blueprintId": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.'"
        },
        "versionId": {
          "type": "string",
          "description": "ID of the version, starts with 'bv.'"
        }
      },
      "description": "ID of the related blueprint version"
    },
    "status": {
      "type": "object",
      "properties": {
        "archived": {
          "type": "boolean"
        },
        "stepId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Current active workflow step of the artifact"
        }
      },
      "description": "Status of the artifact"
    },
    "name": {
      "type": "string",
      "description": "Name of the artifact"
    },
    "fields": {
      "allOf": [
        {
          "$ref": "#/definitions/field1"
        },
        {
          "$ref": "#/definitions/field2"
        }
      ],
      "description": "Map with the values of the fields"
    },
    "attachments": {
      "type": "object",
      "properties": {},
      "description": "Attachments of the artifact"
    },
    "id": {
      "type": "string",
      "description": "ID of the artifact"
    }
  },
  "definitions": {
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "artifact": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": {
      "archived": false,
      "stepId": "step1"
    },
    "name": "",
    "fields": {
      "field1": {},
      "field2": {}
    },
    "attachments": {},
    "id": "ar.54"
  },
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffs": [
    {
      "signoffId": {
        "artifactId": "ar.57",
        "stepId": "step1"
      },
      "cycleIndex": 0,
      "configuration": {
        "id": {
          "blueprintVersionId": {
            "blueprintId": "bp.control",
            "versionId": "bv.v1"
          },
          "stepId": "step1"
        },
        "title": "title",
        "description": "description",
        "mandatory": true,
        "feedbackUsersGroups": [
          {
            "id": "group1",
            "title": "Group 1",
            "users": [
              {
                "addedBy": "admin",
                "addedOn": "2021-09-02T18:26:03.748+02:00",
                "delegated": false,
                "userContainer": {
                  "type": "user",
                  "login": "UserA"
                }
              }
            ]
          }
        ],
        "approvers": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ],
        "recurrenceConfiguration": {
          "activated": true,
          "days": 0,
          "weeks": 0,
          "months": 6,
          "years": 0,
          "reloadConf": false
        }
      },
      "status": "NOT_STARTED",
      "statusDate": "2022-09-02T18:26:03.748+02:00",
      "feedbackResponses": [
        {
          "id": "abcdef12345",
          "groupId": "groupA",
          "user": "userA",
          "status": "APPROVED",
          "creationDate": "2022-09-02T18:26:03.748+02:00",
          "editionDate": "2022-09-02T18:26:03.748+02:00",
          "comment": "comment"
        }
      ],
      "approverResponse": {
        "user": "userA",
        "status": "APPROVED",
        "creationDate": "2022-09-02T18:26:03.748+02:00",
        "editionDate": "2022-09-02T18:26:03.748+02:00",
        "comment": "comment"
      }
    }
  ],
  "uiArtifactDetails": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "artifact": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the related blueprint version"
        },
        "status": {
          "type": "object",
          "properties": {
            "archived": {
              "type": "boolean"
            },
            "stepId": {
              "type": [
                "string",
                "null"
              ],
              "description": "Current active workflow step of the artifact"
            }
          },
          "description": "Status of the artifact"
        },
        "name": {
          "type": "string",
          "description": "Name of the artifact"
        },
        "fields": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Map with the values of the fields"
        },
        "attachments": {
          "type": "object",
          "properties": {},
          "description": "Attachments of the artifact"
        },
        "id": {
          "type": "string",
          "description": "ID of the artifact"
        }
      },
      "description": "The artifact content"
    },
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "The related blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "The related blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffs": {
      "type": [
        "array",
        "null"
      ],
      "description": "List of the sign-offs"
    },
    "uiArtifactDetails": {
      "type": "object",
      "properties": {},
      "description": "Various details about this artifact"
    }
  },
  "definitions": {
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Delete artifact
DELETE/artifact/{artifactId}

Deletes an artifact.

Example URI

DELETE /artifact/ar.56
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

the ID of the artifact

Response  200

Sign-offs

List sign-offs
GET/artifact/{artifactId}/signoffs

Lists the sign-offs for a given artifact

Example URI

GET /artifact/ar.56/signoffs
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "signoffId": {
      "artifactId": "ar.57",
      "stepId": "step1"
    },
    "cycleIndex": 0,
    "configuration": {
      "id": {
        "blueprintVersionId": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        },
        "stepId": "step1"
      },
      "title": "title",
      "description": "description",
      "mandatory": true,
      "feedbackUsersGroups": [
        {
          "id": "group1",
          "title": "Group 1",
          "users": [
            {
              "addedBy": "admin",
              "addedOn": "2021-09-02T18:26:03.748+02:00",
              "delegated": false,
              "userContainer": {
                "type": "user",
                "login": "UserA"
              }
            }
          ]
        }
      ],
      "approvers": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ],
      "recurrenceConfiguration": {
        "activated": true,
        "days": 0,
        "weeks": 0,
        "months": 6,
        "years": 0,
        "reloadConf": false
      }
    },
    "status": "NOT_STARTED",
    "statusDate": "2022-09-02T18:26:03.748+02:00",
    "feedbackResponses": [
      {
        "id": "abcdef12345",
        "groupId": "groupA",
        "user": "userA",
        "status": "APPROVED",
        "creationDate": "2022-09-02T18:26:03.748+02:00",
        "editionDate": "2022-09-02T18:26:03.748+02:00",
        "comment": "comment"
      }
    ],
    "approverResponse": {
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Sign-off

Get sign-off
GET/artifact/{artifactId}/workflow/step/{stepId}/signoff

Gets a sign-off for a given artifact and a specific step

Example URI

GET /artifact/ar.56/workflow/step/step1/signoff
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "signoffId": {
    "artifactId": "ar.57",
    "stepId": "step1"
  },
  "cycleIndex": 0,
  "configuration": {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  },
  "status": "NOT_STARTED",
  "statusDate": "2022-09-02T18:26:03.748+02:00",
  "feedbackResponses": [
    {
      "id": "abcdef12345",
      "groupId": "groupA",
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  ],
  "approverResponse": {
    "user": "userA",
    "status": "APPROVED",
    "creationDate": "2022-09-02T18:26:03.748+02:00",
    "editionDate": "2022-09-02T18:26:03.748+02:00",
    "comment": "comment"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "signoffId": {
      "type": "object",
      "properties": {
        "artifactId": {
          "type": "string",
          "description": "ID of the artifact"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "ID of the sign-off"
    },
    "cycleIndex": {
      "type": "number",
      "description": "Incremented each time a sign-off is reset, start at 0"
    },
    "configuration": {
      "type": "object",
      "properties": {
        "id": {
          "type": "object",
          "properties": {
            "blueprintVersionId": {
              "type": "object",
              "properties": {
                "blueprintId": {
                  "type": "string",
                  "description": "ID of the blueprint, starts with 'bp.'"
                },
                "versionId": {
                  "type": "string",
                  "description": "ID of the version, starts with 'bv.'"
                }
              },
              "description": "The related ID of the blueprint version"
            },
            "stepId": {
              "type": "string",
              "description": "ID of the step"
            }
          },
          "description": "The ID of the configuration of the sign-off"
        },
        "title": {
          "type": "string",
          "description": "Title of the configuration"
        },
        "description": {
          "type": "string",
          "description": "Description of the configuration"
        },
        "mandatory": {
          "type": "boolean",
          "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
        },
        "feedbackUsersGroups": {
          "type": "array",
          "description": "A list of groups of users able to give feedback on this sign-off"
        },
        "approvers": {
          "type": "array",
          "description": "A list of users able to give an approval on this sign-off"
        },
        "recurrenceConfiguration": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "activated": {
              "type": "boolean",
              "description": "Activate the reset recurrence"
            },
            "days": {
              "type": "number",
              "description": "number of days to wait"
            },
            "weeks": {
              "type": "number",
              "description": "number of weeks to wait"
            },
            "months": {
              "type": "number",
              "description": "number of months to wait"
            },
            "years": {
              "type": "number",
              "description": "number of years to wait"
            },
            "reloadConf": {
              "type": "boolean",
              "description": "on reset, reload or not the signoff configuration from the blueprint version"
            }
          },
          "description": "The recurrence configuration of this sign-off"
        }
      },
      "description": "Configuration of this sign-off"
    },
    "status": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "statusDate": {
      "type": "string",
      "description": "Last status change date"
    },
    "feedbackResponses": {
      "type": "array",
      "description": "List of the feedback reviews"
    },
    "approverResponse": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "user": {
          "type": "string",
          "description": "Login of the user who made the approval"
        },
        "status": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED",
            "ABANDONED"
          ],
          "description": "Status of the approval"
        },
        "creationDate": {
          "type": "string",
          "description": "Creation date of the approval"
        },
        "editionDate": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last approval edition date"
        },
        "comment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comment from the user"
        }
      },
      "description": "Response from the approver"
    }
  }
}

Get sign-off details
GET/artifact/{artifactId}/workflow/step/{stepId}/signoff/details

Gets sign-off details for a given artifact and a specific step. The details include information about the feedback groups and approval users

Example URI

GET /artifact/ar.56/workflow/step/step1/signoff/details
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "feedbackGroups": [
    {
      "id": "group1",
      "usersRelations": [
        {
          "user": {
            "type": "user",
            "login": "UserA"
          },
          "grantedBy": [
            {
              "type": "user",
              "login": "UserA"
            }
          ]
        }
      ]
    }
  ],
  "approvalUsersRelations": [
    {
      "user": {
        "type": "user",
        "login": "UserA"
      },
      "grantedBy": [
        {
          "type": "user",
          "login": "UserA"
        }
      ]
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "feedbackGroups": {
      "type": "array",
      "description": "The details of the users and global API keys in the feedback groups"
    },
    "approvalUsersRelations": {
      "type": "array",
      "description": "The details of the users and global API Keys in charge of the approval"
    }
  }
}

Update status
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/update-status

Change the status of the sign-off, takes as input the target status and optionally a list of users to notify. Only the users included in the groups of feedback and approval are able to give feedback or approval and can be notified, the complete list is available using: Get sign-off details For the feedback, the users will be notified as part of a chosen group of feedback and the group must be specified.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/update-status
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "targetStatus": "NOT_STARTED",
  "usersToSendEmailTo": [
    {
      "userLogin": "UserA",
      "groupId": "GroupA"
    }
  ],
  "reloadConfForReset": false
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "targetStatus": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "usersToSendEmailTo": {
      "type": "array",
      "description": "The users that will be notified of the status change"
    },
    "reloadConfForReset": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Defaults to false. On reset, reload or not the signoff configuration from the blueprint version"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "signoffId": {
    "artifactId": "ar.57",
    "stepId": "step1"
  },
  "cycleIndex": 0,
  "configuration": {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  },
  "status": "NOT_STARTED",
  "statusDate": "2022-09-02T18:26:03.748+02:00",
  "feedbackResponses": [
    {
      "id": "abcdef12345",
      "groupId": "groupA",
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  ],
  "approverResponse": {
    "user": "userA",
    "status": "APPROVED",
    "creationDate": "2022-09-02T18:26:03.748+02:00",
    "editionDate": "2022-09-02T18:26:03.748+02:00",
    "comment": "comment"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "signoffId": {
      "type": "object",
      "properties": {
        "artifactId": {
          "type": "string",
          "description": "ID of the artifact"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "ID of the sign-off"
    },
    "cycleIndex": {
      "type": "number",
      "description": "Incremented each time a sign-off is reset, start at 0"
    },
    "configuration": {
      "type": "object",
      "properties": {
        "id": {
          "type": "object",
          "properties": {
            "blueprintVersionId": {
              "type": "object",
              "properties": {
                "blueprintId": {
                  "type": "string",
                  "description": "ID of the blueprint, starts with 'bp.'"
                },
                "versionId": {
                  "type": "string",
                  "description": "ID of the version, starts with 'bv.'"
                }
              },
              "description": "The related ID of the blueprint version"
            },
            "stepId": {
              "type": "string",
              "description": "ID of the step"
            }
          },
          "description": "The ID of the configuration of the sign-off"
        },
        "title": {
          "type": "string",
          "description": "Title of the configuration"
        },
        "description": {
          "type": "string",
          "description": "Description of the configuration"
        },
        "mandatory": {
          "type": "boolean",
          "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
        },
        "feedbackUsersGroups": {
          "type": "array",
          "description": "A list of groups of users able to give feedback on this sign-off"
        },
        "approvers": {
          "type": "array",
          "description": "A list of users able to give an approval on this sign-off"
        },
        "recurrenceConfiguration": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "activated": {
              "type": "boolean",
              "description": "Activate the reset recurrence"
            },
            "days": {
              "type": "number",
              "description": "number of days to wait"
            },
            "weeks": {
              "type": "number",
              "description": "number of weeks to wait"
            },
            "months": {
              "type": "number",
              "description": "number of months to wait"
            },
            "years": {
              "type": "number",
              "description": "number of years to wait"
            },
            "reloadConf": {
              "type": "boolean",
              "description": "on reset, reload or not the signoff configuration from the blueprint version"
            }
          },
          "description": "The recurrence configuration of this sign-off"
        }
      },
      "description": "Configuration of this sign-off"
    },
    "status": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "statusDate": {
      "type": "string",
      "description": "Last status change date"
    },
    "feedbackResponses": {
      "type": "array",
      "description": "List of the feedback reviews"
    },
    "approverResponse": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "user": {
          "type": "string",
          "description": "Login of the user who made the approval"
        },
        "status": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED",
            "ABANDONED"
          ],
          "description": "Status of the approval"
        },
        "creationDate": {
          "type": "string",
          "description": "Creation date of the approval"
        },
        "editionDate": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last approval edition date"
        },
        "comment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comment from the user"
        }
      },
      "description": "Response from the approver"
    }
  }
}

Add feedback
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/feedback{?groupId}

Add a feedback for a specific feedback group. Takes as input a stepId, a groupId (the feedback group ID), a feedback status and an optional comment.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/feedback?groupId=group1
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

groupId
string (required) Example: group1

The feedback group ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "status": "APPROVED",
  "commment": "Correct"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "MINOR_ISSUE",
        "MAJOR_ISSUE"
      ],
      "description": "Status of the feedback review"
    },
    "commment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Related comment"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": "abcdef12345",
  "groupId": "groupA",
  "user": "userA",
  "status": "APPROVED",
  "creationDate": "2022-09-02T18:26:03.748+02:00",
  "editionDate": "2022-09-02T18:26:03.748+02:00",
  "comment": "comment"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "1111-2222-aaaa-bbbb (string) - ID of the feedback review"
    },
    "groupId": {
      "type": "string",
      "description": "ID of the group"
    },
    "user": {
      "type": "string",
      "description": "ID of the user"
    },
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "MINOR_ISSUE",
        "MAJOR_ISSUE"
      ],
      "description": "Status of the feedback review"
    },
    "creationDate": {
      "type": "string",
      "description": "Creation date of the feedback review"
    },
    "editionDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last feedback review edition date"
    },
    "comment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Comment from the user"
    }
  }
}

Edit feedback
PUT/artifact/{artifactId}/workflow/step/{stepId}/signoff/feedback/{feedbackId}

Edit a previously added feedback. Takes as input a stepId, a feedbackId, a feedback status and an optional comment.

Example URI

PUT /artifact/ar.56/workflow/step/step1/signoff/feedback/abcdef12345-1111-2222-aaaa-bbbb
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

feedbackId
string (required) Example: abcdef12345-1111-2222-aaaa-bbbb

The feedback ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "status": "APPROVED",
  "commment": "Correct"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "MINOR_ISSUE",
        "MAJOR_ISSUE"
      ],
      "description": "Status of the feedback review"
    },
    "commment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Related comment"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": "abcdef12345",
  "groupId": "groupA",
  "user": "userA",
  "status": "APPROVED",
  "creationDate": "2022-09-02T18:26:03.748+02:00",
  "editionDate": "2022-09-02T18:26:03.748+02:00",
  "comment": "comment"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "1111-2222-aaaa-bbbb (string) - ID of the feedback review"
    },
    "groupId": {
      "type": "string",
      "description": "ID of the group"
    },
    "user": {
      "type": "string",
      "description": "ID of the user"
    },
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "MINOR_ISSUE",
        "MAJOR_ISSUE"
      ],
      "description": "Status of the feedback review"
    },
    "creationDate": {
      "type": "string",
      "description": "Creation date of the feedback review"
    },
    "editionDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last feedback review edition date"
    },
    "comment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Comment from the user"
    }
  }
}

Delete feedback
DELETE/artifact/{artifactId}/workflow/step/{stepId}/signoff/feedback/{feedbackId}

Delete a previously added feedback. Takes as input a stepId and a feedbackId.

Example URI

DELETE /artifact/ar.56/workflow/step/step1/signoff/feedback/abcdef12345-1111-2222-aaaa-bbbb
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

feedbackId
string (required) Example: abcdef12345-1111-2222-aaaa-bbbb

The feedback ID

Response  200

Delegate feedback
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/delegate-feedback{?groupId}

Delegate a feedback to a specific user. Takes as input a groupId (the feedback group to target), and a users container definition to delegate to.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/delegate-feedback?groupId=group1
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

groupId
string (required) Example: group1

The feedback group ID to target

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "type": "user",
  "login": "UserA"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "user"
      ],
      "description": "The type of the user container"
    },
    "login": {
      "type": "string",
      "description": "The login of the user"
    }
  },
  "required": [
    "type"
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "signoffId": {
    "artifactId": "ar.57",
    "stepId": "step1"
  },
  "cycleIndex": 0,
  "configuration": {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  },
  "status": "NOT_STARTED",
  "statusDate": "2022-09-02T18:26:03.748+02:00",
  "feedbackResponses": [
    {
      "id": "abcdef12345",
      "groupId": "groupA",
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  ],
  "approverResponse": {
    "user": "userA",
    "status": "APPROVED",
    "creationDate": "2022-09-02T18:26:03.748+02:00",
    "editionDate": "2022-09-02T18:26:03.748+02:00",
    "comment": "comment"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "signoffId": {
      "type": "object",
      "properties": {
        "artifactId": {
          "type": "string",
          "description": "ID of the artifact"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "ID of the sign-off"
    },
    "cycleIndex": {
      "type": "number",
      "description": "Incremented each time a sign-off is reset, start at 0"
    },
    "configuration": {
      "type": "object",
      "properties": {
        "id": {
          "type": "object",
          "properties": {
            "blueprintVersionId": {
              "type": "object",
              "properties": {
                "blueprintId": {
                  "type": "string",
                  "description": "ID of the blueprint, starts with 'bp.'"
                },
                "versionId": {
                  "type": "string",
                  "description": "ID of the version, starts with 'bv.'"
                }
              },
              "description": "The related ID of the blueprint version"
            },
            "stepId": {
              "type": "string",
              "description": "ID of the step"
            }
          },
          "description": "The ID of the configuration of the sign-off"
        },
        "title": {
          "type": "string",
          "description": "Title of the configuration"
        },
        "description": {
          "type": "string",
          "description": "Description of the configuration"
        },
        "mandatory": {
          "type": "boolean",
          "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
        },
        "feedbackUsersGroups": {
          "type": "array",
          "description": "A list of groups of users able to give feedback on this sign-off"
        },
        "approvers": {
          "type": "array",
          "description": "A list of users able to give an approval on this sign-off"
        },
        "recurrenceConfiguration": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "activated": {
              "type": "boolean",
              "description": "Activate the reset recurrence"
            },
            "days": {
              "type": "number",
              "description": "number of days to wait"
            },
            "weeks": {
              "type": "number",
              "description": "number of weeks to wait"
            },
            "months": {
              "type": "number",
              "description": "number of months to wait"
            },
            "years": {
              "type": "number",
              "description": "number of years to wait"
            },
            "reloadConf": {
              "type": "boolean",
              "description": "on reset, reload or not the signoff configuration from the blueprint version"
            }
          },
          "description": "The recurrence configuration of this sign-off"
        }
      },
      "description": "Configuration of this sign-off"
    },
    "status": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "statusDate": {
      "type": "string",
      "description": "Last status change date"
    },
    "feedbackResponses": {
      "type": "array",
      "description": "List of the feedback reviews"
    },
    "approverResponse": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "user": {
          "type": "string",
          "description": "Login of the user who made the approval"
        },
        "status": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED",
            "ABANDONED"
          ],
          "description": "Status of the approval"
        },
        "creationDate": {
          "type": "string",
          "description": "Creation date of the approval"
        },
        "editionDate": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last approval edition date"
        },
        "comment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comment from the user"
        }
      },
      "description": "Response from the approver"
    }
  }
}

Add approval
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/approval

Add the final approval. Takes as input a stepId, an approval status and an optional comment.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/approval
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "status": "APPROVED",
  "commment": "Correct"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the approval"
    },
    "commment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Related comment"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "user": "userA",
  "status": "APPROVED",
  "creationDate": "2022-09-02T18:26:03.748+02:00",
  "editionDate": "2022-09-02T18:26:03.748+02:00",
  "comment": "comment"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "Login of the user who made the approval"
    },
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the approval"
    },
    "creationDate": {
      "type": "string",
      "description": "Creation date of the approval"
    },
    "editionDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last approval edition date"
    },
    "comment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Comment from the user"
    }
  }
}

Edit approval
PUT/artifact/{artifactId}/workflow/step/{stepId}/signoff/approval

Edit the final approval. Takes as input a stepId, an approval status and an optional comment.

Example URI

PUT /artifact/ar.56/workflow/step/step1/signoff/approval
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "status": "APPROVED",
  "commment": "Correct"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the approval"
    },
    "commment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Related comment"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "user": "userA",
  "status": "APPROVED",
  "creationDate": "2022-09-02T18:26:03.748+02:00",
  "editionDate": "2022-09-02T18:26:03.748+02:00",
  "comment": "comment"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "Login of the user who made the approval"
    },
    "status": {
      "type": "string",
      "enum": [
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the approval"
    },
    "creationDate": {
      "type": "string",
      "description": "Creation date of the approval"
    },
    "editionDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last approval edition date"
    },
    "comment": {
      "type": [
        "string",
        "null"
      ],
      "description": "Comment from the user"
    }
  }
}

Delete approval
DELETE/artifact/{artifactId}/workflow/step/{stepId}/signoff/approval

Delete the final approval. Takes as input a stepId.

Example URI

DELETE /artifact/ar.56/workflow/step/step1/signoff/approval
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Response  200

Delegate approval
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/delegate-approval

Delegate the approval to a specific user. Takes as input a users container definition to delegate to.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/delegate-approval
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "type": "user",
  "login": "UserA"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "user"
      ],
      "description": "The type of the user container"
    },
    "login": {
      "type": "string",
      "description": "The login of the user"
    }
  },
  "required": [
    "type"
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "signoffId": {
    "artifactId": "ar.57",
    "stepId": "step1"
  },
  "cycleIndex": 0,
  "configuration": {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  },
  "status": "NOT_STARTED",
  "statusDate": "2022-09-02T18:26:03.748+02:00",
  "feedbackResponses": [
    {
      "id": "abcdef12345",
      "groupId": "groupA",
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  ],
  "approverResponse": {
    "user": "userA",
    "status": "APPROVED",
    "creationDate": "2022-09-02T18:26:03.748+02:00",
    "editionDate": "2022-09-02T18:26:03.748+02:00",
    "comment": "comment"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "signoffId": {
      "type": "object",
      "properties": {
        "artifactId": {
          "type": "string",
          "description": "ID of the artifact"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "ID of the sign-off"
    },
    "cycleIndex": {
      "type": "number",
      "description": "Incremented each time a sign-off is reset, start at 0"
    },
    "configuration": {
      "type": "object",
      "properties": {
        "id": {
          "type": "object",
          "properties": {
            "blueprintVersionId": {
              "type": "object",
              "properties": {
                "blueprintId": {
                  "type": "string",
                  "description": "ID of the blueprint, starts with 'bp.'"
                },
                "versionId": {
                  "type": "string",
                  "description": "ID of the version, starts with 'bv.'"
                }
              },
              "description": "The related ID of the blueprint version"
            },
            "stepId": {
              "type": "string",
              "description": "ID of the step"
            }
          },
          "description": "The ID of the configuration of the sign-off"
        },
        "title": {
          "type": "string",
          "description": "Title of the configuration"
        },
        "description": {
          "type": "string",
          "description": "Description of the configuration"
        },
        "mandatory": {
          "type": "boolean",
          "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
        },
        "feedbackUsersGroups": {
          "type": "array",
          "description": "A list of groups of users able to give feedback on this sign-off"
        },
        "approvers": {
          "type": "array",
          "description": "A list of users able to give an approval on this sign-off"
        },
        "recurrenceConfiguration": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "activated": {
              "type": "boolean",
              "description": "Activate the reset recurrence"
            },
            "days": {
              "type": "number",
              "description": "number of days to wait"
            },
            "weeks": {
              "type": "number",
              "description": "number of weeks to wait"
            },
            "months": {
              "type": "number",
              "description": "number of months to wait"
            },
            "years": {
              "type": "number",
              "description": "number of years to wait"
            },
            "reloadConf": {
              "type": "boolean",
              "description": "on reset, reload or not the signoff configuration from the blueprint version"
            }
          },
          "description": "The recurrence configuration of this sign-off"
        }
      },
      "description": "Configuration of this sign-off"
    },
    "status": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "statusDate": {
      "type": "string",
      "description": "Last status change date"
    },
    "feedbackResponses": {
      "type": "array",
      "description": "List of the feedback reviews"
    },
    "approverResponse": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "user": {
          "type": "string",
          "description": "Login of the user who made the approval"
        },
        "status": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED",
            "ABANDONED"
          ],
          "description": "Status of the approval"
        },
        "creationDate": {
          "type": "string",
          "description": "Creation date of the approval"
        },
        "editionDate": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last approval edition date"
        },
        "comment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comment from the user"
        }
      },
      "description": "Response from the approver"
    }
  }
}

Schedule reset
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/schedule-reset

Update the schedule reset configuration for a given sign-off.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/schedule-reset
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "activated": true,
  "days": 0,
  "weeks": 0,
  "months": 6,
  "years": 0,
  "reloadConf": false
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "activated": {
      "type": "boolean",
      "description": "Activate the reset recurrence"
    },
    "days": {
      "type": "number",
      "description": "number of days to wait"
    },
    "weeks": {
      "type": "number",
      "description": "number of weeks to wait"
    },
    "months": {
      "type": "number",
      "description": "number of months to wait"
    },
    "years": {
      "type": "number",
      "description": "number of years to wait"
    },
    "reloadConf": {
      "type": "boolean",
      "description": "on reset, reload or not the signoff configuration from the blueprint version"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "signoffId": {
    "artifactId": "ar.57",
    "stepId": "step1"
  },
  "cycleIndex": 0,
  "configuration": {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  },
  "status": "NOT_STARTED",
  "statusDate": "2022-09-02T18:26:03.748+02:00",
  "feedbackResponses": [
    {
      "id": "abcdef12345",
      "groupId": "groupA",
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  ],
  "approverResponse": {
    "user": "userA",
    "status": "APPROVED",
    "creationDate": "2022-09-02T18:26:03.748+02:00",
    "editionDate": "2022-09-02T18:26:03.748+02:00",
    "comment": "comment"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "signoffId": {
      "type": "object",
      "properties": {
        "artifactId": {
          "type": "string",
          "description": "ID of the artifact"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "ID of the sign-off"
    },
    "cycleIndex": {
      "type": "number",
      "description": "Incremented each time a sign-off is reset, start at 0"
    },
    "configuration": {
      "type": "object",
      "properties": {
        "id": {
          "type": "object",
          "properties": {
            "blueprintVersionId": {
              "type": "object",
              "properties": {
                "blueprintId": {
                  "type": "string",
                  "description": "ID of the blueprint, starts with 'bp.'"
                },
                "versionId": {
                  "type": "string",
                  "description": "ID of the version, starts with 'bv.'"
                }
              },
              "description": "The related ID of the blueprint version"
            },
            "stepId": {
              "type": "string",
              "description": "ID of the step"
            }
          },
          "description": "The ID of the configuration of the sign-off"
        },
        "title": {
          "type": "string",
          "description": "Title of the configuration"
        },
        "description": {
          "type": "string",
          "description": "Description of the configuration"
        },
        "mandatory": {
          "type": "boolean",
          "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
        },
        "feedbackUsersGroups": {
          "type": "array",
          "description": "A list of groups of users able to give feedback on this sign-off"
        },
        "approvers": {
          "type": "array",
          "description": "A list of users able to give an approval on this sign-off"
        },
        "recurrenceConfiguration": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "activated": {
              "type": "boolean",
              "description": "Activate the reset recurrence"
            },
            "days": {
              "type": "number",
              "description": "number of days to wait"
            },
            "weeks": {
              "type": "number",
              "description": "number of weeks to wait"
            },
            "months": {
              "type": "number",
              "description": "number of months to wait"
            },
            "years": {
              "type": "number",
              "description": "number of years to wait"
            },
            "reloadConf": {
              "type": "boolean",
              "description": "on reset, reload or not the signoff configuration from the blueprint version"
            }
          },
          "description": "The recurrence configuration of this sign-off"
        }
      },
      "description": "Configuration of this sign-off"
    },
    "status": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "statusDate": {
      "type": "string",
      "description": "Last status change date"
    },
    "feedbackResponses": {
      "type": "array",
      "description": "List of the feedback reviews"
    },
    "approverResponse": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "user": {
          "type": "string",
          "description": "Login of the user who made the approval"
        },
        "status": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED",
            "ABANDONED"
          ],
          "description": "Status of the approval"
        },
        "creationDate": {
          "type": "string",
          "description": "Creation date of the approval"
        },
        "editionDate": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last approval edition date"
        },
        "comment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comment from the user"
        }
      },
      "description": "Response from the approver"
    }
  }
}

Create a signoff
POST/artifact/{artifactId}/workflow/step/{stepId}/signoff/create

Create a sign-off for this step. This call is useful only when the sign-off configuration has been added after the artifact creation. Otherwise, the sign-off is created automatically during the artifact creation. The step must be ongoing to create the sign-off.

Example URI

POST /artifact/ar.56/workflow/step/step1/signoff/create
URI Parameters
HideShow
artifactId
string (required) Example: ar.56

The artifact ID

stepId
string (required) Example: step1

The step ID

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "signoffId": {
    "artifactId": "ar.57",
    "stepId": "step1"
  },
  "cycleIndex": 0,
  "configuration": {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  },
  "status": "NOT_STARTED",
  "statusDate": "2022-09-02T18:26:03.748+02:00",
  "feedbackResponses": [
    {
      "id": "abcdef12345",
      "groupId": "groupA",
      "user": "userA",
      "status": "APPROVED",
      "creationDate": "2022-09-02T18:26:03.748+02:00",
      "editionDate": "2022-09-02T18:26:03.748+02:00",
      "comment": "comment"
    }
  ],
  "approverResponse": {
    "user": "userA",
    "status": "APPROVED",
    "creationDate": "2022-09-02T18:26:03.748+02:00",
    "editionDate": "2022-09-02T18:26:03.748+02:00",
    "comment": "comment"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "signoffId": {
      "type": "object",
      "properties": {
        "artifactId": {
          "type": "string",
          "description": "ID of the artifact"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "ID of the sign-off"
    },
    "cycleIndex": {
      "type": "number",
      "description": "Incremented each time a sign-off is reset, start at 0"
    },
    "configuration": {
      "type": "object",
      "properties": {
        "id": {
          "type": "object",
          "properties": {
            "blueprintVersionId": {
              "type": "object",
              "properties": {
                "blueprintId": {
                  "type": "string",
                  "description": "ID of the blueprint, starts with 'bp.'"
                },
                "versionId": {
                  "type": "string",
                  "description": "ID of the version, starts with 'bv.'"
                }
              },
              "description": "The related ID of the blueprint version"
            },
            "stepId": {
              "type": "string",
              "description": "ID of the step"
            }
          },
          "description": "The ID of the configuration of the sign-off"
        },
        "title": {
          "type": "string",
          "description": "Title of the configuration"
        },
        "description": {
          "type": "string",
          "description": "Description of the configuration"
        },
        "mandatory": {
          "type": "boolean",
          "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
        },
        "feedbackUsersGroups": {
          "type": "array",
          "description": "A list of groups of users able to give feedback on this sign-off"
        },
        "approvers": {
          "type": "array",
          "description": "A list of users able to give an approval on this sign-off"
        },
        "recurrenceConfiguration": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "activated": {
              "type": "boolean",
              "description": "Activate the reset recurrence"
            },
            "days": {
              "type": "number",
              "description": "number of days to wait"
            },
            "weeks": {
              "type": "number",
              "description": "number of weeks to wait"
            },
            "months": {
              "type": "number",
              "description": "number of months to wait"
            },
            "years": {
              "type": "number",
              "description": "number of years to wait"
            },
            "reloadConf": {
              "type": "boolean",
              "description": "on reset, reload or not the signoff configuration from the blueprint version"
            }
          },
          "description": "The recurrence configuration of this sign-off"
        }
      },
      "description": "Configuration of this sign-off"
    },
    "status": {
      "type": "string",
      "enum": [
        "NOT_STARTED",
        "WAITING_FOR_FEEDBACK",
        "WAITING_FOR_APPROVAL",
        "APPROVED",
        "REJECTED",
        "ABANDONED"
      ],
      "description": "Status of the sign-off"
    },
    "statusDate": {
      "type": "string",
      "description": "Last status change date"
    },
    "feedbackResponses": {
      "type": "array",
      "description": "List of the feedback reviews"
    },
    "approverResponse": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "user": {
          "type": "string",
          "description": "Login of the user who made the approval"
        },
        "status": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED",
            "ABANDONED"
          ],
          "description": "Status of the approval"
        },
        "creationDate": {
          "type": "string",
          "description": "Creation date of the approval"
        },
        "editionDate": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last approval edition date"
        },
        "comment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Comment from the user"
        }
      },
      "description": "Response from the approver"
    }
  }
}

Uploaded Files

Upload a file

Upload a file
POST/uploaded-files

Uploads a new file

Example URI

POST /uploaded-files
Request
HideShow
Headers
Content-Type: multipart
Body
file (Multipart file) - the file to upload
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": "uf.1",
  "name": "image.png",
  "type": "image/png"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the file"
    },
    "name": {
      "type": "string",
      "description": "The name of the file"
    },
    "type": {
      "type": "string",
      "description": "The type of the file"
    }
  },
  "required": [
    "id",
    "name",
    "type"
  ]
}

Uploaded file

Get uploaded file description
GET/uploaded-file/{uploadedFileId}

Gets an uploaded file description

Example URI

GET /uploaded-file/uf.1
URI Parameters
HideShow
uploadedFileId
string (required) Example: uf.1

the ID of the file

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": "uf.1",
  "name": "image.png",
  "type": "image/png"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the file"
    },
    "name": {
      "type": "string",
      "description": "The name of the file"
    },
    "type": {
      "type": "string",
      "description": "The type of the file"
    }
  },
  "required": [
    "id",
    "name",
    "type"
  ]
}

Download uploaded file
GET/uploaded-file/{uploadedFileId}/download

Downloads an uploaded file.

Example URI

GET /uploaded-file/uf.1/download
URI Parameters
HideShow
uploadedFileId
string (required) Example: uf.1

the ID of the file, starts with uf.

Response  200

Delete uploaded file
DELETE/uploaded-file/{uploadedFileId}

Deletes an uploaded file

Example URI

DELETE /uploaded-file/uf.1
URI Parameters
HideShow
uploadedFileId
string (required) Example: uf.1

the ID of the file

Response  200
HideShow
Headers
Content-Type: application/json

Time Series

Time series

Get time series
GET/time-series/{timeSeriesId}{?timestampMin,timestampMax}

Gets a specific time series, use the request attributes to retrieve values within a specific time window

Example URI

GET /time-series/ts.1?timestampMin=1663056878000&timestampMax=1993799888000
URI Parameters
HideShow
timeSeriesId
string (required) Example: ts.1

the ID of the time series

timestampMin
number (optional) Example: 1663056878000

The minimum timestamp of the time window as epoch in milliseconds

timestampMax
number (optional) Example: 1993799888000

The maximum timestamp of the time window as epoch in milliseconds

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "timeSeriesId": "ts.1",
    "timestamp": "1983799888000",
    "value": {}
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create time series
POST/time-series

Pushes data points to a new time series and return the created id. The datapoint array attribute is optional, if ommited the timeseries will be created without pushing any data to it.

Example URI

POST /time-series
Request
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "timeSeriesId": "ts.1",
    "timestamp": "1983799888000",
    "value": {}
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": "ts.42"
}

Push time series
PUT/time-series/{timeSeriesId}{?upsert}

Pushes data points to a time series

Example URI

PUT /time-series/ts.1?upsert=true
URI Parameters
HideShow
timeSeriesId
string (required) Example: ts.1

the ID of the time series

upsert
boolean (optional) Example: true

If set to true and that a value exist for this timestamp, it will be overridden.

  • Default true
Request
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "timeSeriesId": "ts.1",
    "timestamp": "1983799888000",
    "value": {}
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}
Response  200
HideShow
Headers
Content-Type: application/json

Delete time series
DELETE/time-series/{timeSeriesId}{?timestampMin,timestampMax}

Deletes values of a time series, use the request attributes to delete values within a specific time window. Deleting all values does not delete the time series object.

Example URI

DELETE /time-series/ts.1?timestampMin=1663056878000&timestampMax=1993799888000
URI Parameters
HideShow
timeSeriesId
string (required) Example: ts.1

the ID of the time series

timestampMin
number (optional) Example: 1663056878000

The minimum timestamp of the time window

timestampMax
number (optional) Example: 1993799888000

The maximum timestamp of the time window

Response  200
HideShow
Headers
Content-Type: application/json

Roles

List roles

List roles
GET/roles

Lists the roles.

Example URI

GET /roles
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "label": "Risk & Compliance reviewer",
    "description": "Can submit reviews as a Risk & Compliance expert",
    "id": "ro.risk_compliance_reviewer"
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Get role

Get role
GET/role/{roleId}

Gets a specific role

Example URI

GET /role/ro.reader
URI Parameters
HideShow
roleId
string (required) Example: ro.reader

the ID of the role

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "label": "Risk & Compliance reviewer",
  "description": "Can submit reviews as a Risk & Compliance expert",
  "id": "ro.risk_compliance_reviewer"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the role"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Description of the role"
    },
    "id": {
      "type": "string",
      "description": "ID of the role, starts with 'ro.'"
    }
  }
}

Custom Pages

List custom pages

List custom pages
GET/custom-pages

Lists the custom pages

Example URI

GET /custom-pages
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "index": 1,
    "name": "Custom Page 1",
    "icon": "fiber_new",
    "id": "cp.cp1"
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Get custom page

Get custom page
GET/custom-page/{customPageId}

Gets a specific custom page

Example URI

GET /custom-page/cp.cp1
URI Parameters
HideShow
customPageId
string (required) Example: cp.cp1

the ID of the custom page

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "index": 1,
  "name": "Custom Page 1",
  "icon": "fiber_new",
  "id": "cp.cp1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "index": {
      "type": "number",
      "description": "Index of the tab on which the custom will be displayed"
    },
    "name": {
      "type": "string",
      "description": "Name of the custom page"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the custom page"
    },
    "id": {
      "type": "string",
      "description": "ID of the custom page, starts with 'cp.'"
    }
  }
}

Security

Users

List users
GET/admin/users/

Retrieves the list of Govern users as a list of User objects as defined in GET user.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/users/
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "login": "UserA",
    "sourceType": "LOCAL",
    "displayName": "User A",
    "groups": [
      "administrators"
    ],
    "email": "Hello, world!",
    "userProfile": "DATA_SCIENTIST",
    "enabled": true
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create user
POST/admin/users

Adds a user account on Govern.


πŸ”’ Required privileges : Admin

Example URI

POST /admin/users
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "login": "UserA",
  "sourceType": "LOCAL",
  "displayName": "User A",
  "email": "",
  "groups": [],
  "userProfile": "DATA_ANALYST",
  "password": "password"
}
Response  201
HideShow
Body
{
  "msg": "Created user UserA"
}

User

Get user
GET/admin/users/{login}

Retrieves a User object describing a Govern user

WARNING : The returned object may contain other attributes but you should not rely on them since they could be modified or removed in future releases without notice.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/users/login
URI Parameters
HideShow
login
string (required) 

the login of a Govern user

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "login": "UserA",
  "sourceType": "LOCAL",
  "displayName": "User A",
  "groups": [
    "administrators"
  ],
  "email": "Hello, world!",
  "userProfile": "DATA_SCIENTIST",
  "enabled": true
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "login": {
      "type": "string",
      "description": "Login of the user"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "LOCAL",
        "LOCAL_NO_AUTH",
        "LDAP"
      ],
      "description": "Source type of the user"
    },
    "displayName": {
      "type": "string",
      "description": "Display name of the user"
    },
    "groups": {
      "type": "array",
      "description": "The groups of the user"
    },
    "email": {
      "type": "string",
      "description": "Email of the user"
    },
    "userProfile": {
      "type": "string",
      "description": "The profile of the user"
    },
    "enabled": {
      "type": "boolean"
    }
  }
}

Update user
PUT/admin/users/{login}

The User object given as body of the PUT call MUST have been previously obtained from a GET user call at the same URL.

The object obtained with the GET method may contain undocumented attributes. You should not modify them as it could create an invalid state and thoses attributes may be removed in future releases without notice.


πŸ”’ Required privileges : Admin

Example URI

PUT /admin/users/login
URI Parameters
HideShow
login
string (required) 

the login of a Govern user

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "login": "UserA",
  "sourceType": "LOCAL",
  "displayName": "User A",
  "groups": [
    "administrators"
  ],
  "email": "Hello, world!",
  "userProfile": "DATA_SCIENTIST",
  "enabled": true
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "login": {
      "type": "string",
      "description": "Login of the user"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "LOCAL",
        "LOCAL_NO_AUTH",
        "LDAP"
      ],
      "description": "Source type of the user"
    },
    "displayName": {
      "type": "string",
      "description": "Display name of the user"
    },
    "groups": {
      "type": "array",
      "description": "The groups of the user"
    },
    "email": {
      "type": "string",
      "description": "Email of the user"
    },
    "userProfile": {
      "type": "string",
      "description": "The profile of the user"
    },
    "enabled": {
      "type": "boolean"
    }
  }
}
Response  200
HideShow
Body
{
  "msg": "Edited user UserA"
}

Delete user
DELETE/admin/users/{login}

Deletes a Govern user


πŸ”’ Required privileges : Admin

Example URI

DELETE /admin/users/login
URI Parameters
HideShow
login
string (required) 

the login of a Govern user

Response  200
HideShow
Body
{
  "msg": "Deleted user UserA"
}

Resync a user
POST/admin/users/{login}/actions/resync

Resync the user

Returns a reference to a future, defined by its jobId. If the future has no result yet, polling on the jobId with GET task until the result is ready is needed to get the id of the generated flow documentation.


πŸ”’ Required privileges : Admin

Example URI

POST /admin/users/login/actions/resync
URI Parameters
HideShow
login
string (required) 

the login of a Govern user

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "hasResult": true,
  "aborted": false,
  "alive": false,
  "startTime": 0,
  "runningTime": 0,
  "unknown": false,
  "result": {
    "messages": [],
    "anyMessage": false,
    "success": false,
    "warning": false,
    "error": false,
    "fatal": false
  }
}

Resync multiple users
POST/admin/users/actions/resync-multi

Resyncs multiple users

Returns a reference to a future, defined by its jobId. If the future has no result yet, polling on the jobId with GET task until the result is ready is needed to get the id of the generated flow documentation.


πŸ”’ Required privileges : Admin

Example URI

POST /admin/users/actions/resync-multi
Request
HideShow
Headers
Content-Type: application/json
Body
[
  "user1",
  "user2",
  "user3"
]
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "hasResult": true,
  "aborted": false,
  "alive": false,
  "startTime": 0,
  "runningTime": 0,
  "unknown": false,
  "result": {
    "messages": [],
    "anyMessage": false,
    "success": false,
    "warning": false,
    "error": false,
    "fatal": false
  }
}

Fetch external users
GET/admin/users/actions/external-users

Fetches external users

Returns a reference to a future, defined by its jobId. If the future has no result yet, polling on the jobId with GET task until the result is ready is needed to get the id of the generated flow documentation.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/users/actions/external-users
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "hasResult": true,
  "aborted": false,
  "alive": false,
  "startTime": 1561456214289,
  "runningTime": 0,
  "unknown": false,
  "jobId": "26S2LeJw",
  "result": [
    {
      "status": "UNSYNCED",
      "userAttributes": {
        "login": "alice",
        "displayName": "Alice",
        "email": "[email protected]",
        "sourceGroupNames": [
          "externalGroupA"
        ],
        "dkuGroupNames": [
          "dssGroupA"
        ]
      },
      "profile": "READER"
    },
    {
      "status": "NOT_PROVISIONED",
      "userAttributes": {
        "login": "bob",
        "displayName": "Bob",
        "email": "[email protected]",
        "sourceGroupNames": [
          "externalGroupA"
        ],
        "dkuGroupNames": [
          "dssGroupA"
        ]
      },
      "profile": "READER"
    },
    {
      "status": "SYNCED",
      "userAttributes": {
        "login": "charlie",
        "displayName": "Charlie",
        "email": "[email protected]",
        "sourceGroupNames": [
          "externalGroupA"
        ],
        "dkuGroupNames": [
          "dssGroupA"
        ]
      },
      "profile": "READER"
    }
  ]
}

Fetch external groups
GET/admin/users/actions/external-groups

Fetches external groups

Returns a reference to a future, defined by its jobId. If the future has no result yet, polling on the jobId with GET task until the result is ready is needed to get the id of the generated flow documentation.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/users/actions/external-groups
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "hasResult": true,
  "aborted": false,
  "alive": false,
  "startTime": 1561456214289,
  "runningTime": 0,
  "unknown": false,
  "jobId": "26S2LeJw",
  "result": [
    "externalGroupA",
    "externalGroupB",
    "externalGroupC"
  ]
}

Provision users
POST/admin/users/actions/provision

Provisions users

Returns a reference to a future, defined by its jobId. If the future has no result yet, polling on the jobId with GET task until the result is ready is needed to get the id of the generated flow documentation.


πŸ”’ Required privileges : Admin

Example URI

POST /admin/users/actions/provision
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "userSourceType": "AZURE_AD",
  "users": [
    {
      "login": "bob",
      "displayName": "Bob",
      "email": "[email protected]",
      "sourceGroupNames": [
        "externalGroupA"
      ],
      "dkuGroupNames": [
        "dssGroupA"
      ]
    },
    {
      "login": "charlie",
      "displayName": "Charlie",
      "email": "[email protected]",
      "sourceGroupNames": [
        "externalGroupA"
      ],
      "dkuGroupNames": [
        "dssGroupA"
      ]
    }
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "hasResult": true,
  "aborted": false,
  "alive": false,
  "startTime": 0,
  "runningTime": 0,
  "unknown": false,
  "result": {
    "messages": [
      {
        "severity": "INFO",
        "isFatal": false,
        "code": "INFO_SECURITY_SUPPLIER_PROVISIONING_SUMMARY",
        "title": "User provisioning success",
        "details": "Imported 2/2 new users of source type 'AZURE_AD'",
        "message": "User provisioning success: Imported 2/2 new users of source type 'AZURE_AD'"
      }
    ],
    "maxSeverity": "INFO",
    "anyMessage": true,
    "success": false,
    "warning": false,
    "error": false,
    "fatal": false
  }
}

User last activity

Get all users last activity
GET/admin/users-activity

Get the last activity timestamps for all existing users


πŸ”’ Required privileges : Admin

Example URI

GET /admin/users-activity
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "login": "user1",
    "lastSuccessfulLogin": 1647448027194,
    "lastFailedLogin": 1647411934284,
    "lastLoaded": 1647448367338
  }
]

Get user last activity
GET/admin/users/{login}/activity

Get the user’s last activity timestamps


πŸ”’ Required privileges : Admin

Example URI

GET /admin/users/login/activity
URI Parameters
HideShow
login
string (required) 

the login of a Govern user

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "login": "user1",
  "lastSuccessfulLogin": 1647448027194,
  "lastFailedLogin": 1647411934284,
  "lastLoaded": 1647448367338
}

Groups

List groups
GET/admin/groups

Retrieves the list of Govern groups as a list of Group objects as defined in GET group.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/groups
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "name": "GroupA",
    "description": "Group description",
    "sourceType": "LOCAL",
    "admin": false
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create group
POST/admin/groups

Creates a group


πŸ”’ Required privileges : Admin

Example URI

POST /admin/groups
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "name": "GroupA",
  "description": "Group description",
  "sourceType": "LOCAL",
  "admin": false
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the group"
    },
    "description": {
      "type": "string",
      "description": "Description of the group"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "LOCAL",
        "LDAP"
      ],
      "description": "Source type of the group"
    },
    "admin": {
      "type": "boolean",
      "description": "Administrator rights on the group"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "msg": "Created group GroupB"
}

Group

Get group
GET/admin/groups/{groupname}

Retrieves a Group object describing a Govern user group, used for access control on connections and projects.

WARNING : The returned object may contain other attributes but you should not rely on them since they could be modified or removed in future releases without notice.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/groups/groupname
URI Parameters
HideShow
groupname
string (required) 

the name of a Govern group

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "name": "GroupA",
  "description": "Group description",
  "sourceType": "LOCAL",
  "admin": false
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the group"
    },
    "description": {
      "type": "string",
      "description": "Description of the group"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "LOCAL",
        "LDAP"
      ],
      "description": "Source type of the group"
    },
    "admin": {
      "type": "boolean",
      "description": "Administrator rights on the group"
    }
  }
}

Update group
PUT/admin/groups/{groupname}

The Group object given as parameter in of a PUT call MUST have been previously obtained from a GET group call at the same URL.

The object with the GET method may contain undocumented attributes. You should not modify them as it could create an invalid state and thoses attributes may be removed in future releases without notice.


πŸ”’ Required privileges : Admin

Example URI

PUT /admin/groups/groupname
URI Parameters
HideShow
groupname
string (required) 

the name of a Govern group

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "name": "GroupA",
  "description": "Group description",
  "sourceType": "LOCAL",
  "admin": false
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the group"
    },
    "description": {
      "type": "string",
      "description": "Description of the group"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "LOCAL",
        "LDAP"
      ],
      "description": "Source type of the group"
    },
    "admin": {
      "type": "boolean",
      "description": "Administrator rights on the group"
    }
  }
}
Response  200
HideShow
Body
{
  "msg": "Edited group GroupB"
}

Delete group
DELETE/admin/groups/{groupname}

Deletes a Govern users group


πŸ”’ Required privileges : Admin

Example URI

DELETE /admin/groups/groupname
URI Parameters
HideShow
groupname
string (required) 

the name of a Govern group

Response  200
HideShow
Body
{
  "msg": "Deleted group GroupB"
}

Govern Administration

Global settings

Get general settings
GET/admin/general-settings

This calls retrieves the object representing Govern settings.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/general-settings
Response  200
HideShow
Headers
Content-Type: application/json
DSS-API-Version: Version of the API server handling the request
DSS-Version: Version of the DSS backend answering the request
Body
{
    "ldapSettings" : { ... },
    ...
}

Save general settings
PUT/admin/general-settings

This calls saves the DSS settings. You must only PUT an object that you acquired previously via the corresponding GET call


πŸ”’ Required privileges : Admin

Example URI

PUT /admin/general-settings
Request
HideShow
Headers
Content-Type: application/json
Body
{
    "ldapSettings" : { ... },
    ...
}
Response  204

Platform logs

List logs
GET/admin/logs

Dataiku Govern uses a number of log files.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/logs
Response  200
HideShow
Headers
Content-Type: application/json
DSS-API-Version: Version of the API server handling the request
DSS-Version: Version of the DSS backend answering the request
Body
{
    "logs" : [
        {
           "name" : "access.log",
           "totalSize" : 571166942,
           "lastModified" : 1435840900000
        },
        ...
    ]
}

Log

Get log content
GET/admin/logs/{name}

Retrieves the log file with the specified name.


πŸ”’ Required privileges : Admin

Example URI

GET /admin/logs/name
URI Parameters
HideShow
name
string (required) 

the name of a log file

Response  200
HideShow
Headers
Content-Type: text/plain
DSS-API-Version: Version of the API server handling the request
DSS-Version: Version of the DSS backend answering the request

Audit trail

Trigger new audit trail log item
POST/admin/audit/custom/{customMsgType}

Appends an entry to the audit trail. The JSON object given as the request body is put as customMsgParams in the created audit trail log entry.


πŸ”’ Required privileges : Admin

Example URI

POST /admin/audit/custom/customMsgType
URI Parameters
HideShow
customMsgType
string (required) 

the customMsgType for the audit trail log entry

Request
HideShow
Headers
Content-Type: application/json
Body
{
    "arbitraryKey1" : { ... },
    ...
}
Response  200
HideShow
Headers
Content-Type: text/plain

Licensing

Get licensing status
GET/admin/licensing/status

Returns the licensing status


πŸ”’ Required privileges : Admin

Example URI

GET /admin/licensing/status
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
    "base": {
        "licenseContent": {
            "licensee": {
                "email": "[email protected]",
                "company": "ACME Inc.",
                "name": "John Doe"
            },
            "dssMode": "ON_PREMISE_DISCONNECTED",
            "instanceId": "ab7cdefg",
            "licenseKind": "COMMUNITY",
            "licenseId": "iJKLMnoP4qrSTUvw",
            "properties": {
                "automationFeaturesVersion": "2018-1"
            },
            "communityEdition": "true"
        },
        "hasLicense": true,
        "valid": true,
        "expired": false,
        "expiresOn": 0,
        "ceEntrepriseTrial": false,
        "ceEntrepriseTrialUntil": 0,
        "community": true,
        "wasCEEntrepriseTrial": false,
        "ceInstanceId": "sg7jbvoz",
        "ceRegistrationEmail": "[email protected]",
        "userProfiles": [
            "DESIGNER"
        ]
    },
    "limits": {
        "licensedProfiles": {
            "DESIGNER": {
                "profile": "DESIGNER",
                "demotesFrom": [],
                "licensedLimit": 3,
                "mayAdmin": true,
                "mayRegularCode": true,
                "mayVisualML": true,
                "mayReadProjectContent": true,
                "mayWriteProjectContent": true,
                "mayWriteDashboards": true
            }
        },
        "profileLimits": {
            "DESIGNER": {
                "profile": "DESIGNER",
                "licensed": {
                    "profile": "DESIGNER",
                    "demotesFrom": [],
                    "licensedLimit": 3,
                    "mayAdmin": true,
                    "mayRegularCode": true,
                    "mayVisualML": true,
                    "mayReadProjectContent": true,
                    "mayWriteProjectContent": true,
                    "mayWriteDashboards": true
                },
                "directCount": 1,
                "demotedToOther": 0,
                "countWithDemotedTo": 1,
                "demotedTo": [],
                "demotedFromOther": 0,
                "demotedFrom": [],
                "limitWithDemoted": 0,
                "overQuota": 0
            }
        },
        "fallbackProfile": "DESIGNER"
    },
    "features": {
        "limitedEditionString": "Free Edition",
        "allowedDatasetTypes": [
            "S3",
            "SCP",
            "FTP",
            "Greenplum",
            "PostgreSQL",
            "Cassandra",
            "Netezza",
            "Twitter",
            "ElasticSearch",
            "MySQL",
            "Snowflake",
            "JDBC",
            "StatsDB",
            "Filesystem",
            "Oracle",
            "UploadedFiles",
            "FilesInFolder",
            "Azure",
            "BigQuery",
            "JobsDB",
            "HDFS",
            "SFTP",
            "HTTP",
            "Inline",
            "Teradata",
            "Redshift",
            "hiveserver2",
            "GCS",
            "SAPHANA",
            "Vertica",
            "MongoDB",
            "SQLServer"
        ],
        "allowedConnectionTypes": [
            "FTP",
            "Greenplum",
            "PostgreSQL",
            "Cassandra",
            "Netezza",
            "Twitter",
            "ElasticSearch",
            "EC2",
            "MySQL",
            "Snowflake",
            "JDBC",
            "StatsDB",
            "Filesystem",
            "Oracle",
            "UploadedFiles",
            "FilesInFolder",
            "Azure",
            "BigQuery",
            "JobsDB",
            "HDFS",
            "SSH",
            "HTTP",
            "Inline",
            "Teradata",
            "Redshift",
            "hiveserver2",
            "GCS",
            "SAPHANA",
            "Vertica",
            "MongoDB",
            "SQLServer"
        ],  
        "ldapAllowed": false,
        "ssoAllowed": false,
        "userSecurityAllowed": false,
        "multiUserSecurityAllowed": false,
        "sparkAllowed": false,
        "sparkMLLibAllowed": false,
        "apiNodeAllowed": false,
        "lockedTracking": false,
        "forbiddenTracking": false,
        "bundlesAllowed": false,
        "advancedScenarioStepsAllowed": true,
        "temporalTriggerAllowed": false,
        "allScenarioTriggersAllowed": false,
        "allScenarioReportersAllowed": false,
        "advancedMetricsChecksAllowed": false,
        "modelsRawSQLExport": false,
        "modelsPMMLExport": false,
        "modelsJarExport": false
}

Set current license
POST/admin/licensing/license

Set DSS license


πŸ”’ Required privileges : Admin

Example URI

POST /admin/licensing/license
Request
HideShow
Headers
Content-Type: application/json
Body
...content of the license file provided by Dataiku...
Response  200
HideShow
Headers
Content-Type: text/plain

Admin Blueprint Designer

Blueprints

List blueprints
GET/admin/blueprints

Lists all the blueprints


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprints
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "blueprint": {
      "name": "blueprintName",
      "icon": "fiber_new",
      "color": "#494eba",
      "backgroundColor": "#000000",
      "id": "bp.control"
    },
    "assignedRolesAndPermissionsCtx": {}
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create blueprint
POST/admin/blueprints{?newIdentifier}

Creates a blueprint


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/blueprints?newIdentifier=control
URI Parameters
HideShow
newIdentifier
string (required) Example: control

The new identifier of the blueprint to be created. The new identifier has to be made of digits, letters, underscores (_), or hyphens (-)

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "name": "blueprintName",
  "icon": "fiber_new",
  "color": "#494eba",
  "backgroundColor": "#000000"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the blueprint"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the blueprint"
    },
    "color": {
      "type": "string",
      "description": "Color of the blueprint, hexadecimal format"
    },
    "backgroundColor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Color of the background, hexadecimal format"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "assignedRolesAndPermissionsCtx": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      }
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {}
    }
  }
}

Blueprint

Get blueprint
GET/admin/blueprint/{blueprintId}

Retrieves a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "assignedRolesAndPermissionsCtx": {}
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      }
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {}
    }
  }
}

Save blueprint
PUT/admin/blueprint/{blueprintId}

Saves a blueprint


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/blueprint/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "name": "blueprintName",
  "icon": "fiber_new",
  "color": "#494eba",
  "backgroundColor": "#000000",
  "id": "bp.control"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the blueprint"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the blueprint"
    },
    "color": {
      "type": "string",
      "description": "Color of the blueprint, hexadecimal format"
    },
    "backgroundColor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Color of the background, hexadecimal format"
    },
    "id": {
      "type": "string",
      "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
    }
  }
}
Response  200

Delete blueprint
DELETE/admin/blueprint/{blueprintId}

Deletes a blueprint. All related blueprint versions and artifacts must be deleted beforehand.


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/blueprint/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Response  200

Blueprint Versions

List blueprint versions
GET/admin/blueprint/{blueprintId}/versions

Lists the versions of a blueprint


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint/bp.control/versions
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "blueprint": {
      "name": "blueprintName",
      "icon": "fiber_new",
      "color": "#494eba",
      "backgroundColor": "#000000",
      "id": "bp.control"
    },
    "blueprintVersion": {
      "name": "Version1",
      "fieldDefinitions": {},
      "workflowDefinition": {
        "stepDefinitions": [
          {
            "id": "step1",
            "name": "Step1"
          }
        ]
      },
      "logicalHookList": [],
      "hierarchicalParentFieldId": null,
      "uiDefinition": {
        "views": {
          "view1": {},
          "view2": {}
        },
        "uiStepDefinitions": {
          "step1": {
            "viewId": "view1"
          },
          "step2": {
            "viewId": "view1"
          }
        }
      },
      "instructions": "Instructions for this version",
      "id": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      }
    },
    "blueprintVersionTrace": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "status": "DRAFT",
      "originVersionId": null
    },
    "assignedRolesAndPermissionsCtx": {},
    "signoffConfigurations": [
      {
        "id": {
          "blueprintVersionId": {
            "blueprintId": "bp.control",
            "versionId": "bv.v1"
          },
          "stepId": "step1"
        },
        "title": "title",
        "description": "description",
        "mandatory": true,
        "feedbackUsersGroups": [
          {
            "id": "group1",
            "title": "Group 1",
            "users": [
              {
                "addedBy": "admin",
                "addedOn": "2021-09-02T18:26:03.748+02:00",
                "delegated": false,
                "userContainer": {
                  "type": "user",
                  "login": "UserA"
                }
              }
            ]
          }
        ],
        "approvers": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ],
        "recurrenceConfiguration": {
          "activated": true,
          "days": 0,
          "weeks": 0,
          "months": 6,
          "years": 0,
          "reloadConf": false
        }
      }
    ]
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create blueprint version
POST/admin/blueprint/{blueprintId}/versions{?newIdentifier,name,originVersionId}

Creates a blueprint


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/blueprint/bp.control/versions?newIdentifier=v3&name=blueprint control&originVersionId=bv.v1
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The blueprint ID

newIdentifier
string (required) Example: v3

The identifier of the version to be created

name
string (optional) Example: blueprint control

The name of the version to be created

originVersionId
string (optional) Example: bv.v1

The origin version ID. Needed if this blueprint version is created from another version.

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "blueprintVersionTrace": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": "DRAFT",
    "originVersionId": null
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffConfigurations": [
    {
      "id": {
        "blueprintVersionId": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        },
        "stepId": "step1"
      },
      "title": "title",
      "description": "description",
      "mandatory": true,
      "feedbackUsersGroups": [
        {
          "id": "group1",
          "title": "Group 1",
          "users": [
            {
              "addedBy": "admin",
              "addedOn": "2021-09-02T18:26:03.748+02:00",
              "delegated": false,
              "userContainer": {
                "type": "user",
                "login": "UserA"
              }
            }
          ]
        }
      ],
      "approvers": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ],
      "recurrenceConfiguration": {
        "activated": true,
        "days": 0,
        "weeks": 0,
        "months": 6,
        "years": 0,
        "reloadConf": false
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "the corresponding blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "Definition of the blueprint version"
    },
    "blueprintVersionTrace": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        },
        "status": {
          "type": "string",
          "enum": [
            "DRAFT",
            "ACTIVE",
            "ARCHIVED"
          ],
          "description": "Status of the blueprint version"
        },
        "originVersionId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Version of the origin blueprint version"
        }
      },
      "description": "Trace related information of the blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffConfigurations": {
      "type": [
        "array",
        "null"
      ],
      "description": "Sign-off configurations"
    }
  },
  "definitions": {
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Blueprint Version

Get blueprint version
GET/admin/blueprint/{blueprintId}/version/{versionId}

Retrieves a blueprint version


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint/bp.control/version/bv.v1
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

versionId
string (required) Example: bv.v1

the ID of the version

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "blueprintVersionTrace": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": "DRAFT",
    "originVersionId": null
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffConfigurations": [
    {
      "id": {
        "blueprintVersionId": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        },
        "stepId": "step1"
      },
      "title": "title",
      "description": "description",
      "mandatory": true,
      "feedbackUsersGroups": [
        {
          "id": "group1",
          "title": "Group 1",
          "users": [
            {
              "addedBy": "admin",
              "addedOn": "2021-09-02T18:26:03.748+02:00",
              "delegated": false,
              "userContainer": {
                "type": "user",
                "login": "UserA"
              }
            }
          ]
        }
      ],
      "approvers": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ],
      "recurrenceConfiguration": {
        "activated": true,
        "days": 0,
        "weeks": 0,
        "months": 6,
        "years": 0,
        "reloadConf": false
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "the corresponding blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "Definition of the blueprint version"
    },
    "blueprintVersionTrace": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        },
        "status": {
          "type": "string",
          "enum": [
            "DRAFT",
            "ACTIVE",
            "ARCHIVED"
          ],
          "description": "Status of the blueprint version"
        },
        "originVersionId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Version of the origin blueprint version"
        }
      },
      "description": "Trace related information of the blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffConfigurations": {
      "type": [
        "array",
        "null"
      ],
      "description": "Sign-off configurations"
    }
  },
  "definitions": {
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Save blueprint version
PUT/admin/blueprint/{blueprintId}/version/{versionId}{?dangerZoneAccepted}

Saves a blueprint version


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/blueprint/bp.control/version/bv.v3?dangerZoneAccepted=true
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The blueprint ID

versionId
string (required) Example: bv.v3

The version ID

dangerZoneAccepted
boolean (optional) Example: true

If set to false or absent, the blueprint version will be saved only if there are no existing artifacts for this blueprint version. If set to true, editing the blueprint version will update existing artifacts to reflect these changes with best effort which may lead to lost data or broken behaviour.

  • Default false
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "name": "Version1",
  "fieldDefinitions": {},
  "workflowDefinition": {
    "stepDefinitions": [
      {
        "id": "step1",
        "name": "Step1"
      }
    ]
  },
  "logicalHookList": [],
  "hierarchicalParentFieldId": null,
  "uiDefinition": {
    "views": {
      "view1": {},
      "view2": {}
    },
    "uiStepDefinitions": {
      "step1": {
        "viewId": "view1"
      },
      "step2": {
        "viewId": "view1"
      }
    }
  },
  "instructions": "Instructions for this version",
  "id": {
    "blueprintId": "bp.control",
    "versionId": "bv.v1"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the blueprint version"
    },
    "fieldDefinitions": {
      "type": "object",
      "properties": {},
      "description": "Field definitions of this blueprint version"
    },
    "workflowDefinition": {
      "type": "object",
      "properties": {
        "stepDefinitions": {
          "type": "array",
          "description": "List of the steps"
        }
      },
      "description": "The definition of the workflow"
    },
    "logicalHookList": {
      "type": "array",
      "description": "List of the hooks"
    },
    "hierarchicalParentFieldId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional ID of the field in which the hierarchical parent item is referenced."
    },
    "uiDefinition": {
      "type": "object",
      "properties": {
        "views": {
          "allOf": [
            {
              "$ref": "#/definitions/view1"
            },
            {
              "$ref": "#/definitions/view2"
            }
          ],
          "description": "list of the views"
        },
        "uiStepDefinitions": {
          "allOf": [
            {
              "$ref": "#/definitions/step1"
            },
            {
              "$ref": "#/definitions/step2"
            }
          ],
          "description": "list of the User Interface definition for the steps"
        }
      },
      "description": "User interface definition of the blueprint"
    },
    "instructions": {
      "type": "string",
      "description": "Instructions for this blueprint version"
    },
    "id": {
      "type": "object",
      "properties": {
        "blueprintId": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.'"
        },
        "versionId": {
          "type": "string",
          "description": "ID of the version, starts with 'bv.'"
        }
      },
      "description": "ID of the blueprint version"
    }
  },
  "definitions": {
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprint": {
    "name": "blueprintName",
    "icon": "fiber_new",
    "color": "#494eba",
    "backgroundColor": "#000000",
    "id": "bp.control"
  },
  "blueprintVersion": {
    "name": "Version1",
    "fieldDefinitions": {},
    "workflowDefinition": {
      "stepDefinitions": [
        {
          "id": "step1",
          "name": "Step1"
        }
      ]
    },
    "logicalHookList": [],
    "hierarchicalParentFieldId": null,
    "uiDefinition": {
      "views": {
        "view1": {},
        "view2": {}
      },
      "uiStepDefinitions": {
        "step1": {
          "viewId": "view1"
        },
        "step2": {
          "viewId": "view1"
        }
      }
    },
    "instructions": "Instructions for this version",
    "id": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    }
  },
  "blueprintVersionTrace": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "status": "DRAFT",
    "originVersionId": null
  },
  "assignedRolesAndPermissionsCtx": {},
  "signoffConfigurations": [
    {
      "id": {
        "blueprintVersionId": {
          "blueprintId": "bp.control",
          "versionId": "bv.v1"
        },
        "stepId": "step1"
      },
      "title": "title",
      "description": "description",
      "mandatory": true,
      "feedbackUsersGroups": [
        {
          "id": "group1",
          "title": "Group 1",
          "users": [
            {
              "addedBy": "admin",
              "addedOn": "2021-09-02T18:26:03.748+02:00",
              "delegated": false,
              "userContainer": {
                "type": "user",
                "login": "UserA"
              }
            }
          ]
        }
      ],
      "approvers": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ],
      "recurrenceConfiguration": {
        "activated": true,
        "days": 0,
        "weeks": 0,
        "months": 6,
        "years": 0,
        "reloadConf": false
      }
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprint": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint"
        },
        "icon": {
          "type": "string",
          "description": "Icon of the blueprint"
        },
        "color": {
          "type": "string",
          "description": "Color of the blueprint, hexadecimal format"
        },
        "backgroundColor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Color of the background, hexadecimal format"
        },
        "id": {
          "type": "string",
          "description": "ID of the blueprint, starts with 'bp.' (or 'bp.system' for non custom blueprints)"
        }
      },
      "description": "the corresponding blueprint"
    },
    "blueprintVersion": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the blueprint version"
        },
        "fieldDefinitions": {
          "type": "object",
          "properties": {},
          "description": "Field definitions of this blueprint version"
        },
        "workflowDefinition": {
          "type": "object",
          "properties": {
            "stepDefinitions": {
              "type": "array",
              "description": "List of the steps"
            }
          },
          "description": "The definition of the workflow"
        },
        "logicalHookList": {
          "type": "array",
          "description": "List of the hooks"
        },
        "hierarchicalParentFieldId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional ID of the field in which the hierarchical parent item is referenced."
        },
        "uiDefinition": {
          "type": "object",
          "properties": {
            "views": {
              "allOf": [
                {
                  "$ref": "#/definitions/view1"
                },
                {
                  "$ref": "#/definitions/view2"
                }
              ],
              "description": "list of the views"
            },
            "uiStepDefinitions": {
              "allOf": [
                {
                  "$ref": "#/definitions/step1"
                },
                {
                  "$ref": "#/definitions/step2"
                }
              ],
              "description": "list of the User Interface definition for the steps"
            }
          },
          "description": "User interface definition of the blueprint"
        },
        "instructions": {
          "type": "string",
          "description": "Instructions for this blueprint version"
        },
        "id": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        }
      },
      "description": "Definition of the blueprint version"
    },
    "blueprintVersionTrace": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "ID of the blueprint version"
        },
        "status": {
          "type": "string",
          "enum": [
            "DRAFT",
            "ACTIVE",
            "ARCHIVED"
          ],
          "description": "Status of the blueprint version"
        },
        "originVersionId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Version of the origin blueprint version"
        }
      },
      "description": "Trace related information of the blueprint version"
    },
    "assignedRolesAndPermissionsCtx": {
      "type": "object",
      "properties": {},
      "description": "The roles and permissions context"
    },
    "signoffConfigurations": {
      "type": [
        "array",
        "null"
      ],
      "description": "Sign-off configurations"
    }
  },
  "definitions": {
    "view1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "view2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {}
        }
      }
    },
    "step1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    },
    "step2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "viewId": {
              "type": "string",
              "description": "ID of the view"
            }
          }
        }
      }
    }
  }
}

Delete blueprint version
DELETE/admin/blueprint/{blueprintId}/version/{versionId}

Deletes a blueprint version. All related artifacts must be deleted beforehand.


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/blueprint/bp.control/version/bv.v3
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The blueprint ID

versionId
string (required) Example: bv.v3

The version ID

Response  200

Sign-off Configurations

List sign-off configurations
GET/admin/blueprint/{blueprintId}/version/{versionId}/signoffs

Lists the sign-off configurations for a specific blueprint version


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint/bp.blueprint_a/version/bv.v1/signoffs
URI Parameters
HideShow
blueprintId
string (required) Example: bp.blueprint_a

The blueprint ID

versionId
string (required) Example: bv.v1

The version ID

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "id": {
      "blueprintVersionId": {
        "blueprintId": "bp.control",
        "versionId": "bv.v1"
      },
      "stepId": "step1"
    },
    "title": "title",
    "description": "description",
    "mandatory": true,
    "feedbackUsersGroups": [
      {
        "id": "group1",
        "title": "Group 1",
        "users": [
          {
            "addedBy": "admin",
            "addedOn": "2021-09-02T18:26:03.748+02:00",
            "delegated": false,
            "userContainer": {
              "type": "user",
              "login": "UserA"
            }
          }
        ]
      }
    ],
    "approvers": [
      {
        "addedBy": "admin",
        "addedOn": "2021-09-02T18:26:03.748+02:00",
        "delegated": false,
        "userContainer": {
          "type": "user",
          "login": "UserA"
        }
      }
    ],
    "recurrenceConfiguration": {
      "activated": true,
      "days": 0,
      "weeks": 0,
      "months": 6,
      "years": 0,
      "reloadConf": false
    }
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Sign-off Configuration

Get sign-off configurations
GET/admin/blueprint/{blueprintId}/version/{versionId}/workflow/step/{stepId}/signoff

Get the sign-off configuration for a specific step of a blueprint version


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint/bp.blueprint_a/version/bv.v1/workflow/step/step1/signoff
URI Parameters
HideShow
blueprintId
string (required) Example: bp.blueprint_a

The blueprint ID

versionId
string (required) Example: bv.v1

The version ID

stepId
string (required) Example: step1

The ID of the step

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "stepId": "step1"
  },
  "title": "title",
  "description": "description",
  "mandatory": true,
  "feedbackUsersGroups": [
    {
      "id": "group1",
      "title": "Group 1",
      "users": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ]
    }
  ],
  "approvers": [
    {
      "addedBy": "admin",
      "addedOn": "2021-09-02T18:26:03.748+02:00",
      "delegated": false,
      "userContainer": {
        "type": "user",
        "login": "UserA"
      }
    }
  ],
  "recurrenceConfiguration": {
    "activated": true,
    "days": 0,
    "weeks": 0,
    "months": 6,
    "years": 0,
    "reloadConf": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "The related ID of the blueprint version"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "The ID of the configuration of the sign-off"
    },
    "title": {
      "type": "string",
      "description": "Title of the configuration"
    },
    "description": {
      "type": "string",
      "description": "Description of the configuration"
    },
    "mandatory": {
      "type": "boolean",
      "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
    },
    "feedbackUsersGroups": {
      "type": "array",
      "description": "A list of groups of users able to give feedback on this sign-off"
    },
    "approvers": {
      "type": "array",
      "description": "A list of users able to give an approval on this sign-off"
    },
    "recurrenceConfiguration": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "activated": {
          "type": "boolean",
          "description": "Activate the reset recurrence"
        },
        "days": {
          "type": "number",
          "description": "number of days to wait"
        },
        "weeks": {
          "type": "number",
          "description": "number of weeks to wait"
        },
        "months": {
          "type": "number",
          "description": "number of months to wait"
        },
        "years": {
          "type": "number",
          "description": "number of years to wait"
        },
        "reloadConf": {
          "type": "boolean",
          "description": "on reset, reload or not the signoff configuration from the blueprint version"
        }
      },
      "description": "The recurrence configuration of this sign-off"
    }
  }
}

Create Sign-off configurations
POST/admin/blueprint/{blueprintId}/version/{versionId}/workflow/step/{stepId}/signoff

Creates a sign-off configuration for a specific step of a blueprint version


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/blueprint/bp.blueprint_a/version/bv.v1/workflow/step/step3/signoff
URI Parameters
HideShow
blueprintId
string (required) Example: bp.blueprint_a

The blueprint ID

versionId
string (required) Example: bv.v1

The version ID

stepId
string (required) Example: step3

The ID of the step

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "id": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "stepId": "step1"
  },
  "title": "title",
  "description": "description",
  "mandatory": true,
  "feedbackUsersGroups": [
    {
      "id": "group1",
      "title": "Group 1",
      "users": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ]
    }
  ],
  "approvers": [
    {
      "addedBy": "admin",
      "addedOn": "2021-09-02T18:26:03.748+02:00",
      "delegated": false,
      "userContainer": {
        "type": "user",
        "login": "UserA"
      }
    }
  ],
  "recurrenceConfiguration": {
    "activated": true,
    "days": 0,
    "weeks": 0,
    "months": 6,
    "years": 0,
    "reloadConf": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "The related ID of the blueprint version"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "The ID of the configuration of the sign-off"
    },
    "title": {
      "type": "string",
      "description": "Title of the configuration"
    },
    "description": {
      "type": "string",
      "description": "Description of the configuration"
    },
    "mandatory": {
      "type": "boolean",
      "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
    },
    "feedbackUsersGroups": {
      "type": "array",
      "description": "A list of groups of users able to give feedback on this sign-off"
    },
    "approvers": {
      "type": "array",
      "description": "A list of users able to give an approval on this sign-off"
    },
    "recurrenceConfiguration": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "activated": {
          "type": "boolean",
          "description": "Activate the reset recurrence"
        },
        "days": {
          "type": "number",
          "description": "number of days to wait"
        },
        "weeks": {
          "type": "number",
          "description": "number of weeks to wait"
        },
        "months": {
          "type": "number",
          "description": "number of months to wait"
        },
        "years": {
          "type": "number",
          "description": "number of years to wait"
        },
        "reloadConf": {
          "type": "boolean",
          "description": "on reset, reload or not the signoff configuration from the blueprint version"
        }
      },
      "description": "The recurrence configuration of this sign-off"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "stepId": "step1"
  },
  "title": "title",
  "description": "description",
  "mandatory": true,
  "feedbackUsersGroups": [
    {
      "id": "group1",
      "title": "Group 1",
      "users": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ]
    }
  ],
  "approvers": [
    {
      "addedBy": "admin",
      "addedOn": "2021-09-02T18:26:03.748+02:00",
      "delegated": false,
      "userContainer": {
        "type": "user",
        "login": "UserA"
      }
    }
  ],
  "recurrenceConfiguration": {
    "activated": true,
    "days": 0,
    "weeks": 0,
    "months": 6,
    "years": 0,
    "reloadConf": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "The related ID of the blueprint version"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "The ID of the configuration of the sign-off"
    },
    "title": {
      "type": "string",
      "description": "Title of the configuration"
    },
    "description": {
      "type": "string",
      "description": "Description of the configuration"
    },
    "mandatory": {
      "type": "boolean",
      "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
    },
    "feedbackUsersGroups": {
      "type": "array",
      "description": "A list of groups of users able to give feedback on this sign-off"
    },
    "approvers": {
      "type": "array",
      "description": "A list of users able to give an approval on this sign-off"
    },
    "recurrenceConfiguration": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "activated": {
          "type": "boolean",
          "description": "Activate the reset recurrence"
        },
        "days": {
          "type": "number",
          "description": "number of days to wait"
        },
        "weeks": {
          "type": "number",
          "description": "number of weeks to wait"
        },
        "months": {
          "type": "number",
          "description": "number of months to wait"
        },
        "years": {
          "type": "number",
          "description": "number of years to wait"
        },
        "reloadConf": {
          "type": "boolean",
          "description": "on reset, reload or not the signoff configuration from the blueprint version"
        }
      },
      "description": "The recurrence configuration of this sign-off"
    }
  }
}

Save sign-off configurations
PUT/admin/blueprint/{blueprintId}/version/{versionId}/workflow/step/{stepId}/signoff

Saves the sign-off configuration for a specific step of a blueprint version


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/blueprint/bp.blueprint_a/version/bv.v1/workflow/step/step3/signoff
URI Parameters
HideShow
blueprintId
string (required) Example: bp.blueprint_a

The blueprint ID

versionId
string (required) Example: bv.v1

The version ID

stepId
string (required) Example: step3

The ID of the step

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "id": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "stepId": "step1"
  },
  "title": "title",
  "description": "description",
  "mandatory": true,
  "feedbackUsersGroups": [
    {
      "id": "group1",
      "title": "Group 1",
      "users": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ]
    }
  ],
  "approvers": [
    {
      "addedBy": "admin",
      "addedOn": "2021-09-02T18:26:03.748+02:00",
      "delegated": false,
      "userContainer": {
        "type": "user",
        "login": "UserA"
      }
    }
  ],
  "recurrenceConfiguration": {
    "activated": true,
    "days": 0,
    "weeks": 0,
    "months": 6,
    "years": 0,
    "reloadConf": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "The related ID of the blueprint version"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "The ID of the configuration of the sign-off"
    },
    "title": {
      "type": "string",
      "description": "Title of the configuration"
    },
    "description": {
      "type": "string",
      "description": "Description of the configuration"
    },
    "mandatory": {
      "type": "boolean",
      "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
    },
    "feedbackUsersGroups": {
      "type": "array",
      "description": "A list of groups of users able to give feedback on this sign-off"
    },
    "approvers": {
      "type": "array",
      "description": "A list of users able to give an approval on this sign-off"
    },
    "recurrenceConfiguration": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "activated": {
          "type": "boolean",
          "description": "Activate the reset recurrence"
        },
        "days": {
          "type": "number",
          "description": "number of days to wait"
        },
        "weeks": {
          "type": "number",
          "description": "number of weeks to wait"
        },
        "months": {
          "type": "number",
          "description": "number of months to wait"
        },
        "years": {
          "type": "number",
          "description": "number of years to wait"
        },
        "reloadConf": {
          "type": "boolean",
          "description": "on reset, reload or not the signoff configuration from the blueprint version"
        }
      },
      "description": "The recurrence configuration of this sign-off"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "id": {
    "blueprintVersionId": {
      "blueprintId": "bp.control",
      "versionId": "bv.v1"
    },
    "stepId": "step1"
  },
  "title": "title",
  "description": "description",
  "mandatory": true,
  "feedbackUsersGroups": [
    {
      "id": "group1",
      "title": "Group 1",
      "users": [
        {
          "addedBy": "admin",
          "addedOn": "2021-09-02T18:26:03.748+02:00",
          "delegated": false,
          "userContainer": {
            "type": "user",
            "login": "UserA"
          }
        }
      ]
    }
  ],
  "approvers": [
    {
      "addedBy": "admin",
      "addedOn": "2021-09-02T18:26:03.748+02:00",
      "delegated": false,
      "userContainer": {
        "type": "user",
        "login": "UserA"
      }
    }
  ],
  "recurrenceConfiguration": {
    "activated": true,
    "days": 0,
    "weeks": 0,
    "months": 6,
    "years": 0,
    "reloadConf": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "object",
      "properties": {
        "blueprintVersionId": {
          "type": "object",
          "properties": {
            "blueprintId": {
              "type": "string",
              "description": "ID of the blueprint, starts with 'bp.'"
            },
            "versionId": {
              "type": "string",
              "description": "ID of the version, starts with 'bv.'"
            }
          },
          "description": "The related ID of the blueprint version"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step"
        }
      },
      "description": "The ID of the configuration of the sign-off"
    },
    "title": {
      "type": "string",
      "description": "Title of the configuration"
    },
    "description": {
      "type": "string",
      "description": "Description of the configuration"
    },
    "mandatory": {
      "type": "boolean",
      "description": "Is the sign-off mandatory to be approved before continuing the artifact workflow"
    },
    "feedbackUsersGroups": {
      "type": "array",
      "description": "A list of groups of users able to give feedback on this sign-off"
    },
    "approvers": {
      "type": "array",
      "description": "A list of users able to give an approval on this sign-off"
    },
    "recurrenceConfiguration": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "activated": {
          "type": "boolean",
          "description": "Activate the reset recurrence"
        },
        "days": {
          "type": "number",
          "description": "number of days to wait"
        },
        "weeks": {
          "type": "number",
          "description": "number of weeks to wait"
        },
        "months": {
          "type": "number",
          "description": "number of months to wait"
        },
        "years": {
          "type": "number",
          "description": "number of years to wait"
        },
        "reloadConf": {
          "type": "boolean",
          "description": "on reset, reload or not the signoff configuration from the blueprint version"
        }
      },
      "description": "The recurrence configuration of this sign-off"
    }
  }
}

Delete sign-off configuration
DELETE/admin/blueprint/{blueprintId}/version/{versionId}/workflow/step/{stepId}/signoff

Deletes a sign-off configuration


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/blueprint/bp.blueprint_a/version/bv.v1/workflow/step/step3/signoff
URI Parameters
HideShow
blueprintId
string (required) Example: bp.blueprint_a

The blueprint ID

versionId
string (required) Example: bv.v1

The version ID

stepId
string (required) Example: step3

The ID of the step

Response  200

Admin Roles & Permissions

Roles

List roles
GET/admin/roles

Lists the roles.


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/roles
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "label": "Risk & Compliance reviewer",
    "description": "Can submit reviews as a Risk & Compliance expert",
    "id": "ro.risk_compliance_reviewer"
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create role
POST/admin/roles{?newIdentifier}

Creates a new role


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/roles?newIdentifier=risk_compliance_reviewer
URI Parameters
HideShow
newIdentifier
string (required) Example: risk_compliance_reviewer

The new identifier of the role to be created. The new identifier has to be made of digits, letters, underscores (_), or hyphens (-)

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "label": "Risk & Compliance reviewer",
  "description": "Can submit reviews as a Risk & Compliance expert"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the role"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Description of the role"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "label": "Risk & Compliance reviewer",
  "description": "Can submit reviews as a Risk & Compliance expert",
  "id": "ro.risk_compliance_reviewer"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the role"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Description of the role"
    },
    "id": {
      "type": "string",
      "description": "ID of the role, starts with 'ro.'"
    }
  }
}

Role

Get role
GET/admin/role/{roleId}

Gets a specific role


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/role/ro.risk_compliance_reviewer
URI Parameters
HideShow
roleId
string (required) Example: ro.risk_compliance_reviewer

the ID of the role

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "label": "Risk & Compliance reviewer",
  "description": "Can submit reviews as a Risk & Compliance expert",
  "id": "ro.risk_compliance_reviewer"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the role"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Description of the role"
    },
    "id": {
      "type": "string",
      "description": "ID of the role, starts with 'ro.'"
    }
  }
}

Save role
PUT/admin/role/{roleId}

Saves a role


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/role/ro.risk_compliance_reviewer
URI Parameters
HideShow
roleId
string (required) Example: ro.risk_compliance_reviewer

The role ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "label": "Risk & Compliance reviewer",
  "description": "Can submit reviews as a Risk & Compliance expert",
  "id": "ro.risk_compliance_reviewer"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the role"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Description of the role"
    },
    "id": {
      "type": "string",
      "description": "ID of the role, starts with 'ro.'"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "label": "Risk & Compliance reviewer",
  "description": "Can submit reviews as a Risk & Compliance expert",
  "id": "ro.risk_compliance_reviewer"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Label of the role"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Description of the role"
    },
    "id": {
      "type": "string",
      "description": "ID of the role, starts with 'ro.'"
    }
  }
}

Delete role
DELETE/admin/role/{roleId}

Deletes a role


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/role/ro.rolea
URI Parameters
HideShow
roleId
string (required) Example: ro.rolea

The role ID

Response  200
HideShow
Headers
Content-Type: application/json

Blueprint Role Assignments items

List blueprint role assignments
GET/admin/blueprint-role-assignments

Lists the role assignments


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint-role-assignments
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "blueprintId": "bp.control",
    "roleAssignmentsRules": {
      "ro.it_operations_reviewer": [
        {
          "criteria": [],
          "userContainers": [],
          "fieldIds": [
            "field1"
          ]
        }
      ],
      "ro.rolea": [
        {
          "criteria": [],
          "userContainers": [],
          "fieldIds": [
            "field1"
          ]
        }
      ]
    },
    "inheritBlueprintId": "bp.system.govern_project",
    "inheritArtifactFieldId": "govern_project"
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create blueprint role assignments
POST/admin/blueprint-role-assignments

Creates new role assignments for a specific blueprint.


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/blueprint-role-assignments
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintId": "bp.control",
  "roleAssignmentsRules": {
    "ro.it_operations_reviewer": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ],
    "ro.rolea": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ]
  },
  "inheritBlueprintId": "bp.system.govern_project",
  "inheritArtifactFieldId": "govern_project"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    },
    "roleAssignmentsRules": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "A map of role assignment rules for different rules"
    },
    "inheritBlueprintId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from blueprint"
    },
    "inheritArtifactFieldId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from an existing artifact"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintId": "bp.control",
  "roleAssignmentsRules": {
    "ro.it_operations_reviewer": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ],
    "ro.rolea": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ]
  },
  "inheritBlueprintId": "bp.system.govern_project",
  "inheritArtifactFieldId": "govern_project"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    },
    "roleAssignmentsRules": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "A map of role assignment rules for different rules"
    },
    "inheritBlueprintId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from blueprint"
    },
    "inheritArtifactFieldId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from an existing artifact"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    }
  }
}

Blueprint Role Assignments item

Get blueprint role assignments
GET/admin/blueprint-role-assignments/{blueprintId}

Gets role assignments for a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint-role-assignments/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

the ID of the blueprint

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintId": "bp.control",
  "roleAssignmentsRules": {
    "ro.it_operations_reviewer": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ],
    "ro.rolea": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ]
  },
  "inheritBlueprintId": "bp.system.govern_project",
  "inheritArtifactFieldId": "govern_project"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    },
    "roleAssignmentsRules": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "A map of role assignment rules for different rules"
    },
    "inheritBlueprintId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from blueprint"
    },
    "inheritArtifactFieldId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from an existing artifact"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    }
  }
}

Save blueprint role assignments
PUT/admin/blueprint-role-assignments/{blueprintId}

Saves the role assignments


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/blueprint-role-assignments/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The ID of the blueprint

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintId": "bp.control",
  "roleAssignmentsRules": {
    "ro.it_operations_reviewer": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ],
    "ro.rolea": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ]
  },
  "inheritBlueprintId": "bp.system.govern_project",
  "inheritArtifactFieldId": "govern_project"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    },
    "roleAssignmentsRules": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "A map of role assignment rules for different rules"
    },
    "inheritBlueprintId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from blueprint"
    },
    "inheritArtifactFieldId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from an existing artifact"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "blueprintId": "bp.control",
  "roleAssignmentsRules": {
    "ro.it_operations_reviewer": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ],
    "ro.rolea": [
      {
        "criteria": [],
        "userContainers": [],
        "fieldIds": [
          "field1"
        ]
      }
    ]
  },
  "inheritBlueprintId": "bp.system.govern_project",
  "inheritArtifactFieldId": "govern_project"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    },
    "roleAssignmentsRules": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "A map of role assignment rules for different rules"
    },
    "inheritBlueprintId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from blueprint"
    },
    "inheritArtifactFieldId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Role assignments inheritance from an existing artifact"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "array"
        }
      }
    }
  }
}

Delete blueprint role assignments
DELETE/admin/blueprint-role-assignments/{blueprintId}

Deletes the role assignments for a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/blueprint-role-assignments/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The blueprint ID

Response  200
HideShow
Headers
Content-Type: application/json

Default permissions

Get default permissions
GET/admin/blueprint-permissions/default

Gets the default permissions that apply to blueprints that do not have custom permissions.


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint-permissions/default
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}

Save default permissions
PUT/admin/blueprint-permissions/default

Saves the default permissions


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/blueprint-permissions/default
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}

Blueprint permissions items

List blueprint permissions
GET/admin/blueprint-permissions

Gets the list of all the blueprint permissions


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint-permissions
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "everyonePermissions": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "rolePermissions": {
      "ro.it_operations_reviewer": {
        "artifactPermissionsItem": {
          "read": false,
          "write": false,
          "delete": false,
          "create": false,
          "admin": false
        },
        "fieldPermissionsItems": {
          "field1": {
            "read": false,
            "write": false
          },
          "field2": {
            "read": false,
            "write": false
          }
        },
        "fieldDefaultRead": false,
        "fieldDefaultWrite": false
      },
      "ro.rolea": {
        "artifactPermissionsItem": {
          "read": false,
          "write": false,
          "delete": false,
          "create": false,
          "admin": false
        },
        "fieldPermissionsItems": {
          "field1": {
            "read": false,
            "write": false
          },
          "field2": {
            "read": false,
            "write": false
          }
        },
        "fieldDefaultRead": false,
        "fieldDefaultWrite": false
      }
    },
    "blueprintId": "bp.control"
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create blueprint permissions
POST/admin/blueprint-permissions

Creates the blueprint permissions for a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/blueprint-permissions
Request
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  },
  "blueprintId": "bp.control"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    },
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  },
  "blueprintId": "bp.control"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    },
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}

Blueprint permissions item

Get blueprint permissions
GET/admin/blueprint-permissions/{blueprintId}

Gets the blueprint permissions for a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/blueprint-permissions/bp.system.govern_model_version
URI Parameters
HideShow
blueprintId
string (required) Example: bp.system.govern_model_version

the ID of the blueprint

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  },
  "blueprintId": "bp.control"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    },
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}

Save blueprint permissions
PUT/admin/blueprint-permissions/{blueprintId}

Saves the blueprint permissions for a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/blueprint-permissions/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The ID of the blueprint

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  },
  "blueprintId": "bp.control"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    },
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "everyonePermissions": {
    "artifactPermissionsItem": {
      "read": false,
      "write": false,
      "delete": false,
      "create": false,
      "admin": false
    },
    "fieldPermissionsItems": {
      "field1": {
        "read": false,
        "write": false
      },
      "field2": {
        "read": false,
        "write": false
      }
    },
    "fieldDefaultRead": false,
    "fieldDefaultWrite": false
  },
  "rolePermissions": {
    "ro.it_operations_reviewer": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    },
    "ro.rolea": {
      "artifactPermissionsItem": {
        "read": false,
        "write": false,
        "delete": false,
        "create": false,
        "admin": false
      },
      "fieldPermissionsItems": {
        "field1": {
          "read": false,
          "write": false
        },
        "field2": {
          "read": false,
          "write": false
        }
      },
      "fieldDefaultRead": false,
      "fieldDefaultWrite": false
    }
  },
  "blueprintId": "bp.control"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "everyonePermissions": {
      "type": "object",
      "properties": {
        "artifactPermissionsItem": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission"
            },
            "delete": {
              "type": "boolean",
              "description": "Delete permission"
            },
            "create": {
              "type": "boolean",
              "description": "Create permission"
            },
            "admin": {
              "type": "boolean",
              "description": "Admin permission"
            }
          },
          "description": "Artifact permissions"
        },
        "fieldPermissionsItems": {
          "allOf": [
            {
              "$ref": "#/definitions/field1"
            },
            {
              "$ref": "#/definitions/field2"
            }
          ],
          "description": "Field permissions"
        },
        "fieldDefaultRead": {
          "type": "boolean",
          "description": "Default read permission for fields"
        },
        "fieldDefaultWrite": {
          "type": "boolean",
          "description": "Default write permission for fields"
        }
      },
      "description": "Permissions that apply to everyone"
    },
    "rolePermissions": {
      "allOf": [
        {
          "$ref": "#/definitions/ro.it_operations_reviewer"
        },
        {
          "$ref": "#/definitions/ro.rolea"
        }
      ],
      "description": "Permissions that apply to specific roles"
    },
    "blueprintId": {
      "type": "string",
      "description": "ID of the blueprint"
    }
  },
  "definitions": {
    "ro.it_operations_reviewer": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    },
    "field1": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "field2": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "read": {
              "type": "boolean",
              "description": "Read permission for field"
            },
            "write": {
              "type": "boolean",
              "description": "Write permission for field"
            }
          }
        }
      }
    },
    "ro.rolea": {
      "type": "object",
      "patternProperties": {
        "": {
          "type": "object",
          "properties": {
            "artifactPermissionsItem": {
              "type": "object",
              "properties": {
                "read": {
                  "type": "boolean",
                  "description": "Read permission"
                },
                "write": {
                  "type": "boolean",
                  "description": "Write permission"
                },
                "delete": {
                  "type": "boolean",
                  "description": "Delete permission"
                },
                "create": {
                  "type": "boolean",
                  "description": "Create permission"
                },
                "admin": {
                  "type": "boolean",
                  "description": "Admin permission"
                }
              },
              "description": "Artifact permissions"
            },
            "fieldPermissionsItems": {
              "allOf": [
                {
                  "$ref": "#/definitions/field1"
                },
                {
                  "$ref": "#/definitions/field2"
                }
              ],
              "description": "Field permissions"
            },
            "fieldDefaultRead": {
              "type": "boolean",
              "description": "Default read permission for fields"
            },
            "fieldDefaultWrite": {
              "type": "boolean",
              "description": "Default write permission for fields"
            }
          }
        }
      }
    }
  }
}

Delete blueprint permissions
DELETE/admin/blueprint-permissions/{blueprintId}

Deletes the permissions for a specific blueprint


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/blueprint-permissions/bp.control
URI Parameters
HideShow
blueprintId
string (required) Example: bp.control

The blueprint ID

Response  200
HideShow
Headers
Content-Type: application/json

Admin Custom Pages

Custom Pages

List custom pages
GET/admin/custom-pages

Lists the custom pages


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/custom-pages
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "index": 1,
    "name": "Custom Page 1",
    "icon": "fiber_new",
    "id": "cp.cp1"
  }
]
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "array"
}

Create custom page
POST/admin/custom-pages{?newIdentifier}

Creates a new custom page


πŸ”’ Required privileges : Govern manager

Example URI

POST /admin/custom-pages?newIdentifier=cp2
URI Parameters
HideShow
newIdentifier
string (required) Example: cp2

The new identifier of the custom page. The new identifier has to be made of digits, letters or hyphens (-,)

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "index": 1,
  "name": "Custom Page 1",
  "icon": "fiber_new"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "index": {
      "type": "number",
      "description": "Index of the tab on which the custom will be displayed"
    },
    "name": {
      "type": "string",
      "description": "Name of the custom page"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the custom page"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "index": 1,
  "name": "Custom Page 1",
  "icon": "fiber_new",
  "id": "cp.cp1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "index": {
      "type": "number",
      "description": "Index of the tab on which the custom will be displayed"
    },
    "name": {
      "type": "string",
      "description": "Name of the custom page"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the custom page"
    },
    "id": {
      "type": "string",
      "description": "ID of the custom page, starts with 'cp.'"
    }
  }
}

Custom Page

Get custom page
GET/admin/custom-page/{customPageId}

Gets a specific custom page


πŸ”’ Required privileges : Govern manager

Example URI

GET /admin/custom-page/cp.cp1
URI Parameters
HideShow
customPageId
string (required) Example: cp.cp1

the ID of the custom page

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "index": 1,
  "name": "Custom Page 1",
  "icon": "fiber_new",
  "id": "cp.cp1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "index": {
      "type": "number",
      "description": "Index of the tab on which the custom will be displayed"
    },
    "name": {
      "type": "string",
      "description": "Name of the custom page"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the custom page"
    },
    "id": {
      "type": "string",
      "description": "ID of the custom page, starts with 'cp.'"
    }
  }
}

Save custom page
PUT/admin/custom-page/{customPageId}

Saves a custom page


πŸ”’ Required privileges : Govern manager

Example URI

PUT /admin/custom-page/cp.cp2
URI Parameters
HideShow
customPageId
string (required) Example: cp.cp2

The custom page ID

Request
HideShow
Headers
Content-Type: application/json
Body
{
  "index": 1,
  "name": "Custom Page 1",
  "icon": "fiber_new",
  "id": "cp.cp1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "index": {
      "type": "number",
      "description": "Index of the tab on which the custom will be displayed"
    },
    "name": {
      "type": "string",
      "description": "Name of the custom page"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the custom page"
    },
    "id": {
      "type": "string",
      "description": "ID of the custom page, starts with 'cp.'"
    }
  }
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "index": 1,
  "name": "Custom Page 1",
  "icon": "fiber_new",
  "id": "cp.cp1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "index": {
      "type": "number",
      "description": "Index of the tab on which the custom will be displayed"
    },
    "name": {
      "type": "string",
      "description": "Name of the custom page"
    },
    "icon": {
      "type": "string",
      "description": "Icon of the custom page"
    },
    "id": {
      "type": "string",
      "description": "ID of the custom page, starts with 'cp.'"
    }
  }
}

Delete custom page
DELETE/admin/custom-page/{customPageId}

Deletes a custom page


πŸ”’ Required privileges : Govern manager

Example URI

DELETE /admin/custom-page/cp.cp2
URI Parameters
HideShow
customPageId
string (required) Example: cp.cp2

The custom page ID

Response  200
HideShow
Headers
Content-Type: application/json

Generated by aglio on 14 Jun 2024