Skip to main content

Update a Subscription

This API updates a trigger subscription in IdentityNow, using a full object representation. In other words, the existing Subscription is completely replaced. The following fields are immutable:

  • id

  • triggerId

Attempts to modify these fields result in 400.

Path Parameters
  • id string required

    Subscription ID

    Example: 0f11f2a4-7c94-4bf3-a2bd-742580fe3bde
Request Body required
  • name string

    Subscription name.

  • description string

    Subscription description.

  • type string

    Possible values: [HTTP, EVENTBRIDGE]

    Subscription type. NOTE If type is EVENTBRIDGE, then eventBridgeConfig is required. If type is HTTP, then httpConfig is required.

  • responseDeadline string

    Default value: PT1H

    Deadline for completing REQUEST_RESPONSE trigger invocation, represented in ISO-8601 duration format.

  • httpConfig object

    Config required if HTTP subscription type is used.

  • url string required

    URL of the external/custom integration.

  • httpDispatchMode string required

    Possible values: [SYNC, ASYNC, DYNAMIC]

    HTTP response modes, i.e. SYNC, ASYNC, or DYNAMIC.

  • httpAuthenticationType string

    Possible values: [NO_AUTH, BASIC_AUTH, BEARER_TOKEN]

    Default value: NO_AUTH

    Defines the HTTP Authentication type. Additional values may be added in the future.

    If NO_AUTH is selected, no extra information will be in HttpConfig.

    If BASIC_AUTH is selected, HttpConfig will include BasicAuthConfig with Username and Password as strings.

    If BEARER_TOKEN is selected, HttpConfig will include BearerTokenAuthConfig with Token as string.

  • basicAuthConfig object

    Config required if BASIC_AUTH is used.

  • userName string

    The username to authenticate.

  • password string

    The password to authenticate. On response, this field is set to null as to not return secrets.

  • bearerTokenAuthConfig object

    Config required if BEARER_TOKEN authentication is used. On response, this field is set to null as to not return secrets.

  • bearerToken string

    Bearer token

  • eventBridgeConfig object

    Config required if EVENTBRIDGE subscription type is used.

  • awsAccount string required

    AWS Account Number (12-digit number) that has the EventBridge Partner Event Source Resource.

  • awsRegion string required

    AWS Region that has the EventBridge Partner Event Source Resource. See https://docs.aws.amazon.com/general/latest/gr/rande.html for a full list of available values.

  • enabled boolean

    Default value: true

    Whether subscription should receive real-time trigger invocations or not.

    Test trigger invocations are always enabled regardless of this option.

  • filter string

    JSONPath filter to conditionally invoke trigger when expression evaluates to true.

Responses

Updated subscription.


Schema
  • id string

    Subscription ID.

  • name string

    Subscription name.

  • description string

    Subscription description.

  • triggerId string

    ID of trigger subscribed to.

  • triggerName string

    Trigger name of trigger subscribed to.

  • type string

    Possible values: [HTTP, EVENTBRIDGE]

    Subscription type. NOTE If type is EVENTBRIDGE, then eventBridgeConfig is required. If type is HTTP, then httpConfig is required.

  • responseDeadline string

    Default value: PT1H

    Deadline for completing REQUEST_RESPONSE trigger invocation, represented in ISO-8601 duration format.

  • httpConfig object

    Config required if HTTP subscription type is used.

  • url string

    URL of the external/custom integration.

  • httpDispatchMode string

    Possible values: [SYNC, ASYNC, DYNAMIC]

    HTTP response modes, i.e. SYNC, ASYNC, or DYNAMIC.

  • httpAuthenticationType string

    Possible values: [NO_AUTH, BASIC_AUTH, BEARER_TOKEN]

    Default value: NO_AUTH

    Defines the HTTP Authentication type. Additional values may be added in the future.

    If NO_AUTH is selected, no extra information will be in HttpConfig.

    If BASIC_AUTH is selected, HttpConfig will include BasicAuthConfig with Username and Password as strings.

    If BEARER_TOKEN is selected, HttpConfig will include BearerTokenAuthConfig with Token as string.

  • basicAuthConfig object

    Config required if BASIC_AUTH is used.

  • userName string

    The username to authenticate.

  • password string

    The password to authenticate. On response, this field is set to null as to not return secrets.

  • bearerTokenAuthConfig object

    Config required if BEARER_TOKEN authentication is used. On response, this field is set to null as to not return secrets.

  • bearerToken string

    Bearer token

  • eventBridgeConfig object

    Config required if EVENTBRIDGE subscription type is used.

  • awsAccount string

    AWS Account Number (12-digit number) that has the EventBridge Partner Event Source Resource.

  • awsRegion string

    AWS Region that has the EventBridge Partner Event Source Resource. See https://docs.aws.amazon.com/general/latest/gr/rande.html for a full list of available values.

  • enabled boolean

    Default value: true

    Whether subscription should receive real-time trigger invocations or not. Test trigger invocations are always enabled regardless of this option.

  • filter string

    JSONPath filter to conditionally invoke trigger when expression evaluates to true.

Loading...