Interface UpdateApprovalActionRequest.Builder

  • Method Details

    • agentSpaceId

      UpdateApprovalActionRequest.Builder agentSpaceId(String agentSpaceId)

      The agent space identifier — multi-tenant workspace scope. Bound from the request URI.

      Parameters:
      agentSpaceId - The agent space identifier — multi-tenant workspace scope. Bound from the request URI.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • approvalId

      Identifier of the approval request being resolved. A UUID. Bound from the request URI.

      Parameters:
      approvalId - Identifier of the approval request being resolved. A UUID. Bound from the request URI.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • action

      The action to take on the approval request — APPROVED or REJECTED.

      Parameters:
      action - The action to take on the approval request — APPROVED or REJECTED.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • action

      The action to take on the approval request — APPROVED or REJECTED.

      Parameters:
      action - The action to take on the approval request — APPROVED or REJECTED.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • finalPattern

      The finalized pattern (tool + argumentPins) that scopes the approval. Required when `action` is APPROVED; must be absent when `action` is REJECTED. The pattern narrows, and must not widen, the invocation originally requested by the agent. This cross-field invariant is enforced by service-side validation.

      Parameters:
      finalPattern - The finalized pattern (tool + argumentPins) that scopes the approval. Required when `action` is APPROVED; must be absent when `action` is REJECTED. The pattern narrows, and must not widen, the invocation originally requested by the agent. This cross-field invariant is enforced by service-side validation.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • finalPattern

      The finalized pattern (tool + argumentPins) that scopes the approval. Required when `action` is APPROVED; must be absent when `action` is REJECTED. The pattern narrows, and must not widen, the invocation originally requested by the agent. This cross-field invariant is enforced by service-side validation.

      This is a convenience method that creates an instance of the ApprovalPattern.Builder avoiding the need to create one manually via ApprovalPattern.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to finalPattern(ApprovalPattern).

      Parameters:
      finalPattern - a consumer that will call methods on ApprovalPattern.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • reason

      Optional free-text rationale for the decision. Permitted when `action` is REJECTED; ignored when `action` is APPROVED.

      Parameters:
      reason - Optional free-text rationale for the decision. Permitted when `action` is REJECTED; ignored when `action` is APPROVED.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • ttlSeconds

      Approval lifetime in seconds, starting from when the decision is submitted. Required when `action` is APPROVED AND `singleUse` is false; must be absent when `action` is REJECTED or when `singleUse` is true (a single-use approval backs one executed action and the redemption window collapses). Cross-field invariants are enforced by service-side validation; the @range bound here is the operation-boundary check that always applies (a maximum of 4 hours).

      Parameters:
      ttlSeconds - Approval lifetime in seconds, starting from when the decision is submitted. Required when `action` is APPROVED AND `singleUse` is false; must be absent when `action` is REJECTED or when `singleUse` is true (a single-use approval backs one executed action and the redemption window collapses). Cross-field invariants are enforced by service-side validation; the @range bound here is the operation-boundary check that always applies (a maximum of 4 hours).
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • singleUse

      Whether the approved action backs a single executed tool call (true) or is reusable within ttlSeconds (false). Required when `action` is APPROVED; must be absent when `action` is REJECTED. When true, ttlSeconds must be absent (the redemption window collapses to the single use). When false, ttlSeconds is required and bounds the reuse window. Cross-field invariants are enforced by service-side validation.

      Parameters:
      singleUse - Whether the approved action backs a single executed tool call (true) or is reusable within ttlSeconds (false). Required when `action` is APPROVED; must be absent when `action` is REJECTED. When true, ttlSeconds must be absent (the redemption window collapses to the single use). When false, ttlSeconds is required and bounds the reuse window. Cross-field invariants are enforced by service-side validation.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • overrideConfiguration

      UpdateApprovalActionRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)
      Description copied from interface: AwsRequest.Builder
      Add an optional request override configuration.
      Specified by:
      overrideConfiguration in interface AwsRequest.Builder
      Parameters:
      overrideConfiguration - The override configuration.
      Returns:
      This object for method chaining.
    • overrideConfiguration

      Description copied from interface: AwsRequest.Builder
      Add an optional request override configuration.
      Specified by:
      overrideConfiguration in interface AwsRequest.Builder
      Parameters:
      builderConsumer - A Consumer to which an empty AwsRequestOverrideConfiguration.Builder will be given.
      Returns:
      This object for method chaining.