Update target allocations
curl --request PUT \
--url https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"allocations": [
{
"sourceId": "0x1111111111111111111111111111111111111111111111111111111111111111",
"targetBps": 8000
}
],
"idleTargetBps": 2000
}
'import requests
url = "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy"
payload = {
"allocations": [
{
"sourceId": "0x1111111111111111111111111111111111111111111111111111111111111111",
"targetBps": 8000
}
],
"idleTargetBps": 2000
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
allocations: [
{
sourceId: '0x1111111111111111111111111111111111111111111111111111111111111111',
targetBps: 8000
}
],
idleTargetBps: 2000
})
};
fetch('https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'allocations' => [
[
'sourceId' => '0x1111111111111111111111111111111111111111111111111111111111111111',
'targetBps' => 8000
]
],
'idleTargetBps' => 2000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy"
payload := strings.NewReader("{\n \"allocations\": [\n {\n \"sourceId\": \"0x1111111111111111111111111111111111111111111111111111111111111111\",\n \"targetBps\": 8000\n }\n ],\n \"idleTargetBps\": 2000\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"allocations\": [\n {\n \"sourceId\": \"0x1111111111111111111111111111111111111111111111111111111111111111\",\n \"targetBps\": 8000\n }\n ],\n \"idleTargetBps\": 2000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"allocations\": [\n {\n \"sourceId\": \"0x1111111111111111111111111111111111111111111111111111111111111111\",\n \"targetBps\": 8000\n }\n ],\n \"idleTargetBps\": 2000\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "924c9b2d-3a9c-4b1a-b470-c73fc9b97c06",
"kind": "update_strategy",
"status": "submitted",
"vaultId": "d9902b20-6499-4465-a4c3-5d2208182f79",
"txHashes": [
"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
],
"error": null,
"createdAt": "2026-09-10T18:42:10.000Z",
"updatedAt": "2026-09-10T18:42:12.000Z"
}
}{
"error": "invalid_request",
"message": "allocation targets and idleTargetBps must total 10000"
}{
"error": "Unauthenticated request",
"message": "Missing or invalid bearer token"
}{
"error": "invalid_request",
"message": "allocation targets and idleTargetBps must total 10000"
}Vaults and Sources
Update MicroVault strategy
Sets the vault’s target allocation across idle base assets and admitted yield sources. Ground automation subsequently moves assets toward the new targets.
PUT
/
v2
/
microvaults
/
vaults
/
{vaultId}
/
strategy
Update target allocations
curl --request PUT \
--url https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"allocations": [
{
"sourceId": "0x1111111111111111111111111111111111111111111111111111111111111111",
"targetBps": 8000
}
],
"idleTargetBps": 2000
}
'import requests
url = "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy"
payload = {
"allocations": [
{
"sourceId": "0x1111111111111111111111111111111111111111111111111111111111111111",
"targetBps": 8000
}
],
"idleTargetBps": 2000
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
allocations: [
{
sourceId: '0x1111111111111111111111111111111111111111111111111111111111111111',
targetBps: 8000
}
],
idleTargetBps: 2000
})
};
fetch('https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'allocations' => [
[
'sourceId' => '0x1111111111111111111111111111111111111111111111111111111111111111',
'targetBps' => 8000
]
],
'idleTargetBps' => 2000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy"
payload := strings.NewReader("{\n \"allocations\": [\n {\n \"sourceId\": \"0x1111111111111111111111111111111111111111111111111111111111111111\",\n \"targetBps\": 8000\n }\n ],\n \"idleTargetBps\": 2000\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"allocations\": [\n {\n \"sourceId\": \"0x1111111111111111111111111111111111111111111111111111111111111111\",\n \"targetBps\": 8000\n }\n ],\n \"idleTargetBps\": 2000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.groundtech.co/v2/microvaults/vaults/{vaultId}/strategy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"allocations\": [\n {\n \"sourceId\": \"0x1111111111111111111111111111111111111111111111111111111111111111\",\n \"targetBps\": 8000\n }\n ],\n \"idleTargetBps\": 2000\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "924c9b2d-3a9c-4b1a-b470-c73fc9b97c06",
"kind": "update_strategy",
"status": "submitted",
"vaultId": "d9902b20-6499-4465-a4c3-5d2208182f79",
"txHashes": [
"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
],
"error": null,
"createdAt": "2026-09-10T18:42:10.000Z",
"updatedAt": "2026-09-10T18:42:12.000Z"
}
}{
"error": "invalid_request",
"message": "allocation targets and idleTargetBps must total 10000"
}{
"error": "Unauthenticated request",
"message": "Missing or invalid bearer token"
}{
"error": "invalid_request",
"message": "allocation targets and idleTargetBps must total 10000"
}Set target allocations across yield sources and idle USDC. Targets must total 10,000 basis points.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Unique key for this intended change. Reuse it only when retrying the identical request.
Required string length:
1 - 200Path Parameters
Ground identifier of the MicroVault. This is distinct from its onchain contract address.
Pattern:
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$Example:
"8f4c52d7-62ab-4db9-a964-92f481f6b851"
Body
application/json
Yield-source target allocations. Include each source that should have a nonzero target.
Show child attributes
Show child attributes
Target share of vault assets kept as unallocated base asset in basis points. This value plus all source targets must equal 10000.
Required range:
0 <= x <= 10000Response
The operation was accepted.
Asynchronous change accepted for submission and onchain confirmation.
Show child attributes
Show child attributes
Example:
{ "id": "924c9b2d-3a9c-4b1a-b470-c73fc9b97c06", "kind": "update_strategy", "status": "submitted", "vaultId": "d9902b20-6499-4465-a4c3-5d2208182f79", "txHashes": [ "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ], "error": null, "createdAt": "2026-09-10T18:42:10.000Z", "updatedAt": "2026-09-10T18:42:12.000Z" }