Skip to content

IAM  >  Operations  >  send_delegation_token

send_delegation_token

Operation

send_delegation_token async

send_delegation_token(input: SendDelegationTokenInput, plugins: list[Plugin] | None = None) -> SendDelegationTokenOutput

Sends the exchange token for an accepted delegation request.

The exchange token is sent to the partner via an asynchronous notification channel, established by the partner.

The delegation request must be in the ACCEPTED state when calling this API. After the SendDelegationToken API call is successful, the request transitions to a FINALIZED state and cannot be rolled back. However, a user may reject an accepted request before the SendDelegationToken API is called.

For more details, see Managing Permissions for Delegation Requests.

Parameters:

Name Type Description Default
input SendDelegationTokenInput

An instance of SendDelegationTokenInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
SendDelegationTokenOutput

An instance of SendDelegationTokenOutput.

Input

SendDelegationTokenInput dataclass

Bases: _SerdeShape

Dataclass for SendDelegationTokenInput structure.

Attributes

delegation_request_id class-attribute instance-attribute
delegation_request_id: str | None = ...

The unique identifier of the delegation request for which to send the token.

Output

SendDelegationTokenOutput dataclass

Bases: _SerdeShape

Dataclass for SendDelegationTokenOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.