{"components":{"schemas":{"ActivityReportResponse":{"additionalProperties":false,"properties":{"events":{"additionalProperties":false,"properties":{"guide_view":{"minimum":0,"type":"integer"},"referral_click":{"minimum":0,"type":"integer"},"result_complete":{"minimum":0,"type":"integer"},"share":{"minimum":0,"type":"integer"}},"required":["guide_view","result_complete","share","referral_click"],"type":"object"},"note":{"type":"string"},"partner_id":{"format":"uuid","type":"string"},"period":{"enum":["all_time"],"type":"string"}},"required":["partner_id","period","events","note"],"type":"object"},"AgentKeyIssue":{"additionalProperties":false,"properties":{"expires_days":{"enum":[30,90,180,365],"type":"integer"},"label":{"maxLength":80,"minLength":1,"type":"string"},"scopes":{"items":{"enum":["read","write","publish"],"type":"string"},"minItems":1,"type":"array","uniqueItems":true}},"required":["label","scopes","expires_days"],"type":"object"},"AgentKeyIssued":{"additionalProperties":false,"properties":{"expires_in_days":{"enum":[30,90,180,365],"type":"integer"},"notice":{"type":"string"},"scopes":{"items":{"enum":["read","write","publish"],"type":"string"},"type":"array"},"token":{"description":"One-time Bearer secret. It is not retained or returned again.","type":"string","writeOnly":true},"token_type":{"enum":["Bearer"],"type":"string"}},"required":["token","token_type","scopes","expires_in_days","notice"],"type":"object"},"BootstrapResponse":{"additionalProperties":false,"properties":{"agent_expires_in_days":{"enum":[30,90,180,365],"type":"integer"},"agent_scopes":{"items":{"enum":["read","write","publish"],"type":"string"},"type":"array"},"agent_token":{"description":"Private scoped Bearer credential, returned only by the original creation response.","type":"string","writeOnly":true},"agent_token_type":{"enum":["Bearer"],"type":"string"},"management_capability":{"description":"Private guide-management capability, returned only by the original creation response.","type":"string","writeOnly":true},"notice":{"type":"string"},"partner":{"$ref":"#/components/schemas/Partner"},"profile":{"$ref":"#/components/schemas/ProfileMutation"}},"required":["partner","profile","management_capability","agent_token","agent_token_type","agent_scopes","agent_expires_in_days","notice"],"type":"object"},"Error":{"properties":{"code":{"type":"string"},"error":{"type":"string"}},"required":["error"],"type":"object"},"EvidenceClaim":{"additionalProperties":false,"properties":{"content_sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"document_id":{"format":"uuid","type":"string"},"effective_date":{"format":"date","nullable":true,"type":"string"},"evidence_version":{"type":"integer"},"fetched_at":{"format":"date-time","type":"string"},"observed_at":{"format":"date-time","type":"string"},"parser_name":{"type":"string"},"predicate":{"type":"string"},"recorded_status":{"enum":["verified","unverified","stale"],"type":"string"},"status":{"enum":["verified","unverified","stale","unknown"],"type":"string"},"subject":{"type":"string"},"tier":{"enum":["official","government","secondary"],"type":"string"},"url":{"format":"uri","type":"string"},"value":{"additionalProperties":true,"type":"object"}},"required":["subject","predicate","value","observed_at","effective_date","tier","recorded_status","status","evidence_version","document_id","url","content_sha256","fetched_at","parser_name"],"type":"object"},"EvidenceError":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"},"EvidenceSnapshotResponse":{"additionalProperties":false,"properties":{"catalog_integration":{"additionalProperties":false,"properties":{"automatic_catalog_updates":{"enum":[false],"type":"boolean"},"unknown_or_unverified_label":{"enum":["unverified"],"type":"string"},"verified_enrichments":{"items":{"type":"string"},"type":"array"}},"required":["automatic_catalog_updates","verified_enrichments","unknown_or_unverified_label"],"type":"object"},"claims":{"items":{"$ref":"#/components/schemas/EvidenceClaim"},"type":"array"},"documents":{"description":"Bounded source-document metadata; raw snapshot bytes are never public.","items":{"type":"object"},"type":"array"},"evidence_version":{"nullable":true,"type":"integer"},"generated_at":{"format":"date-time","nullable":true,"type":"string"},"history":{"type":"boolean"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"source_freshness":{"items":{"$ref":"#/components/schemas/EvidenceSourceFreshness"},"type":"array"}},"required":["evidence_version","generated_at","catalog_integration","history","limit","source_freshness","claims","documents"],"type":"object"},"EvidenceSourceFreshness":{"additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"freshness":{"description":"Operational source state, not a claim that every retained fact is current.","enum":["fresh","stale","unknown","never_fetched","source_document_only","disabled"],"type":"string"},"id":{"type":"string"},"last_attempt_at":{"format":"date-time","nullable":true,"type":"string"},"last_error":{"nullable":true,"type":"string"},"last_fetched_at":{"format":"date-time","nullable":true,"type":"string"},"last_http_status":{"nullable":true,"type":"integer"},"last_validated_at":{"format":"date-time","nullable":true,"type":"string"},"last_validation_error":{"nullable":true,"type":"string"},"next_due_at":{"format":"date-time","nullable":true,"type":"string"},"tier":{"enum":["official","government","secondary"],"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id","url","tier","enabled","freshness","last_attempt_at","last_fetched_at","last_validated_at","last_error","last_validation_error","last_http_status","next_due_at"],"type":"object"},"EvidenceSourcePolicy":{"additionalProperties":false,"properties":{"coverage":{"description":"Whether this source is a specification, manual, announcement, regulator, or secondary report.","type":"string"},"id":{"type":"string"},"parser":{"type":"string"},"subject":{"type":"string"},"tier":{"enum":["official","government","secondary"],"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id","url","tier","parser","subject","coverage"],"type":"object"},"EvidenceSourcesResponse":{"additionalProperties":false,"properties":{"policy":{"items":{"$ref":"#/components/schemas/EvidenceSourcePolicy"},"type":"array"},"sources":{"items":{"$ref":"#/components/schemas/EvidenceSourceFreshness"},"type":"array"}},"required":["policy","sources"],"type":"object"},"Partner":{"additionalProperties":false,"properties":{"audience_intro":{"type":"string"},"display_name":{"type":"string"},"id":{"format":"uuid","type":"string"},"referral_url":{"format":"uri","type":"string"},"slug":{"type":"string"},"status":{"enum":["active","paused","suspended"],"type":"string"},"version":{"minimum":1,"type":"integer"}},"required":["id","slug","display_name","audience_intro","referral_url","status","version"],"type":"object"},"PartnerCreate":{"additionalProperties":false,"properties":{"agent_expires_days":{"default":90,"enum":[30,90,180,365],"type":"integer"},"agent_label":{"default":"Initial agent key","maxLength":80,"minLength":1,"type":"string"},"agent_scopes":{"default":["read","write","publish"],"items":{"enum":["read","write","publish"],"type":"string"},"minItems":1,"type":"array","uniqueItems":true},"audience_intro":{"maxLength":280,"type":"string"},"display_name":{"maxLength":80,"type":"string"},"family_weight":{"maximum":100,"minimum":0,"type":"integer"},"new_tech":{"maximum":100,"minimum":0,"type":"integer"},"philosophy":{"maxLength":360,"minLength":1,"type":"string"},"preset":{"enum":["tried-and-true","family-first","early-adopter"],"type":"string"},"referral_url":{"format":"uri","type":"string"},"slug":{"pattern":"^[a-z0-9](?:[a-z0-9-]{1,38}[a-z0-9])?$","type":"string"},"value_weight":{"maximum":100,"minimum":0,"type":"integer"},"wait_months":{"maximum":18,"minimum":0,"type":"integer"}},"required":["display_name","slug","referral_url","philosophy"],"type":"object"},"PartnerPatch":{"additionalProperties":false,"properties":{"audience_intro":{"maxLength":280,"type":"string"},"referral_url":{"format":"uri","type":"string"},"version":{"minimum":1,"type":"integer"}},"required":["version"],"type":"object"},"PartnerReadResponse":{"additionalProperties":false,"properties":{"partner":{"$ref":"#/components/schemas/Partner"},"published_profile":{"$ref":"#/components/schemas/Profile"}},"required":["partner","published_profile"],"type":"object"},"PartnerWriteResponse":{"additionalProperties":false,"properties":{"partner":{"$ref":"#/components/schemas/Partner"}},"required":["partner"],"type":"object"},"PhilosophyPreviewResponse":{"additionalProperties":false,"properties":{"models":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"preview_only":{"enum":[true],"type":"boolean"},"profile":{"additionalProperties":false,"properties":{"family_weight":{"maximum":100,"minimum":0,"type":"integer"},"new_tech":{"maximum":100,"minimum":0,"type":"integer"},"philosophy":{"maxLength":360,"minLength":1,"type":"string"},"preset":{"enum":["tried-and-true","family-first","early-adopter"],"type":"string"},"published":{"enum":[false],"type":"boolean"},"value_weight":{"maximum":100,"minimum":0,"type":"integer"},"wait_months":{"maximum":18,"minimum":0,"type":"integer"}},"required":["preset","philosophy","new_tech","value_weight","family_weight","wait_months","published"],"type":"object"}},"required":["profile","models","preview_only"],"type":"object"},"PhilosophyWriteResponse":{"additionalProperties":false,"properties":{"models":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"profile":{"$ref":"#/components/schemas/ProfileMutation"},"state":{"enum":["draft","published"],"type":"string"}},"required":["profile","models","state"],"type":"object"},"Profile":{"additionalProperties":false,"properties":{"fact_fingerprint":{"nullable":true,"type":"string"},"family_weight":{"maximum":100,"minimum":0,"type":"integer"},"id":{"format":"uuid","nullable":true,"type":"string"},"new_tech":{"maximum":100,"minimum":0,"type":"integer"},"philosophy":{"maxLength":360,"minLength":1,"type":"string"},"preset":{"enum":["tried-and-true","family-first","early-adopter"],"type":"string"},"published":{"type":"boolean"},"value_weight":{"maximum":100,"minimum":0,"type":"integer"},"version":{"minimum":0,"type":"integer"},"wait_months":{"maximum":18,"minimum":0,"type":"integer"}},"required":["id","version","preset","philosophy","new_tech","value_weight","family_weight","wait_months","published","fact_fingerprint"],"type":"object"},"ProfileInput":{"additionalProperties":false,"properties":{"family_weight":{"maximum":100,"minimum":0,"type":"integer"},"new_tech":{"maximum":100,"minimum":0,"type":"integer"},"philosophy":{"maxLength":360,"minLength":1,"type":"string"},"preset":{"enum":["tried-and-true","family-first","early-adopter"],"type":"string"},"value_weight":{"maximum":100,"minimum":0,"type":"integer"},"wait_months":{"maximum":18,"minimum":0,"type":"integer"}},"required":["preset","philosophy","new_tech","value_weight","family_weight","wait_months"],"type":"object"},"ProfileMutation":{"additionalProperties":false,"properties":{"fact_fingerprint":{"nullable":true,"type":"string"},"family_weight":{"maximum":100,"minimum":0,"type":"integer"},"id":{"format":"uuid","type":"string"},"new_tech":{"maximum":100,"minimum":0,"type":"integer"},"philosophy":{"maxLength":360,"minLength":1,"type":"string"},"preset":{"enum":["tried-and-true","family-first","early-adopter"],"type":"string"},"published":{"type":"boolean"},"value_weight":{"maximum":100,"minimum":0,"type":"integer"},"version":{"minimum":1,"type":"integer"},"wait_months":{"maximum":18,"minimum":0,"type":"integer"}},"required":["id","version","preset","philosophy","new_tech","value_weight","family_weight","wait_months","published"],"type":"object"},"ProfileWrite":{"additionalProperties":false,"properties":{"base_version":{"minimum":1,"type":"integer"},"family_weight":{"maximum":100,"minimum":0,"type":"integer"},"new_tech":{"maximum":100,"minimum":0,"type":"integer"},"philosophy":{"maxLength":360,"minLength":1,"type":"string"},"preset":{"enum":["tried-and-true","family-first","early-adopter"],"type":"string"},"value_weight":{"maximum":100,"minimum":0,"type":"integer"},"wait_months":{"maximum":18,"minimum":0,"type":"integer"}},"required":["preset","philosophy","new_tech","value_weight","family_weight","wait_months","base_version"],"type":"object"},"ResultPreview":{"additionalProperties":false,"properties":{"budget":{"maximum":200000,"minimum":1,"type":"integer"},"seats":{"maximum":8,"minimum":1,"type":"integer"},"timeline":{"enum":["soon","flexible"],"type":"string"}},"required":["timeline"],"type":"object"},"ResultPreviewResponse":{"additionalProperties":false,"properties":{"preferences":{"$ref":"#/components/schemas/ResultPreview"},"preview_only":{"enum":[true],"type":"boolean"},"profile_version":{"minimum":0,"type":"integer"},"result":{"additionalProperties":true,"type":"object"}},"required":["profile_version","preferences","result","preview_only"],"type":"object"},"ShareKitResponse":{"additionalProperties":false,"properties":{"disclosure":{"type":"string"},"embed_html":{"type":"string"},"embed_url":{"type":"string"},"guide_url":{"type":"string"},"newsletter":{"type":"string"},"social":{"type":"string"}},"required":["guide_url","embed_url","embed_html","newsletter","social","disclosure"],"type":"object"}},"securitySchemes":{"PartnerAgentBearer":{"description":"An unrevoked, unexpired partner API key. Scope is enforced per operation.","scheme":"bearer","type":"http"},"PartnerManagementCapability":{"description":"Private one-time-returned management capability, or an authenticated local browser capability. Never send a partner ID as authorization. Browser-session calls require X-CSRF-Token; explicit capability-header calls do not.","in":"header","name":"X-Partner-Management-Capability","type":"apiKey"}}},"info":{"description":"Accountless partner API. Public creation returns a paused draft, a private management capability, and one scoped bearer token exactly once. Management capability or authenticated local browser capability is required for later key issuance and revocation. Every mutation requires Idempotency-Key; PATCH and philosophy writes use optimistic versions.","title":"Tesla Buyer's Radar Authorized Partner Agent API","version":"1.0.0"},"openapi":"3.0.3","paths":{"/api/v1/agent-keys":{"post":{"parameters":[{"description":"Reuse only for a retry with the same route and exact JSON body.","example":"draft-request-0001","in":"header","name":"Idempotency-Key","required":true,"schema":{"pattern":"^[A-Za-z0-9._:-]{8,128}$","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"expires_days":90,"label":"Newsletter assistant","scopes":["read","write","publish"]},"schema":{"$ref":"#/components/schemas/AgentKeyIssue"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentKeyIssued"}}},"description":"One-time scoped credential issued; copy it now"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Ownership, optimistic-version, or idempotency conflict"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerManagementCapability":[]}],"summary":"Issue a one-time scoped token with a management capability","x-browser-csrf-header":"X-CSRF-Token","x-idempotency-required":true,"x-required-scope":"management_capability"}},"/api/v1/evidence":{"get":{"parameters":[{"description":"Exact subject filter. Omit to list retained observations.","example":"Tesla Model 3","in":"query","name":"subject","required":false,"schema":{"maxLength":120,"minLength":1,"type":"string"}},{"description":"Set true to return bounded immutable observation history rather than latest observations.","in":"query","name":"history","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Case-insensitive bounded search across retained claim metadata and public document titles.","in":"query","name":"q","required":false,"schema":{"maxLength":120,"minLength":1,"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceSnapshotResponse"}}},"description":"Versioned claims, sources, and catalog-integration status"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceError"}}},"description":"Invalid subject filter"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceError"}}},"description":"Evidence storage is unavailable"}},"summary":"Read retained evidence claims and their provenance"}},"/api/v1/guide/results/preview":{"post":{"requestBody":{"content":{"application/json":{"example":{"budget":100000,"seats":5,"timeline":"flexible"},"schema":{"$ref":"#/components/schemas/ResultPreview"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultPreviewResponse"}}},"description":"Preview-only buyer result"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Preview a result without recording buyer data","x-required-scope":"read"}},"/api/v1/partner":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerReadResponse"}}},"description":"Partner and published philosophy"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Read the key owner's partner and published philosophy","x-required-scope":"read"},"patch":{"parameters":[{"description":"Reuse only for a retry with the same route and exact JSON body.","example":"draft-request-0001","in":"header","name":"Idempotency-Key","required":true,"schema":{"pattern":"^[A-Za-z0-9._:-]{8,128}$","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"audience_intro":"Independent EV guidance for practical buyers.","version":1},"schema":{"$ref":"#/components/schemas/PartnerPatch"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerWriteResponse"}}},"description":"Guide details updated"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Ownership, optimistic-version, or idempotency conflict"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Update key owner's partner","x-idempotency-required":true,"x-required-scope":"write"}},"/api/v1/partners":{"post":{"parameters":[{"description":"Reuse only for a retry with the same route and exact JSON body.","example":"draft-request-0001","in":"header","name":"Idempotency-Key","required":true,"schema":{"pattern":"^[A-Za-z0-9._:-]{8,128}$","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"agent_scopes":["read","write"],"display_name":"Example EV Guide","family_weight":35,"new_tech":85,"philosophy":"Technology-focused while keeping evidence and uncertainty visible.","preset":"early-adopter","referral_url":"https://ts.la/example","slug":"example-ev-guide","value_weight":40,"wait_months":0},"schema":{"$ref":"#/components/schemas/PartnerCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BootstrapResponse"}}},"description":"Paused partner, one-time management capability, and scoped token created"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Ownership, optimistic-version, or idempotency conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Anonymous guide creation rate limit reached"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[],"summary":"Create an accountless partner guide and one-time private capabilities","x-idempotency-required":true,"x-required-scope":"public"}},"/api/v1/philosophy/drafts":{"post":{"parameters":[{"description":"Reuse only for a retry with the same route and exact JSON body.","example":"draft-request-0001","in":"header","name":"Idempotency-Key","required":true,"schema":{"pattern":"^[A-Za-z0-9._:-]{8,128}$","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"base_version":1,"family_weight":35,"new_tech":85,"philosophy":"Technology-focused while keeping evidence and uncertainty visible.","preset":"early-adopter","value_weight":40,"wait_months":0},"schema":{"$ref":"#/components/schemas/ProfileWrite"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhilosophyWriteResponse"}}},"description":"Private draft saved"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Ownership, optimistic-version, or idempotency conflict"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Save immutable private draft","x-idempotency-required":true,"x-required-scope":"write"}},"/api/v1/philosophy/preview":{"post":{"requestBody":{"content":{"application/json":{"example":{"family_weight":35,"new_tech":85,"philosophy":"Technology-focused while keeping evidence and uncertainty visible.","preset":"early-adopter","value_weight":40,"wait_months":0},"schema":{"$ref":"#/components/schemas/ProfileInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhilosophyPreviewResponse"}}},"description":"Unpublished philosophy impact"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Preview an unpublished philosophy","x-required-scope":"read"}},"/api/v1/philosophy/publish":{"post":{"parameters":[{"description":"Reuse only for a retry with the same route and exact JSON body.","example":"draft-request-0001","in":"header","name":"Idempotency-Key","required":true,"schema":{"pattern":"^[A-Za-z0-9._:-]{8,128}$","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"base_version":1,"family_weight":35,"new_tech":85,"philosophy":"Technology-focused while keeping evidence and uncertainty visible.","preset":"early-adopter","value_weight":40,"wait_months":0},"schema":{"$ref":"#/components/schemas/ProfileWrite"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhilosophyWriteResponse"}}},"description":"Philosophy published"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Ownership, optimistic-version, or idempotency conflict"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Publish immutable philosophy version","x-idempotency-required":true,"x-required-scope":"publish"}},"/api/v1/reports/activity":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityReportResponse"}}},"description":"All-time aggregate on-site activity"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid JSON body, content type, or request field"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Read all-time aggregate accepted activity; no custom date ranges","x-required-scope":"read"}},"/api/v1/share-kit":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareKitResponse"}}},"description":"Owner share-kit text and relative guide paths"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, invalid, expired, revoked, or unauthorized private capability"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Required scope is absent or the partner is suspended"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Credential, partner, or analytics storage is unavailable"}},"security":[{"PartnerAgentBearer":[]}],"summary":"Read owner share-kit text and paths","x-required-scope":"read"}},"/api/v1/sources":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceSourcesResponse"}}},"description":"Source policy and per-source operational state"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceError"}}},"description":"Evidence storage is unavailable"}},"summary":"Read the fixed public evidence-source policy and live source status"}}},"servers":[{"url":"https://teslabuyersradar.com"}]}