Skip to main content

Check out Port for yourselfย 

Create a scorecard

POST 

/v1/blueprints/:blueprint_identifier/scorecards

This route allows you to create a scorecard for a given blueprint. A scorecard is a set of rules that define the quality of a blueprint.

To learn more about scorecards, check out the documentation.

Requestโ€‹

Path Parameters

    blueprint_identifier stringrequired

    Possible values: non-empty

    The identifier of the blueprint you want to run scorecards for.

Body

required

    identifierstringrequired

    A unique identifier for the scorecard.

    Possible values: Value must match regular expression ^[A-Za-z0-9@_.:\\/=-]+$

    titlestringrequired

    The title of the scorecard.

    filter

    object

    An optional set of conditions to filter entities that will be evaluated by the scorecard.

    combinatorstringrequired

    The combinator to use when evaluating the conditions.

    Possible values: [and, or]

    conditions

    object[]

    required

    Possible values: >= 1

    The conditions to evaluate.

  • Array [

  • anyOf

    propertystringrequired
    operatorrequired

    Possible values: [between, notBetween, =]

    value

    object

    required

    oneOf

    fromdate-timerequired
    todate-timerequired
  • ]

  • rules

    object[]

    required

    The rules that define the scorecard.

  • Array [

  • identifierstringrequired

    Possible values: Value must match regular expression ^[A-Za-z0-9@_=\\-]+$

    titlestringrequired
    descriptionstring
    levelstringrequired

    Possible values: [Gold, Silver, Bronze]

    query

    object

    required

    combinatorstringrequired

    Possible values: [and, or]

    conditions

    object[]

    required

    Possible values: >= 1

  • Array [

  • anyOf

    propertystringrequired
    operatorrequired

    Possible values: [between, notBetween, =]

    value

    object

    required

    oneOf

    fromdate-timerequired
    todate-timerequired
  • ]

  • ]

  • levels

    object[]

    The available levels of the new scorecard, each with its own name and color.

  • Array [

  • titlestringrequired

    The name of the level.

    colorstringrequired

    The color associated with the level, for visualization in Port's UI.

    Possible values: [blue, turquoise, orange, purple, pink, yellow, green, red, gold, silver, paleBlue, darkGray, lightGray, bronze]

  • ]

Responsesโ€‹

Default Response