Skip to main content

Update an action/automation

PUT 

/v1/actions/:action_identifier

This route allows you to update an existing self-service action or automation in your Port account.

To learn more about actions and automations, check out the documentation.

Request

Path Parameters

    action_identifier stringrequired

    Possible values: non-empty

    The identifier of the action/automation you want to update.

Body

required

    identifier stringrequired

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

    The identifier of the action/automation you want to update.

    title string

    The new title of the action/automation.

    icon string

    The new icon of the action/automation.

    description string

    The new description of the action/automation.

    trigger

    object

    required

    oneOf

    The trigger definition of the new action.

    operation stringrequired

    Possible values: [DAY-2, DELETE]

    The operation type of the action.

    type stringrequired

    Possible values: [self-service]

    blueprintIdentifier string

    The identifier of the blueprint that the action is associated with.
    Note that this is optional, as actions do not have to be tied directly to a blueprint.

    userInputs

    object

    required

    The user inputs of the action.

    oneOf

    Use this option when you don't want to define a custom order/steps for the user inputs.

    properties

    object

    required

    property name*

    object

    type required

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

    format

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

    blueprint string

    When using the entity format, this is the identifier of the blueprint whose entities will be selectable via this input.

    dependsOn string[]

    The identifiers of the inputs that this input depends on. This input will be disabled until they have been given a value.

    visible

    object

    The visibility of the input. Resolves to a boolean value (true = visible).

    oneOf

    jqQuery stringrequired

    A jq query that resolves to true or false, determining the visibility of the input.

    icon string

    The icon of the input.

    dataset

    object

    combinator stringrequired

    Possible values: [and, or]

    The combinator to use when calculating the rules.

    rules

    object[]

    required

    Possible values: >= 1

  • Array [

  • anyOf

    operator required

    Possible values: [isEmpty, isNotEmpty]

    property stringrequired
  • ]

  • sort

    object

    Relevant only for Entity selection inputs (type = string and format = entity).
    This input allows you to sort the entities in the dropdown by a specific property.

    property stringrequired

    The property by which to sort the entities.

    order stringrequired

    Possible values: [ASC, DESC]

    required

    object

    The action's user inputs that must be provided by the executed user.

    oneOf

    A jq query that runs on the action's inputs and resolves to a boolean value (true = required).

    jqQuery stringrequired

    condition

    object

    Filters used to include/exclude specific entities from the action.

    type stringrequired

    Possible values: [SEARCH]

    rules

    object[]

    required

    The rules used to filter entities.

  • Array [

  • anyOf

    property stringrequired
    operator required

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

    value numberrequired
  • ]

  • combinator stringrequired

    Possible values: [and, or]

    invocationMethod

    object

    required

    Details the action's backend type and details.

    oneOf

    type stringrequired

    Possible values: [KAFKA]

    payload object

    An object containing the action payload.

    requiredApproval

    object

    Determines whether the action requires approval before execution.
    Choose ALL to require all specified users to approve the action, or ANY to require only one.

    oneOf

    type stringrequired

    Possible values: [ANY, ALL]

    approvalNotification

    object

    The notification configuration for the approval process. Relevant only if requiredApproval is set to true.

    oneOf

    type stringrequired

    Possible values: [webhook]

    format string

    Possible values: [json, slack]

    url urirequired

    The URL of the webhook.

    type stringrequired

    Possible values: [webhook, email]

    Default value: email

    publish boolean

    If true, the action will be visible to all users and available for use.

Responses

Success

Loading...