Replace the conditions on an errand's approval

curl --request PUT \
  --url https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions \
  --header 'Content-Type: application/json' \
  --header 'x-sumvin-pint-token: <api-key>' \
  --data '
{
  "conditions": [
    {
      "type": "<string>",
      "target_price": 123,
      "currency": "USD"
    }
  ]
}
'

import requests

url = "https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions"

payload = { "conditions": [
        {
            "type": "<string>",
            "target_price": 123,
            "currency": "USD"
        }
    ] }
headers = {
    "x-sumvin-pint-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'x-sumvin-pint-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({conditions: [{type: '<string>', target_price: 123, currency: 'USD'}]})
};

fetch('https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions', 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}/conditions",
  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([
    'conditions' => [
        [
                'type' => '<string>',
                'target_price' => 123,
                'currency' => 'USD'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-sumvin-pint-token: <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}/conditions"

	payload := strings.NewReader("{\n  \"conditions\": [\n    {\n      \"type\": \"<string>\",\n      \"target_price\": 123,\n      \"currency\": \"USD\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-sumvin-pint-token", "<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}/conditions")
  .header("x-sumvin-pint-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conditions\": [\n    {\n      \"type\": \"<string>\",\n      \"target_price\": 123,\n      \"currency\": \"USD\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-sumvin-pint-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conditions\": [\n    {\n      \"type\": \"<string>\",\n      \"target_price\": 123,\n      \"currency\": \"USD\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "_links": {},
  "intent": {
    "id": "<string>",
    "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": "<string>",
        "target_price": "<string>",
        "currency": "USD"
      }
    ],
    "monitor_until": 123,
    "clarification_questions": [
      "<string>"
    ],
    "failure_reason": "<string>",
    "pint_uris": [
      "<string>"
    ],
    "updated_at": 123,
    "completed_at": 123,
    "capacity": {
      "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>",
        "created_at": 123,
        "payload": "<string>"
      }
    ],
    "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": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "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"
}

PUT

user

ipa

{ipa_id}

conditions

Replace the conditions on an errand's approval

curl --request PUT \
  --url https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions \
  --header 'Content-Type: application/json' \
  --header 'x-sumvin-pint-token: <api-key>' \
  --data '
{
  "conditions": [
    {
      "type": "<string>",
      "target_price": 123,
      "currency": "USD"
    }
  ]
}
'

import requests

url = "https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions"

payload = { "conditions": [
        {
            "type": "<string>",
            "target_price": 123,
            "currency": "USD"
        }
    ] }
headers = {
    "x-sumvin-pint-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'x-sumvin-pint-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({conditions: [{type: '<string>', target_price: 123, currency: 'USD'}]})
};

fetch('https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions', 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}/conditions",
  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([
    'conditions' => [
        [
                'type' => '<string>',
                'target_price' => 123,
                'currency' => 'USD'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-sumvin-pint-token: <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}/conditions"

	payload := strings.NewReader("{\n  \"conditions\": [\n    {\n      \"type\": \"<string>\",\n      \"target_price\": 123,\n      \"currency\": \"USD\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-sumvin-pint-token", "<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}/conditions")
  .header("x-sumvin-pint-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conditions\": [\n    {\n      \"type\": \"<string>\",\n      \"target_price\": 123,\n      \"currency\": \"USD\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sumvin.com/v0/user/ipa/{ipa_id}/conditions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-sumvin-pint-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conditions\": [\n    {\n      \"type\": \"<string>\",\n      \"target_price\": 123,\n      \"currency\": \"USD\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "_links": {},
  "intent": {
    "id": "<string>",
    "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": "<string>",
        "target_price": "<string>",
        "currency": "USD"
      }
    ],
    "monitor_until": 123,
    "clarification_questions": [
      "<string>"
    ],
    "failure_reason": "<string>",
    "pint_uris": [
      "<string>"
    ],
    "updated_at": 123,
    "completed_at": 123,
    "capacity": {
      "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>",
        "created_at": 123,
        "payload": "<string>"
      }
    ],
    "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": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "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

x-sumvin-pint-token

string

header

required

PINT (Purchase Intent) token — a JWT issued via POST /v0/sis/token/pint that encodes user-level consent for a specific scope. Sent in the x-sumvin-pint-token header alongside or instead of an x-juno-jwt JWT, depending on the integration surface (Platform vs SIS).

Headers

x-juno-orgid

string | null

Tenant org ID for multi-tenant auth

x-sumvin-token

string | null

x-sumvin-pat

string | null

x-juno-jwt

string | null

X-Timestamp-Format

string

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

ipa_id

string

required

Body

application/json

The complete condition set for this errand's approval.

Replaces whatever conditions the unsigned payload carried before. An empty list strips every condition.

conditions

The complete set of conditions the purchase must satisfy to proceed. Replaces any previously supplied conditions; an empty list removes them all. Each condition is written into the payload you sign, and into its plain-language summary.

Maximum array length: 32

Auto-execute when the lowest offer price satisfies a comparison against a target.

Show child attributes

Response

Payload to sign, carrying exactly the supplied conditions

_links

Links · object

required

HAL-style hypermedia links for navigation and available actions.

Show child attributes

intent

IPAData · object

required

Show child attributes

⌘I

Introduction

Quickstarts

Guides

Product Guides

API Reference

Replace the conditions on an errand's approval

Authorizations

Headers

Path Parameters

Body

Response