KeelsonDocs
    Judge Mode

    API reference Bonds

    Queue a bond withdrawal, gasless

    POST/v1/bonds/{agentId}/withdrawals

    Relays requestWithdrawal; the funds stay slashable until the withdrawal delay ends and it is completed.

    Path parameters

    agentIdstringRequired
    The ERC-8004 agent id, a decimal integer.

    Headers

    Content-Typeapplication/jsonRequired
    idempotency-keystringRequired
    Idempotency-KeystringRequired
    1 to 255 characters. A retry with the same key returns the first answer.

    Request body

    application/json

    chainIdone ofRequired
    Arbitrum Sepolia (421614) or Arbitrum One (42161).
    amountstringRequired
    PYUSD base units.
    tostringRequired
    noncestringRequired
    vault.nonces(signer).
    deadlinestringRequired
    Unix seconds.
    ownerSignaturestringRequired
    The vault's EIP-712 WithdrawalRequest, by the agent's owner or agent wallet.

    Responses

    • 200Confirmed on-chain
    • 202Sent and not yet confirmed; poll Location
    • 401No valid credentials
    • 403Not allowed
    • 409The same call was submitted with other arguments
    • 422Invalid, or the call reverts: error names the contract's custom error
    • 503The relayer cannot send now: chain unavailable, gas price cap or low balance

    200 response

    idstringRequired
    chainIdintegerRequired
    keystringRequired
    <contract>.<function>:<natural id>.
    contractstringRequired
    functionNamestringRequired
    statusstringRequired
    One of pendingconfirmedrevertedrejecteddropped
    hashstring
    noncestring
    blockNumberstring
    blockHashstring
    gasUsedstring
    effectiveGasPricestring
    latencyMsinteger
    errorCodestring
    errorobject
    explorerUrlstring