Ask the networks again what a vault holds

POST

/v1/vaults/{id}/refresh

const url = 'https://api.sotirea.com/v1/vaults/1/refresh';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.sotirea.com/v1/vaults/1/refresh \
  --header 'Authorization: Bearer <token>'

Each network the vault is on is asked again what reached and left it, through the same path as every deposit, so anything missed is found and counted; nothing is ever written to a balance any other way. Answers 202 at once, one refresh per network; follow each with GET /v1/refreshes/{id}.

Authorizations

bearer

Parameters

Path Parameters

required

integer

The vault’s id.

Responses

202

Done.

application/json

object

data

required

Array<object>

object

chain_id

required

string

completed_at

required

Any of:

string
null

string format: date-time

discrepancies

required

How many it found different from what Sotirea had counted.

integer

required

Follow it with GET /v1/refreshes/{id}.

string

requested_at

required

string format: date-time

status

required

Requested until the network has answered, then answered; failed if it could not be asked, expired if it never answered.

string

targets

required

How many addresses it asked about.

integer

meta

object

request_id

Quote it when asking about a request; it is in the X-Request-Id header too.

string

success

required

Example

{
  "success": true
}

default

Refused or failed, in words a person can act on.

application/json

object

error

required

object

code

required

string

fields

object

key

additional properties

string

message

required

string

meta

object

request_id

Quote it when asking about a request.

string

success

required

Example

{
  "success": false
}