Approve or decline an errand's purchase
curl --request PUT \
--url https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision \
--header 'Content-Type: application/json' \
--header 'x-juno-jwt: <api-key>' \
--data '
{
"signature": "<string>"
}
'import requests
url = "https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision"
payload = { "signature": "<string>" }
headers = {
"x-juno-jwt": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-juno-jwt': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({signature: '<string>'})
};
fetch('https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision', 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://api.sumvin.com/v0/user/ipa/{ipa_id}/decision",
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([
'signature' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-juno-jwt: <api-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://api.sumvin.com/v0/user/ipa/{ipa_id}/decision"
payload := strings.NewReader("{\n \"signature\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-juno-jwt", "<api-key>")
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://api.sumvin.com/v0/user/ipa/{ipa_id}/decision")
.header("x-juno-jwt", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"signature\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-juno-jwt"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"signature\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"_links": {},
"intent": {
"id": "<string>",
"intent_type": "product",
"status": "qualifying",
"autonomy_level": "supervised",
"created_at": 123,
"raw_intent": "<string>",
"specification": "<string>",
"constraints": {
"max_price": 123,
"max_total": 123,
"currency": "<string>",
"deadline": 123,
"preferred_sellers": [
"<string>"
],
"excluded_sellers": [
"<string>"
],
"extra": {}
},
"conditions": [
{
"type": "price_target",
"operator": "lte",
"target_price": "<string>",
"currency": "USD"
}
],
"monitor_until": 123,
"clarification_questions": [
"<string>"
],
"failure_reason": "<string>",
"pint_uris": [
"<string>"
],
"updated_at": 123,
"completed_at": 123,
"capacity": {
"limit_status": "no_amount_authorized",
"consumed": "<string>",
"reserved": "<string>",
"enforcement_mode": "<string>",
"mandate_pint_uri": "<string>",
"max_amount": "<string>",
"remaining": "<string>",
"asset": "<string>"
},
"manifest_summary": {
"id": "<string>",
"status": "<string>",
"item_count": 123,
"total_amount": "<string>",
"total_asset": "<string>",
"approved_at": 123,
"purchased_at": 123
},
"preflight_workflow_id": "<string>",
"originating_agent_task": {
"id": "<string>",
"status": "<string>",
"trigger_type": "<string>",
"created_at": 123,
"workflow_run_id": "<string>",
"task": "<string>",
"title": "<string>",
"started_at": 123,
"completed_at": 123
},
"executing_agent_task": {
"id": "<string>",
"status": "<string>",
"trigger_type": "<string>",
"created_at": 123,
"workflow_run_id": "<string>",
"task": "<string>",
"title": "<string>",
"started_at": 123,
"completed_at": 123
},
"candidates": [
{
"id": "<string>",
"offer_id": "<string>",
"status": "<string>",
"created_at": 123,
"rank": 123,
"score": 123,
"rejection_reason": "<string>"
}
],
"manifests": [
{
"id": "<string>",
"status": "<string>",
"items": [
{
"offer_id": "<string>",
"quantity": 123,
"unit_price_amount": "<string>",
"unit_price_asset": "<string>"
}
],
"created_at": 123,
"total_amount": "<string>",
"total_asset": "<string>",
"approved_at": 123,
"purchased_at": 123
}
],
"events": [
{
"id": "<string>",
"event_type": "ipa.status_change",
"created_at": 123,
"payload": {}
}
],
"approval_payload": {
"types": {},
"primaryType": "<string>",
"domain": {
"name": "<string>",
"version": "<string>",
"chainId": 123,
"verifyingContract": "<string>"
},
"message": {
"wallet": "<string>",
"nonce": 123,
"statement": "<string>",
"scopes": [
"<string>"
],
"resources": [
"<string>"
],
"maxAmount": 123,
"maxAmountToken": "<string>",
"expiresAt": 123,
"conditions": [
"<string>"
]
}
}
}
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}IPA
Approve or decline an errand's purchase
Records the decision on this errand’s purchase. Approving requires the signature over the payload prepared for the errand — fetch it with ?expand=mandate, sign it with the wallet on the account, and send the signature here. What the purchase is bounded by is read from that signed payload, so an approval always means exactly what was signed. Declining is final and needs no signature.
PUT
/
v0
/
user
/
ipa
/
{ipa_id}
/
decision
Approve or decline an errand's purchase
curl --request PUT \
--url https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision \
--header 'Content-Type: application/json' \
--header 'x-juno-jwt: <api-key>' \
--data '
{
"signature": "<string>"
}
'import requests
url = "https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision"
payload = { "signature": "<string>" }
headers = {
"x-juno-jwt": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-juno-jwt': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({signature: '<string>'})
};
fetch('https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision', 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://api.sumvin.com/v0/user/ipa/{ipa_id}/decision",
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([
'signature' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-juno-jwt: <api-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://api.sumvin.com/v0/user/ipa/{ipa_id}/decision"
payload := strings.NewReader("{\n \"signature\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-juno-jwt", "<api-key>")
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://api.sumvin.com/v0/user/ipa/{ipa_id}/decision")
.header("x-juno-jwt", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"signature\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sumvin.com/v0/user/ipa/{ipa_id}/decision")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-juno-jwt"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"signature\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"_links": {},
"intent": {
"id": "<string>",
"intent_type": "product",
"status": "qualifying",
"autonomy_level": "supervised",
"created_at": 123,
"raw_intent": "<string>",
"specification": "<string>",
"constraints": {
"max_price": 123,
"max_total": 123,
"currency": "<string>",
"deadline": 123,
"preferred_sellers": [
"<string>"
],
"excluded_sellers": [
"<string>"
],
"extra": {}
},
"conditions": [
{
"type": "price_target",
"operator": "lte",
"target_price": "<string>",
"currency": "USD"
}
],
"monitor_until": 123,
"clarification_questions": [
"<string>"
],
"failure_reason": "<string>",
"pint_uris": [
"<string>"
],
"updated_at": 123,
"completed_at": 123,
"capacity": {
"limit_status": "no_amount_authorized",
"consumed": "<string>",
"reserved": "<string>",
"enforcement_mode": "<string>",
"mandate_pint_uri": "<string>",
"max_amount": "<string>",
"remaining": "<string>",
"asset": "<string>"
},
"manifest_summary": {
"id": "<string>",
"status": "<string>",
"item_count": 123,
"total_amount": "<string>",
"total_asset": "<string>",
"approved_at": 123,
"purchased_at": 123
},
"preflight_workflow_id": "<string>",
"originating_agent_task": {
"id": "<string>",
"status": "<string>",
"trigger_type": "<string>",
"created_at": 123,
"workflow_run_id": "<string>",
"task": "<string>",
"title": "<string>",
"started_at": 123,
"completed_at": 123
},
"executing_agent_task": {
"id": "<string>",
"status": "<string>",
"trigger_type": "<string>",
"created_at": 123,
"workflow_run_id": "<string>",
"task": "<string>",
"title": "<string>",
"started_at": 123,
"completed_at": 123
},
"candidates": [
{
"id": "<string>",
"offer_id": "<string>",
"status": "<string>",
"created_at": 123,
"rank": 123,
"score": 123,
"rejection_reason": "<string>"
}
],
"manifests": [
{
"id": "<string>",
"status": "<string>",
"items": [
{
"offer_id": "<string>",
"quantity": 123,
"unit_price_amount": "<string>",
"unit_price_asset": "<string>"
}
],
"created_at": 123,
"total_amount": "<string>",
"total_asset": "<string>",
"approved_at": 123,
"purchased_at": 123
}
],
"events": [
{
"id": "<string>",
"event_type": "ipa.status_change",
"created_at": 123,
"payload": {}
}
],
"approval_payload": {
"types": {},
"primaryType": "<string>",
"domain": {
"name": "<string>",
"version": "<string>",
"chainId": 123,
"verifyingContract": "<string>"
},
"message": {
"wallet": "<string>",
"nonce": 123,
"statement": "<string>",
"scopes": [
"<string>"
],
"resources": [
"<string>"
],
"maxAmount": 123,
"maxAmountToken": "<string>",
"expiresAt": 123,
"conditions": [
"<string>"
]
}
}
}
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}{
"detail": "No wallet found with ID 12345 for this user.",
"error_code": "WAL-404-001",
"instance": "/v0/wallets/12345",
"status": 404,
"title": "Wallet Not Found",
"trace_id": "abc123-def456-ghi789",
"type": "https://api.sumvin.com/errors/wal-404-001"
}Authorizations
JunoJWTSumvinPAT
Session JWT from the identity provider that signed the user in — Dynamic Labs, Privy, or Clerk (consumer sign-in). Send it in the x-juno-jwt header on every authenticated request. An Authorization: Bearer <jwt> header carrying the same JWT is also accepted, and takes precedence when both are present.
Headers
Tenant org ID for multi-tenant auth
Controls how timestamp fields are serialized in JSON response bodies.
Default (header omitted or any other value): epoch milliseconds as integers.
iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.
Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".
Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.
Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.
Example:
"iso8601"
Path Parameters
Body
application/json
A decision on an errand's purchase, and the signature that authorises it.
Approving requires the signature over the payload prepared for this errand. What the purchase is bounded by — its ceiling, its conditions, its deadline — is read from that signed payload, never from this request: an approval must mean exactly what was signed. Declining needs no signature.
Whether to approve or decline this errand's purchase.
Available options:
approved, rejected, conditional The signature over the payload prepared for this errand, as returned by your wallet. Required to approve; omit it to decline.
Pattern:
^0x[0-9a-fA-F]{130}$