Skip to main content

Patch a target

PATCH 
/resources/v3alpha/actions/targets/:id

Patch an existing target.

Request​

Path Parameters

    id stringrequired

Query Parameters

    instance.id string
    instance.domain string

Body

required

    name string

    Possible values: non-empty and <= 1000 characters

    restWebhook

    object

    Wait for response but response body is ignored, status is checked, call is sent as post.

    interruptOnError boolean

    Define if any error stops the whole execution. By default the process continues as normal.

    restCall

    object

    Wait for response and response body is used, status is checked, call is sent as post.

    interruptOnError boolean

    Define if any error stops the whole execution. By default the process continues as normal.

    restAsync object

    Call is executed in parallel to others, ZITADEL does not wait until the call is finished. The state is ignored, call is sent as post.

    timeout string

    if the target doesn't respond before this timeout expires, the the connection is closed and the action fails

    endpoint string

    Possible values: non-empty and <= 1000 characters

    expirationSigningKey string

    Regenerate the key used for signing and checking the payload sent to the target. Set the graceful period for the existing key. During that time, the previous signing key and the new one will be used to sign the request to allow you a smooth transition onf your API.

    Note that we currently only allow an immediate rotation ("0s") and will support longer expirations in the future.

Responses​

Target successfully updated or left unchanged

Schema

    details

    object

    id string
    created date-time

    the timestamp of the first event applied to the object.

    changed date-time

    the timestamp of the last event applied to the object.

    owner

    object

    the parent object representing the returned objects context.

    type string

    Possible values: [OWNER_TYPE_UNSPECIFIED, OWNER_TYPE_SYSTEM, OWNER_TYPE_INSTANCE, OWNER_TYPE_ORG]

    Default value: OWNER_TYPE_UNSPECIFIED

    id string
    signingKey string

    Key used to sign and check payload sent to the target.

Loading...