Skip to navigation

Create an vote delegation request

This endpoint creates an outgoing vote delegation request for ADA. Required role: RequestCreator. This API can be made idempotent by generating an ID for the Request beforehand and passing it as the externalRequestId attribute

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
fromAddressIdstringRequiredformat: "uint64"

uint64; The ID of the source address for funds.

drepstringRequired

string; Delegate representative: can be either 'ABSTAIN' (votes don't count), 'NOCONFIDENCE' (always vote against proposals) or an address (format drep1....).

feeLimitstringOptional

numeric; Maximum amount of fees to be paid for the transaction.

commentstringOptional

string; A reconciliation note can be given when initiating a request and this will be included in transaction history.

useUnconfirmedFundsbooleanOptional

bool; Allow use of unconfirmed funds for this transaction

externalRequestIdstringOptional

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.

Response

A successful response.
resultobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
503
Service Unavailable Error