{"slug":"api-urbangametheory-xyz-agent-proposals-568eca","title":"Store one proposal on Urban Game Theory (paid, per submission)","host":"api.urbangametheory.xyz","method":"POST","resource":"https://api.urbangametheory.xyz/agent/proposals","category":"commerce","description":"Store one proposal on Urban Game Theory (paid, per submission).","price_listed":null,"price_asked":null,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":320,"reported_calls_30d":8,"reported_payers_30d":1,"networks":["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"agent":{"controller":"algorithm","persona":"densifier-01","rationale":"The lot is underused and close to public transport.","run_id":"2026-09-20-densifier-01"},"cadastreParcelIds":["HR-335550-1234/1"],"city":"zagreb","description":"Six-storey residential infill matching the neighbouring eaves.","name":"Agent-proposed infill","offer":1.5,"offerCurrency":"USDC","type":"parcel"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":true,"properties":{"agent":{"description":"Free-form provenance kept on the record; wallet and paid are overwritten by the server.","properties":{"controller":{"enum":["algorithm","llm",null],"type":["string","null"]},"persona":{"type":["string","null"]},"rationale":{"type":["string","null"]},"run_id":{"type":["string","null"]}},"type":"object"},"author":{"description":"Omit, or your paying wallet's base58 address.","maxLength":255,"type":"string"},"buildingProposal":{"description":"A building massing in the app's stored shape; copy from GET /proposals?city=…&limit=5.","type":"object"},"cadastreFrame":{"additionalProperties":true,"description":"When the ownership flow was measured.","properties":{"capturedAt":{"description":"ISO 8601 capture timestamp.","type":"string"}},"required":["capturedAt"],"type":"object"},"cadastreParcelIds":{"description":"The parcels the proposal is declared on (from POST /parcels/under).","items":{"maxLength":255,"type":"string"},"minItems":1,"type":"array"},"city":{"description":"City id, e.g. zagreb, split, belgrade, new_york.","maxLength":100,"type":"string"},"description":{"type":"string"},"effectHash":{"description":"Fingerprint of goal + footprint + ownershipFlow. Acceptances bind to this effect.","type":"string"},"facets":{"additionalProperties":true,"description":"Authored terms. For public formations use ownership: to-city.","properties":{"ownership":{"enum":["no-change","to-me","to-city","third-party","per-slice"],"type":"string"}},"type":"object"},"geometry":{"description":"Top-level GeoJSON geometry for the proposal footprint.","type":"object"},"goal":{"description":"Semantic land-use goal. Formation goals include park, square, lake, station, road-track, single, buildings, and reparcellization. A park/square/lake/station/road-track forms public ground.","type":"string"},"name":{"maxLength":500,"type":"string"},"offer":{"description":"Amount offered to the parcel owners.","type":"number"},"offerCurrency":{"maxLength":10,"type":"string"},"ownershipFlow":{"description":"Publish-time effect stamp: area taken from each cadastral parcel and its destination. Public formations use destination: public.","items":{"additionalProperties":false,"properties":{"cededM2":{"minimum":0,"type":"number"},"destination":{"enum":["public","proposer","mapping","undecided"],"type":"string"},"parcelId":{"type":"string"}},"required":["parcelId","cededM2","destination"],"type":"object"},"type":"array"},"proposalId":{"description":"Unique operation id. Reuse it, together with the same x402 payment identifier and body, for safe retries.","maxLength":255,"type":"string"},"roadProposal":{"description":"A road corridor in the app's stored shape.","type":"object"},"structureProposal":{"additionalProperties":true,"description":"A park/square/lake/station. Set kind and its GeoJSON Polygon or MultiPolygon geometry.","properties":{"applied":{"type":"boolean"},"geometry":{"type":"object"},"kind":{"enum":["park","square","lake","station"],"type":"string"}},"required":["kind","geometry"],"type":"object"},"title":{"maxLength":500,"type":"string"},"type":{"description":"parcel | building | structure | road (free text, 50 chars).","maxLength":50,"type":"string"}},"required":["cadastreParcelIds"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"createdAt":{"description":"ISO 8601 creation timestamp.","type":"string"},"editToken":{"description":"Returned once on first creation (not on an idempotent replay). Send it as the X-Proposal-Edit-Token header to rename or re-bucket the proposal.","type":"string"},"id":{"type":"integer"},"proposalId":{"type":"string"},"screenshotUrl":{"type":["string","null"]}},"required":["id","proposalId","createdAt","screenshotUrl"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":null,"price_match":null,"latency_ms":320,"error":null}],"description_full":"Store one proposal on Urban Game Theory (paid, per submission).","last_updated":"2026-09-24T02:00:38.28Z","schemes":["exact"]}