{"uid":"cap_vv_mjcOKe9OMrLGZ0Vk1P","slug":"supplier-payment-decision-agent-rsa-public-key-registration-6145f3e4","name":"Supplier Payment Decision Agent – RSA Public Key Registration","description":"Registers an RSA public key (2048-bit or larger, PEM) used to sign payment-decision requests. Keys are immutable per tenant; rotate by registering a new key_id.","url":"https://supplier-payment-verifier-production.up.railway.app/v1/agent-keys?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key_id":{"type":"string","title":"Key Id","maxLength":128,"minLength":1,"description":"Caller-chosen RSA public-key identifier, unique within your tenant. Reuse it in signature.key_id; rotate with a new ID."},"public_key_pem":{"type":"string","title":"Public Key Pem","maxLength":16384,"minLength":1,"description":"PEM-encoded RSA public key, at least 2048 bits. Never send a private key, wallet key or certificate."}}},"responseSchema":{"type":"json","example":{"key_id":"my-key-1","registered":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Tv9Ot_hDk_0dbg1RhdClJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers an RSA public key (2048-bit or larger, PEM format) for a tenant to cryptographically sign payment-decision requests.","exampleAgentPrompt":"Register my RSA public key for the Supplier Payment Decision Agent — the key ID is 'acme-payments-key-1' and here's the PEM-encoded 2048-bit public key so my agent can start signing payment-decision requests.","exampleUseCases":[{"title":"Onboard new payment-signing agent","prompt":"I'm setting up a new automated payment agent for our procurement team — please register its RSA public key (key ID 'procurement-agent-key-1') with the Supplier Payment Decision Agent so it can sign invoice payment decisions going forward."},{"title":"Add second signing key for redundancy","prompt":"We need a backup signing key registered on the Supplier Payment Decision Agent in case our primary key is compromised — register this new 2048-bit RSA PEM key as 'acme-backup-key-2' for our tenant."},{"title":"Rotate compromised signing key","prompt":"Our old signing key was exposed, so we need to register a fresh RSA public key with key ID 'acme-rotated-key-3' on the supplier payment verifier so our agent can resume authorizing invoice payments securely."}],"resultDescription":"Returns a JSON object confirming the key registration, including the key_id that was registered and a boolean 'registered: true' indicating successful storage. The key is then immutably associated with the tenant and can be used to verify signed payment-decision requests.","failureModes":["Duplicate key_id for the same tenant — keys are immutable per tenant, so reusing an existing key_id will fail; must use a new key_id to rotate","Invalid or malformed PEM — key is not a valid RSA public key or is below 2048 bits, resulting in a validation error","Missing required fields — body, method, or bodyType not provided, causing a schema validation error","Unauthorized tenant — missing or invalid authentication credentials","Network/service unavailability on Railway hosting platform"],"whenToPreferThis":"Use this endpoint once, during initial setup or key rotation, to register the RSA public key your agent will use to sign all subsequent payment-decision requests. This is a prerequisite step before calling any other Supplier Payment Decision Agent endpoints that require cryptographic request signing. Choose this over generic key management APIs because it is specifically integrated with the supplier payment verification workflow on this platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:35:02.251Z","isFirstParty":false,"canonicalSlug":"supplier-payment-decision-agent-rsa-public-key-registration-6145f3e4"}