Set up an Errand

curl -X POST https://api.sumvin.com/v0/user/ipa \
  -H "x-juno-jwt: <your-jwt-token>" \
  -H "x-juno-orgid: <your-org-id>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ipa-req-2026-04-16-0001" \
  -d '{
    "raw_intent": "Find me a pair of Nike Air Max 90 in size 10, under $150",
    "intent_type": "product",
    "autonomy_level": "approve_before_purchase",
    "constraints": { "max_price": 150.00, "currency": "USD" },
    "originating_chat_id": "chat_xyz789"
  }'

const res = await fetch("https://api.sumvin.com/v0/user/ipa", {
  method: "POST",
  headers: {
    "x-juno-jwt": process.env.SUMVIN_JWT!,
    "x-juno-orgid": process.env.SUMVIN_ORG_ID!,
    "Content-Type": "application/json",
    "Idempotency-Key": "ipa-req-2026-04-16-0001",
  },
  body: JSON.stringify({
    raw_intent: "Find me a pair of Nike Air Max 90 in size 10, under $150",
    intent_type: "product",
    autonomy_level: "approve_before_purchase",
    constraints: { max_price: 150.0, currency: "USD" },
    originating_chat_id: "chat_xyz789",
  }),
});
const { intent } = await res.json();

import httpx
import os

res = httpx.post(
    "https://api.sumvin.com/v0/user/ipa",
    headers={
        "x-juno-jwt": os.environ["SUMVIN_JWT"],
        "x-juno-orgid": os.environ["SUMVIN_ORG_ID"],
        "Idempotency-Key": "ipa-req-2026-04-16-0001",
    },
    json={
        "raw_intent": "Find me a pair of Nike Air Max 90 in size 10, under $150",
        "intent_type": "product",
        "autonomy_level": "approve_before_purchase",
        "constraints": {"max_price": 150.00, "currency": "USD"},
        "originating_chat_id": "chat_xyz789",
    },
)
intent = res.json()["intent"]

import { useCreateIPA } from '@sumvin/api-hooks';

function CreatePerpetualSearchButton() {
  const { mutate, isPending } = useCreateIPA();

  const handleCreate = () => {
    mutate({
      raw_intent: "Find me a pair of Nike Air Max 90 in size 10, under $150",
      intent_type: "product",
      autonomy_level: "approve_before_purchase",
      constraints: { max_price: 150.0, currency: "USD" },
    });
  };

  return <button onClick={handleCreate} disabled={isPending}>Create IPA</button>;
}

# 1. Fetch the payload prepared for this Errand
curl "https://api.sumvin.com/v0/user/ipa/ipa_1a2b3c4d?expand=mandate" \
  -H "x-juno-jwt: <your-jwt-token>" \
  -H "x-juno-orgid: <your-org-id>"

# 2. Sign intent.approval_payload with the account's wallet, then send it back
curl -X PUT https://api.sumvin.com/v0/user/ipa/ipa_1a2b3c4d/decision \
  -H "x-juno-jwt: <your-jwt-token>" \
  -H "x-juno-orgid: <your-org-id>" \
  -H "Content-Type: application/json" \
  -d '{ "decision": "approved", "signature": "0x<65-byte-signature>" }'

const headers = {
  "x-juno-jwt": process.env.SUMVIN_JWT!,
  "x-juno-orgid": process.env.SUMVIN_ORG_ID!,
  "Content-Type": "application/json",
};

// 1. Fetch the payload prepared for this Errand
const prepared = await fetch(
  "https://api.sumvin.com/v0/user/ipa/ipa_1a2b3c4d?expand=mandate",
  { headers },
);
const { intent: pending } = await prepared.json();

// 2. Sign it with the wallet on the account
const signature = await walletClient.request({
  method: "eth_signTypedData_v4",
  params: [account, JSON.stringify(pending.approval_payload)],
});

// 3. Send the decision and the signature that authorises it
const res = await fetch(
  "https://api.sumvin.com/v0/user/ipa/ipa_1a2b3c4d/decision",
  {
    method: "PUT",
    headers,
    body: JSON.stringify({ decision: "approved", signature }),
  },
);
const { intent } = await res.json();

import httpx
import os

headers = {
    "x-juno-jwt": os.environ["SUMVIN_JWT"],
    "x-juno-orgid": os.environ["SUMVIN_ORG_ID"],
}

# 1. Fetch the payload prepared for this Errand
prepared = httpx.get(
    "https://api.sumvin.com/v0/user/ipa/ipa_1a2b3c4d",
    params={"expand": "mandate"},
    headers=headers,
)
approval_payload = prepared.json()["intent"]["approval_payload"]

# 2. Sign approval_payload with the account's wallet (eth_signTypedData_v4),
#    then send the decision and the signature that authorises it
res = httpx.put(
    "https://api.sumvin.com/v0/user/ipa/ipa_1a2b3c4d/decision",
    headers=headers,
    json={"decision": "approved", "signature": signature},
)
intent = res.json()["intent"]

import { useState } from 'react';

const headers = {
  'x-juno-jwt': jwt,
  'x-juno-orgid': orgId,
  'Content-Type': 'application/json',
};

function ApproveIPAButton({ intentId }: { intentId: string }) {
  const [isPending, setIsPending] = useState(false);

  const handleApprove = async () => {
    setIsPending(true);
    try {
      // 1. Fetch the payload prepared for this Errand
      const prepared = await fetch(
        `https://api.sumvin.com/v0/user/ipa/${intentId}?expand=mandate`,
        { headers },
      );
      const { intent } = await prepared.json();

      // 2. The button authorises a purchase, so it signs one — the payload
      //    comes from the server and is signed as-is.
      const signature = await walletClient.request({
        method: 'eth_signTypedData_v4',
        params: [account, JSON.stringify(intent.approval_payload)],
      });

      // 3. Send the decision and the signature that authorises it
      await fetch(`https://api.sumvin.com/v0/user/ipa/${intentId}/decision`, {
        method: 'PUT',
        headers,
        body: JSON.stringify({ decision: 'approved', signature }),
      });
    } finally {
      setIsPending(false);
    }
  };

  return <button onClick={handleApprove} disabled={isPending}>Approve</button>;
}