{"uid":"cap_lXS1EOp_1ZwXzB7uBFGxf","slug":"x402-hosting-transfer-project-ownership-f562b6f8","name":"x402 Hosting: Transfer Project Ownership","description":"Transfer project ownership to another EVM wallet (toAddress query parameter). Call this to hand control of a site to a new owner; that wallet must sign all future paid operations. Only the current owner wallet can pay.","url":"https://api.x402-hosting.com/v1/projects/:id/transfer","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"headers":{"type":"object","required":["Idempotency-Key"],"properties":{"Idempotency-Key":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"}},"additionalProperties":true},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"}},"additionalProperties":false},"queryParams":{"type":"object","required":["toAddress"],"properties":{"toAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["projectId","operationId"],"properties":{"state":{"type":"string"},"projectId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"operationId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"operationUrl":{"type":"string"}},"additionalProperties":true}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lo1M4DtD4ZWLMHrZhsL0K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Transfers ownership of a hosted project to a new EVM wallet address, making that wallet the sole authorized payer for future operations.","exampleAgentPrompt":"Transfer ownership of my x402 hosting project (ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890) to the wallet address 0xAbCd1234567890AbCd1234567890AbCd12345678 — the new owner should control all future paid operations.","exampleUseCases":[{"title":"Handoff site to client wallet","prompt":"I finished building the site for my client — transfer the x402 hosting project a1b2c3d4-e5f6-1234-ab12-ef1234567890 over to their wallet 0xDEADBEEF1234567890ABCDef1234567890ABCDef so they own it going forward."},{"title":"Team wallet migration after rebrand","prompt":"We're switching our company's EVM wallet after the rebrand — reassign our x402 hosting project f0e1d2c3-b4a5-6789-cdef-012345678901 to our new wallet address 0x9999aaaa1234567890bbbbCCCC1234567890dddd."},{"title":"Selling deployed project","prompt":"I'm selling my Next.js site to a buyer — transfer the x402 hosting project 11223344-5566-7788-99aa-bbccddeeff00 to their wallet 0x1111222233334444555566667777888899990000 so they take full control."}],"resultDescription":"Returns a JSON object containing the projectId (UUID of the project), an operationId (UUID tracking this transfer operation), an operationUrl (link to monitor the operation's progress), and a state field indicating the current status of the transfer.","failureModes":["Invalid project UUID format returns 400 error","Invalid or malformed EVM wallet address (toAddress) returns 400 error","Caller is not the current project owner returns 403 forbidden","Project ID not found returns 404 error","Duplicate idempotency key with different parameters returns 409 conflict","Payment not processed or USDC balance insufficient returns 402 payment required","Transfer already in progress returns conflict error"],"whenToPreferThis":"Use this endpoint when you need to permanently transfer control of an x402-hosted project to a different EVM wallet. This is the correct endpoint when a project owner is selling, delegating, or handing off a deployed site and the new wallet must be the authorized payer for all future paid operations. Prefer this over any workaround such as re-deploying under a new wallet, since this preserves the project's history, operationId chain, and existing deployment state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:27.642Z","isFirstParty":false}