Skip to main content
POST
/
v0
/
insto
/
custody
/
tasks
Create task
curl --request POST \
  --url https://api.kraken.com/v0/insto/custody/tasks \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --header 'api-nonce: <api-key>' \
  --header 'api-otp: <api-key>' \
  --header 'api-sign: <api-key>' \
  --data '
{
  "instructions": [
    {
      "type": "update_subquorum",
      "version": 123,
      "vault_id": "<string>",
      "groups": [
        {
          "required": 123,
          "members": [
            "<string>"
          ],
          "id": "<string>"
        }
      ]
    }
  ],
  "org_iiban": "ABCD EFGH IJKL MNOP",
  "duration_seconds": 86400
}
'
{
  "task_id": "TABCDEF234567A",
  "approval_id": "550E8400-E29B-41D4-A716-446655440000"
}

Authorizations

​
api-key
string
header
required
​
api-sign
string
header
required
​
api-nonce
string
header
required
​
api-otp
string
header
required

Body

application/json
​
instructions
(update_subquorum · object | update_vault_user · object | update_vault_policy · object | request_withdrawal · object | remove_org_user · object | update_withdrawal_address · object)[]
required

The atomic instructions to bundle into the task. Each entry describes a single change and is one of the variants below, identified by its type field.

A single atomic instruction. The type field selects the variant and determines which other fields are required.

​
org_iiban
string

Organization IIBAN the task is created under.

Example:

"ABCD EFGH IJKL MNOP"

​
duration_seconds
number<double>

Optional task expiry, in seconds from creation.

Example:

86400

Response

Task created successfully. The instructions take effect asynchronously once the task is approved.

​
task_id
string
required

Identifier of the created task. A T-prefixed 14-char base32 string.

Example:

"TABCDEF234567A"

​
approval_id
string
required

Identifier of the approval flow associated with the task (UUID v4).

Example:

"550E8400-E29B-41D4-A716-446655440000"