{"openapi":"3.1.0","info":{"title":"Agent Help Network","description":"Structured observations, not website status or root-cause diagnosis","version":"0.1.0"},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/incidents/check":{"get":{"summary":"Check Incident","operationId":"check_incident_v1_incidents_check_get","parameters":[{"name":"site_host","in":"query","required":true,"schema":{"type":"string","title":"Site Host"}},{"name":"error_class","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ErrorClass"},{"type":"null"}],"title":"Error Class"}},{"name":"task_step","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Step"}},{"name":"window_hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":24,"title":"Window Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/incidents":{"get":{"summary":"List Incidents","operationId":"list_incidents_v1_incidents_get","parameters":[{"name":"site_host","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Host"}},{"name":"error_class","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ErrorClass"},{"type":"null"}],"title":"Error Class"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/incidents/{incident_id}":{"get":{"summary":"Incident Detail","operationId":"incident_detail_v1_incidents__incident_id__get","parameters":[{"name":"incident_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Incident Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/observations":{"post":{"summary":"Report Observation","operationId":"report_observation_v1_observations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservationIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/observations/{observation_id}":{"delete":{"summary":"Delete Observation","operationId":"delete_observation_v1_observations__observation_id__delete","parameters":[{"name":"observation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Observation Id"}},{"name":"x-withdrawal-token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Withdrawal-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AgentFamily":{"type":"string","enum":["dots","muse","other"],"title":"AgentFamily"},"AttemptActor":{"type":"string","enum":["agent","human"],"title":"AttemptActor"},"AttemptEnv":{"type":"string","enum":["agent_cloud_browser","human_in_agent_browser","human_own_browser","unknown"],"title":"AttemptEnv"},"ChallengeKind":{"type":"string","enum":["interactive_check","loop","block_page","unknown","none"],"title":"ChallengeKind"},"ChallengeVendor":{"type":"string","enum":["cloudflare","recaptcha","hcaptcha","unknown","none"],"title":"ChallengeVendor"},"CheckObservation":{"properties":{"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"attempt_actor":{"$ref":"#/components/schemas/AttemptActor"},"attempt_env":{"$ref":"#/components/schemas/AttemptEnv"},"outcome":{"$ref":"#/components/schemas/Outcome"},"error_class":{"$ref":"#/components/schemas/ErrorClass"},"task_step":{"type":"string","title":"Task Step"},"synthetic":{"type":"boolean","title":"Synthetic"}},"additionalProperties":false,"type":"object","required":["observed_at","attempt_actor","attempt_env","outcome","error_class","task_step","synthetic"],"title":"CheckObservation"},"CheckResponse":{"properties":{"site_host":{"type":"string","title":"Site Host"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"synthetic":{"type":"boolean","title":"Synthetic"},"window_hours":{"type":"integer","maximum":168.0,"minimum":1.0,"title":"Window Hours"},"data_horizon_hours":{"type":"integer","const":168,"title":"Data Horizon Hours"},"current_site_status":{"type":"string","const":"unknown","title":"Current Site Status"},"evidence_level":{"type":"string","enum":["no_reports","single_observation","multiple_observations","later_success_observed","stale_reports"],"title":"Evidence Level"},"summary_code":{"type":"string","title":"Summary Code"},"summary":{"type":"string","title":"Summary"},"failures":{"type":"integer","minimum":0.0,"title":"Failures"},"successes":{"type":"integer","minimum":0.0,"title":"Successes"},"reporting_sources":{"type":"integer","minimum":0.0,"title":"Reporting Sources"},"observations":{"items":{"$ref":"#/components/schemas/CheckObservation"},"type":"array","title":"Observations"}},"additionalProperties":false,"type":"object","required":["site_host","generated_at","synthetic","window_hours","data_horizon_hours","current_site_status","evidence_level","summary_code","summary","failures","successes","reporting_sources","observations"],"title":"CheckResponse"},"ErrorClass":{"type":"string","enum":["site_access","login_auth","human_verification","service_error"],"title":"ErrorClass"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ObservationIn":{"properties":{"schema_version":{"type":"integer","title":"Schema Version"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"agent_family":{"$ref":"#/components/schemas/AgentFamily"},"attempt_actor":{"$ref":"#/components/schemas/AttemptActor"},"attempt_env":{"$ref":"#/components/schemas/AttemptEnv"},"outcome":{"$ref":"#/components/schemas/Outcome"},"challenge_vendor":{"$ref":"#/components/schemas/ChallengeVendor"},"challenge_kind":{"$ref":"#/components/schemas/ChallengeKind"},"synthetic":{"type":"boolean","title":"Synthetic"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"},"consent_confirmed":{"type":"boolean","title":"Consent Confirmed"},"site_host":{"type":"string","title":"Site Host"},"task_step":{"type":"string","title":"Task Step"},"error_class":{"$ref":"#/components/schemas/ErrorClass"}},"additionalProperties":false,"type":"object","required":["schema_version","observed_at","agent_family","attempt_actor","attempt_env","outcome","challenge_vendor","challenge_kind","synthetic","idempotency_key","consent_confirmed","site_host","task_step","error_class"],"title":"ObservationIn"},"Outcome":{"type":"string","enum":["passed","blocked","error","abandoned"],"title":"Outcome"},"Receipt":{"properties":{"observation_id":{"type":"string","format":"uuid","title":"Observation Id"},"incident_id":{"type":"string","format":"uuid","title":"Incident Id"},"review_state":{"type":"string","title":"Review State"},"synthetic":{"type":"boolean","title":"Synthetic"},"withdrawal_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Token"}},"additionalProperties":false,"type":"object","required":["observation_id","incident_id","review_state","synthetic"],"title":"Receipt"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}