{"slug":"oip-capability-stripe-stripe-api-write","title":"OIP capability: STRIPE_STRIPE_API_WRITE","body":"## STRIPE_STRIPE_API_WRITE\n\nThis is one executable OIP object. It is the leaf where prose stops and exact invocation begins.\n\nWrite data via any Stripe API POST/PATCH/PUT/DELETE operation: 1. Use stripe_api_search to find the operation ID. 2. Use stripe_api_details to understand its parameters (required for operations with n MCP: https://mcp.stripe.com/\n\nParent system: [Stripe (payments)](https://miscsubjects.com/api/dispatch?map=STRIPE&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip). Machine doc: [/api/dispatch?key=STRIPE_STRIPE_API_WRITE&format=markdown](https://miscsubjects.com/api/dispatch?key=STRIPE_STRIPE_API_WRITE&format=markdown). Invocation history: [/api/invocations?object_id=STRIPE_STRIPE_API_WRITE](https://miscsubjects.com/api/invocations?object_id=STRIPE_STRIPE_API_WRITE).\n\n## Invoke\n\nExample: `[STRIPE_STRIPE_API_WRITE]<arg1>[/STRIPE_STRIPE_API_WRITE]`\n\nRun URL: `https://miscsubjects.com/api/dispatch?invoke=STRIPE_STRIPE_API_WRITE&body=%3Carg1%3E&share=<TOKEN>`\n\nAuth: `none`. Risk: `low`.\n\n## Machine contract\n\n- Read this article first; do not infer the row shape from memory.\n- If acting with a URL-only tool, open run_now after replacing placeholder args.\n- If the call returns ran:false or proof.ok:false, read the receipt and repair the failed invocation instead of narrating success.\n- If the token denies the call, report the denial exactly; do not switch to a broader action unless the owner supplied a broader token.\n\n## Troubleshooting\n\n- **unknown key** - Use the did_you_mean links or ask URL; never guess another key.\n- **argument/body mismatch** - Read inputs/example_args here, then retry with repairs: inv_ID so lineage closes.\n- **expired or corrupted token** - Report token_expired/token_corrupted from the response; owner mints a fresh scoped link.\n- **tool returned ok:false / exit nonzero** - Do not call it sent. Read the receipt, correct the body, fire a repair.\n\n## Receipt loop\n\nAfter any action, open the receipt. If it is wrong, repair it with `POST /api/dispatch {key, body, repairs:\"inv_ID\"}`. If you need to repeat the exact recorded call, replay it with `POST /api/dispatch {replay:\"inv_ID\"}`.\n\n## Full generated capability doc\n\n## §SELF — miscsubjects capability (paste without context)\n**Principle:** Self-explaining payload — no external context required. This _self block is the capability: what it is, how to run it, how to change it, and where to look next.\n**Path:** OIP > STRIPE > STRIPE_STRIPE_API_WRITE\n**Capability:** `STRIPE_STRIPE_API_WRITE` — Write data via any Stripe API POST/PATCH/PUT/DELETE operation: 1. Use stripe_api_search to find the operation ID. 2. Use stripe_api_details to understand its parameters (required for operations with n MCP: https://mcp.stripe.com/\n**RUN NOW (open this URL):** https://miscsubjects.com/api/dispatch?invoke=STRIPE_STRIPE_API_WRITE&body=%3Carg1%3E&share=<TOKEN>\n**Example call:** [STRIPE_STRIPE_API_WRITE]<arg1>[/STRIPE_STRIPE_API_WRITE]\n- **type · runner:** tool · fn · stripe\n- **run it:** Open run_now (URL, fires the example), or POST https://miscsubjects.com/api/dispatch {\"key\":\"STRIPE_STRIPE_API_WRITE\",\"body\":\"<arg1>\"}. From the router: null\n- **inputs:** {\"type\":\"object\",\"properties\":{\"stripe_api_operation_id\":{\"description\":\"The operation ID to execute (e.g. 'PostCustomers', 'GetPaymentIntents')\",\"type\":\"string\"},\"parameters\":{\"description\":\"Parameters for the API call. Include path parameters (e.g. 'customer' for /v1/customers/{customer}), query parameters, and body parameters as a flat object. Nested object fields use dot-notation (e.g. \\\"address.city\\\"). Array fields (e.g. line_items) must be passed as a JSON array value, not as a plain string.\",\"type\":\"object\"},\"human_confirmation\":{\"type\":\"object\",\"description\":\"This tool might require human confirmation. To run it, first invoke it with the desired parameters, ignoring the `approval_token` parameter.\\nIf it requires human confirmation, the response will include an approval request ID and a URL to an approval page for the human to approve the tool call.\\nYou, as the LLM agent, should:\\n\\n1. Present this URL to the human as a clickable markdown link. Tell them that they have to approve this tool call at that URL, and that they should tell you when they have approved the operation.\\n2. The human will approve that call.\\n3. After the human tells you they have approved the operation, you must call the tool again with the `approval_token` parameter and the exact same parameters. The operation will then go through.\\n\",\"properties\":{\"approval_token\":{\"type\":\"string\",\"description\":\"The ID of the approval token for the request. This is required on only the post-human-confirmation invocation. An example ID is `approval_123`.\"}}}},\"required\":[\"stripe_api_operation_id\",\"parameters\"]}\n- **outputs:** { ok, result, invocation, yield, _self } — result is this object's output; yield is tokens/cost/material; invocation is the ledgered record.\n- **auth · risk:** none · low\n### Machine Contract\n- Read this article first; do not infer the row shape from memory.\n- If acting with a URL-only tool, open run_now after replacing placeholder args.\n- If the call returns ran:false or proof.ok:false, read the receipt and repair the failed invocation instead of narrating success.\n- If the token denies the call, report the denial exactly; do not switch to a broader action unless the owner supplied a broader token.\n### Invocation, Ledger, Repair\n- root tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown\n- parent system article: https://miscsubjects.com/api/dispatch?map=STRIPE&format=markdown\n- append-only ledger: https://miscsubjects.com/api/invocations?object_id=STRIPE_STRIPE_API_WRITE\n- receipt pattern: https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>\n- replay: POST /api/dispatch {\"replay\":\"inv_ID\"}\n- repair: POST /api/dispatch {\"key\":\"STRIPE_STRIPE_API_WRITE\",\"body\":\"corrected args\",\"repairs\":\"inv_ID\"}\n### Troubleshooting\n- **unknown key** — Use the did_you_mean links or ask URL; never guess another key. · https://miscsubjects.com/api/dispatch?ask=STRIPE_STRIPE_API_WRITE\n- **argument/body mismatch** — Read inputs/example_args here, then retry with repairs: inv_ID so lineage closes. · https://miscsubjects.com/api/dispatch?key=STRIPE_STRIPE_API_WRITE\n- **expired or corrupted token** — Report token_expired/token_corrupted from the response; owner mints a fresh scoped link. · https://miscsubjects.com/api/dispatch?explain=1&share=<TOKEN>\n- **tool returned ok:false / exit nonzero** — Do not call it sent. Read the receipt, correct the body, fire a repair. · https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>\n### Logical proof (verify each step)\n1. Every capability is an invokable object with its own _self — this block. → https://miscsubjects.com/api/dispatch?key=STRIPE_STRIPE_API_WRITE\n2. You run it by POSTing to /api/dispatch; in a model turn the router tag is [STRIPE_STRIPE_API_WRITE]args[/STRIPE_STRIPE_API_WRITE]. → https://miscsubjects.com/api/dispatch?registry=1\n3. Every invocation is ledgered with actor, cost, and material/waste. → https://miscsubjects.com/api/invocations?object_id=STRIPE_STRIPE_API_WRITE\n4. You can ask the build for capabilities in plain language. → https://miscsubjects.com/api/dispatch?ask=STRIPE_STRIPE_API_WRITE\n5. The whole build is one self-describing map, with the terminal key. → https://miscsubjects.com/api/dispatch?build=1\n### Where to look next\n- **registry** — Every capability, self-describing · https://miscsubjects.com/api/dispatch?registry=1\n- **ask** — Ask the build what to use, in plain language · https://miscsubjects.com/api/dispatch?ask=<question>\n- **history** — This capability's invocation history — its edges · https://miscsubjects.com/api/invocations?object_id=STRIPE_STRIPE_API_WRITE\n- **build** — The whole build as one map (terminal key) · https://miscsubjects.com/api/dispatch?build=1\n*Self-explaining. Not project knowledge — fetch specifics from the links above.*","hero":null,"images":[],"style":{"accent":"#16324f","measure":860},"tags":["oip","object-invocation-protocol","protocol-specification","machine-native-json","capability"],"model":null,"ledger":null,"embeds":[],"widgets":[{"type":"stat","value":1,"label":"capability"},{"type":"note","title":"Zero-context rule","text":"A reader should understand the protocol unit, object contract, invocation route, receipt schema, and repair path from this page plus its machine bundle."},{"type":"note","title":"Machine-native rule","text":"The JSON is the executable map: object, routes, inputs, proof loop, ledger, and next article to open."}],"home":false,"claims":[{"id":"oip-c1","tier":"system","text":"The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.","who_claims":"system/oip_articles","source_ids":["oip-s3","oip-s4"]},{"id":"oip-c2","tier":"system","text":"The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.","who_claims":"system/oip_articles","source_ids":["oip-s1"]},{"id":"oip-c3","tier":"system","text":"Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s3"]},{"id":"oip-c4","tier":"system","text":"Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.","who_claims":"system/oip_articles","source_ids":["oip-s2"]},{"id":"oip-c5","tier":"system","text":"OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s5"]}],"sources":[{"id":"oip-s1","type":"protocol","title":"BUILD_SPEC object invocation path","url":"https://miscsubjects.com/api/file/docs/BUILD_SPEC.md","summary":"Defines directory rows, dispatch, ledger, and the escalation path for changing the build.","quote":"Run anything: POST https://miscsubjects.com/api/dispatch {key, body}","claim_ids":["oip-c2"],"link_status":"ok","hash":"oipbuildspec0001"},{"id":"oip-s2","type":"protocol","title":"Object Invocation Protocol spec","url":"https://miscsubjects.com/api/file/docs/OIP.md","summary":"Defines OIP surfaces, invariant loop, receipt/replay/repair, and invocation envelopes.","quote":"identify, explain, invoke, ledger, yield","claim_ids":["oip-c3","oip-c4","oip-c5"],"link_status":"ok","hash":"oipspec00000002"},{"id":"oip-s3","type":"protocol","title":"Live OIP capability tree","url":"https://miscsubjects.com/api/dispatch?map=1&format=markdown","summary":"Public recursive capability tree.","quote":"root > shelf > system article > capability article > receipt","claim_ids":["oip-c1","oip-c3"],"link_status":"ok","hash":"oipmap0000000002"},{"id":"oip-s4","type":"protocol","title":"Directory row documentation","url":"https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown","summary":"Capability articles are generated from live rows.","quote":"Machine Contract","claim_ids":["oip-c1"],"link_status":"ok","hash":"oiprow0000000003"},{"id":"oip-s5","type":"protocol","title":"Invocation ledger","url":"https://miscsubjects.com/api/invocations","summary":"Append-only invocation records and receipt links.","quote":"invocations","claim_ids":["oip-c5"],"link_status":"ok","hash":"oipinvocations0005"}],"reviews":[],"extra":{"oip_virtual":true,"oip_type":"capability","count":1,"key":"STRIPE_STRIPE_API_WRITE","metric":"capability"},"register":"oip_protocol","status":"published","revisions":0,"contributions":[],"provenance":[{"action":"generate","model":"system/oip_articles","ts":"2026-07-03T01:50:03-07:00","hash":"virtual-oip","tokens_in":0,"tokens_out":0}],"energy":{"passes":1,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{"system/oip_articles":1},"head":"virtual-oip"},"posted_at":"2026-07-02T00:00:00.000Z","created_at":"2026-07-02T00:00:00.000Z","updated_at":"2026-07-03T01:50:03-07:00"}