Skip to main content

Create a blueprint

POST 

/v1/blueprints

This route allows you to create a new blueprint in your data model.

To learn more about blueprints, check out the documentation.

Request

Body

required

    identifier stringrequired

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

    The identifier of the new blueprint.

    title stringrequired

    Possible values: <= 30 characters

    The title of the new blueprint.

    description string

    Possible values: <= 200 characters

    The description of the new blueprint.

    icon string

    The icon of the new blueprint.

    teamInheritance

    object

    A relation to another blueprint from which to inherit the team. Can be any blueprint connected to this one via any number of relations. path is the path to the desired blueprint via relations, for example: "relationIdentifier.relationIdentifierInRelatedBlueprint"

    path stringrequired

    schema

    object

    required

    The schema of the new blueprint, see properties and required below for more information.

    properties

    object

    required

    The properties of the new blueprint.

    property name*

    object

    title string

    The title of the property.

    description string

    The description of the property.

    icon string

    The icon of the property.

    type required

    Possible values: [string, number, boolean, object, array]

    The type of the property.

    format

    Possible values: [date-time, url, email, ipv4, ipv6, markdown, yaml, user, team, timer, proto]

    The type's format.

    spec

    Possible values: [open-api, embedded-url, async-api]

    The spec of the property.

    required string[]

    The required properties of the blueprint, these must be provided when creating an entity based on this blueprint. This is an array of the required properties' identifiers.

    calculationProperties

    object

    The calculation properties of the new blueprint.

    property name*

    object

    title string
    description string
    icon string
    calculation stringrequired
    type required

    Possible values: [string, number, boolean, object, array]

    format

    Possible values: [date-time, url, email, ipv4, ipv6, markdown, yaml, user, team, proto]

    spec

    Possible values: [open-api, embedded-url, async-api]

    colorized boolean
    colors object

    items

    object

    type

    Possible values: [string, number, boolean, object, array]

    format

    Possible values: [date-time, url, email, ipv4, ipv6, markdown, yaml, user, team, timer, proto]

    mirrorProperties

    object

    The mirror properties of the new blueprint.

    property name*

    object

    path stringrequired

    Possible values: Value must match regular expression ^(?:[A-Za-z0-9@_=\-]+\.)+?(\w|\$|@|-)*?[^\.]+$

    title string

    aggregationProperties

    object

    The aggregation properties of the new blueprint.

    property name*

    object

    title stringrequired
    description string
    icon string
    type

    Possible values: [number]

    Default value: number

    target stringrequired

    calculationSpec

    object

    required

    oneOf

    query

    object

    combinator required

    Possible values: [and, or]

    rules

    object[]

    required

  • Array [

  • anyOf

    property stringrequired
    operator required

    Possible values: [>, >=, <, <=]

    value numberrequired
  • ]

  • relations

    object

    The relations of the new blueprint.

    property name*

    object

    title string
    target stringrequired
    required booleanrequired
    many booleanrequired
    description string

    changelogDestination

    object

    The destination of the blueprint's changelog.

    oneOf

    type stringrequired

    Possible values: [WEBHOOK]

    agent boolean

    If true, Port's execution agent will be used to send the changelog.

    url urirequired

    The URL of the webhook.

Responses

Default Response

Loading...