Create an XLM set trustline flags request

post

https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/xlm/set_trustline_flags

This endpoint creates a set trustline flags request for an XLM trustline.
Required role: RequestCreator.
This API can be made idempotent by generating an ID for the Request beforehand and passing it as the externalRequestId attribute

Body Params

fromAddressId

string

required

(Optional) ID of the address representing the issuer of the asset of the trustline. Should match an existing WhitelistedContractAddress

trustorInternalAddressId

string

address id of the account which established the trustline. Either trustorInternalAddressId or trustorWhitelistedAddressId shall be specified

trustorWhitelistedAddressId

string

id of the account which established the trustline. Either trustorInternalAddressId or trustorWhitelistedAddressId shall be specified

setFlags

array of strings

flags to set for the Trustline created by trustor, as list of XLM SetTrustlineFlagsOp Flags: ['AuthorizedFlag', 'AuthorizedToMaintainLiabilitiesFlag']

setFlags

clearFlags

array of strings

flags to clear for the Trustline created by trustor, as list of XLM SetTrustlineFlagsOp Flags: ['AuthorizedFlag', 'AuthorizedToMaintainLiabilitiesFlag', 'TrustlineClawbackEnabledFlag']

clearFlags

feeLimit

string

comment

string

externalRequestId

string

Identifier for the request in the user's system. This must be unique. Attempting to create a request with an existing externalRequestId will do nothing and return the originally created request

Responses

200A successful response.

400Bad Request: indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing)

401Unauthorized: indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource

403Forbidden: indicates that the server understands the request but refuses to authorize it

404Not Found: indicates that the server cannot find the requested resource

500Internal Server Error: indicates that the server encountered an unexpected condition that prevented it from fulfilling the request

503Service Unavailable: indicates that the server is not ready to handle the request.

defaultAn unexpected error response.