{"openapi":"3.1.0","info":{"title":"SubMonitor API","version":"0.2.0"},"paths":{"/readyz":{"get":{"summary":"Readyz","operationId":"readyz_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/auth/session":{"post":{"summary":"Sign In","operationId":"sign_in_api_v1_auth_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sign In Api V1 Auth Session Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Sign Out","operationId":"sign_out_api_v1_auth_session_delete","responses":{"204":{"description":"Successful Response"}}}},"/api/v1/account":{"get":{"summary":"Own Account","operationId":"own_account_api_v1_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Own Account Api V1 Account Get"}}}}}}},"/api/v1/operator/health":{"get":{"summary":"Operator Boundary","operationId":"operator_boundary_api_v1_operator_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/api-keys":{"get":{"tags":["Agent monitors"],"summary":"List Keys","operationId":"list_keys_api_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyList"}}}}}},"post":{"tags":["Agent monitors"],"summary":"Issue Key","operationId":"issue_key_api_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedKey"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/{key_id}":{"delete":{"tags":["Agent monitors"],"summary":"Revoke Key","operationId":"revoke_key_api_v1_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/monitors":{"post":{"tags":["Agent monitors"],"summary":"Create Monitor","operationId":"create_monitor_api_v1_monitors_post","security":[{"MonitorApiKey":[]}],"parameters":[{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorInput"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorView"}}}},"200":{"description":"Existing monitor for the same creation intent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Agent monitors"],"summary":"List Monitors","operationId":"list_monitors_api_v1_monitors_get","security":[{"MonitorApiKey":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorList"}}}}}}},"/api/v1/monitors/{monitor_id}":{"get":{"tags":["Agent monitors"],"summary":"Get Monitor","operationId":"get_monitor_api_v1_monitors__monitor_id__get","security":[{"MonitorApiKey":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Monitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Agent monitors"],"summary":"Set Monitor State","operationId":"set_monitor_state_api_v1_monitors__monitor_id__patch","security":[{"MonitorApiKey":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Monitor Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorState"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/monitors/{monitor_id}/updates":{"get":{"tags":["Agent monitors"],"summary":"Updates","operationId":"updates_api_v1_monitors__monitor_id__updates_get","security":[{"MonitorApiKey":[]}],"parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Monitor Id"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"After"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/signup/link":{"post":{"tags":["Account"],"summary":"Request Link","operationId":"request_link_api_v1_signup_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailInput"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/signup/consume":{"post":{"tags":["Account"],"summary":"Consume Link","operationId":"consume_link_api_v1_signup_consume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/session":{"get":{"tags":["Account"],"summary":"Restore Session","operationId":"restore_session_api_v1_account_session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/account/usage":{"get":{"tags":["Account"],"summary":"Usage","operationId":"usage_api_v1_account_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/account/connection":{"get":{"tags":["Account"],"summary":"Connection","description":"Read existing metadata only; opening the account page is not an agent poll.","operationId":"connection_api_v1_account_connection_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/support":{"post":{"tags":["Account"],"summary":"Create Ticket","operationId":"create_ticket_api_v1_support_post","parameters":[{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportInput"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Account"],"summary":"Tickets","operationId":"tickets_api_v1_support_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/support/{thread_id}":{"get":{"tags":["Account"],"summary":"Ticket","operationId":"ticket_api_v1_support__thread_id__get","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trial":{"post":{"tags":["Account"],"summary":"Start Trial","operationId":"start_trial_api_v1_trial_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/mail/resend-events":{"post":{"tags":["Email provider"],"summary":"Event","operationId":"event_api_v1_mail_resend_events_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Healthz Healthz Get"}}}}}}}},"components":{"schemas":{"AvailableEvent":{"properties":{"id":{"type":"string","title":"Id"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"status":{"type":"string","const":"available","title":"Status"},"source":{"$ref":"#/components/schemas/SourceRecord"},"context":{"items":{"$ref":"#/components/schemas/SourceRecord"},"type":"array","title":"Context"},"context_status":{"type":"string","const":"complete_ancestry","title":"Context Status"},"match_basis":{"type":"string","const":"source_query","title":"Match Basis"},"relevance_assessed":{"type":"boolean","const":false,"title":"Relevance Assessed"}},"type":"object","required":["id","first_seen_at","status","source","context","context_status","match_basis","relevance_assessed"],"title":"AvailableEvent"},"CheckView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"state":{"type":"string","enum":["running","complete","partial","failed","cancelled"],"title":"State"},"window":{"$ref":"#/components/schemas/Window"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"coverage":{"anyOf":[{"$ref":"#/components/schemas/Coverage"},{"type":"string","const":"unknown"},{"type":"null"}],"title":"Coverage"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"retrieval_complete":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Retrieval Complete"},"candidate_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Candidate Count"},"context_deferred_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Context Deferred Count"},"new_item_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"New Item Count"},"provider":{"anyOf":[{"$ref":"#/components/schemas/ProviderIdentity"},{"type":"null"}]},"cost":{"anyOf":[{"$ref":"#/components/schemas/Cost"},{"type":"null"}]},"historical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Historical"},"illustrative":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Illustrative"},"unconfirmed_history":{"anyOf":[{"$ref":"#/components/schemas/Window"},{"type":"null"}]}},"type":"object","required":["id","state","window","finished_at"],"title":"CheckView"},"Cost":{"properties":{"status":{"type":"string","enum":["reported","estimated","unknown"],"title":"Status"},"amount":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Amount"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency","default":"USD"}},"additionalProperties":false,"type":"object","required":["status"],"title":"Cost"},"Coverage":{"properties":{"requested":{"$ref":"#/components/schemas/Window"},"confirmed":{"items":{"$ref":"#/components/schemas/Window"},"type":"array","title":"Confirmed","default":[]},"unscanned":{"items":{"$ref":"#/components/schemas/Window"},"type":"array","title":"Unscanned","default":[]}},"additionalProperties":false,"type":"object","required":["requested"],"title":"Coverage"},"EmailInput":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"}},"additionalProperties":false,"type":"object","required":["email"],"title":"EmailInput"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IssuedKey":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"scopes":{"items":{"type":"string","enum":["monitors:read","monitors:write"]},"type":"array","title":"Scopes"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"key":{"type":"string","title":"Key"},"shown_once":{"type":"boolean","const":true,"title":"Shown Once"}},"type":"object","required":["id","name","prefix","scopes","expires_at","revoked_at","key","shown_once"],"title":"IssuedKey"},"KeyInput":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"scopes":{"items":{"type":"string","enum":["monitors:read","monitors:write"]},"type":"array","maxItems":2,"minItems":1,"title":"Scopes","default":["monitors:read"]},"expires_in_days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Expires In Days","default":30}},"additionalProperties":false,"type":"object","required":["name"],"title":"KeyInput"},"KeyList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/KeyView"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"KeyList"},"KeyView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"scopes":{"items":{"type":"string","enum":["monitors:read","monitors:write"]},"type":"array","title":"Scopes"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["id","name","prefix","scopes","expires_at","revoked_at"],"title":"KeyView"},"MonitorInput":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"query":{"type":"string","maxLength":300,"minLength":1,"title":"Query"},"communities":{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1,"title":"Communities"}},"additionalProperties":false,"type":"object","required":["name","query","communities"],"title":"MonitorInput"},"MonitorList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MonitorView"},"type":"array","title":"Items"},"mode":{"type":"string","enum":["private_offline","private_live","production"],"title":"Mode"}},"type":"object","required":["items","mode"],"title":"MonitorList"},"MonitorState":{"properties":{"status":{"type":"string","enum":["active","paused","stopped"],"title":"Status"}},"additionalProperties":false,"type":"object","required":["status"],"title":"MonitorState"},"MonitorView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"query":{"type":"string","title":"Query"},"communities":{"items":{"type":"string"},"type":"array","title":"Communities"},"status":{"type":"string","enum":["active","paused","stopped"],"title":"Status"},"cadence_seconds":{"type":"integer","title":"Cadence Seconds"},"next_check_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Check At"},"confirmed_through_utc":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confirmed Through Utc"},"blocked_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Reason"},"mode":{"type":"string","enum":["private_offline","private_live","production"],"title":"Mode"},"live_monitoring":{"type":"boolean","title":"Live Monitoring"},"latest_check":{"anyOf":[{"$ref":"#/components/schemas/CheckView"},{"type":"null"}]}},"type":"object","required":["id","name","query","communities","status","cadence_seconds","next_check_at","confirmed_through_utc","blocked_reason","mode","live_monitoring","latest_check"],"title":"MonitorView"},"ProviderIdentity":{"properties":{"name":{"type":"string","minLength":1,"title":"Name"},"version":{"type":"string","minLength":1,"title":"Version"},"illustrative":{"type":"boolean","title":"Illustrative","default":false}},"additionalProperties":false,"type":"object","required":["name","version"],"title":"ProviderIdentity"},"Retention":{"properties":{"policy_id":{"type":"string","minLength":1,"title":"Policy Id"},"content_permitted":{"type":"boolean","title":"Content Permitted"},"pooling_permitted":{"type":"boolean","title":"Pooling Permitted"},"expires_utc":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expires Utc"}},"additionalProperties":false,"type":"object","required":["policy_id","content_permitted","pooling_permitted"],"title":"Retention"},"SignIn":{"properties":{"token":{"type":"string","maxLength":16384,"minLength":1,"title":"Token"}},"additionalProperties":false,"type":"object","required":["token"],"title":"SignIn"},"SourceRecord":{"properties":{"source_system":{"type":"string","minLength":1,"title":"Source System","default":"reddit"},"source_id":{"type":"string","minLength":1,"title":"Source Id"},"kind":{"type":"string","enum":["post","comment"],"title":"Kind"},"community":{"type":"string","pattern":"^[a-z0-9_]+$","title":"Community"},"thread_id":{"type":"string","minLength":1,"title":"Thread Id"},"parent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Id"},"created_utc":{"type":"integer","minimum":0.0,"title":"Created Utc"},"original_url":{"type":"string","title":"Original Url"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"score":{"type":"integer","title":"Score","default":0},"visibility":{"type":"string","enum":["public","private","banned","quarantined","removed","deleted","unavailable"],"title":"Visibility"},"locked":{"type":"boolean","title":"Locked","default":false},"archived":{"type":"boolean","title":"Archived","default":false},"provider":{"$ref":"#/components/schemas/ProviderIdentity"},"fetched_utc":{"type":"integer","minimum":0.0,"title":"Fetched Utc"},"retention":{"$ref":"#/components/schemas/Retention"}},"additionalProperties":false,"type":"object","required":["source_id","kind","community","thread_id","created_utc","original_url","text","visibility","provider","fetched_utc","retention"],"title":"SourceRecord"},"SupportInput":{"properties":{"subject":{"type":"string","maxLength":120,"minLength":3,"title":"Subject"},"message":{"type":"string","maxLength":5000,"minLength":3,"title":"Message"}},"additionalProperties":false,"type":"object","required":["subject","message"],"title":"SupportInput"},"TokenInput":{"properties":{"token":{"type":"string","maxLength":128,"minLength":20,"title":"Token"}},"additionalProperties":false,"type":"object","required":["token"],"title":"TokenInput"},"UnavailableEvent":{"properties":{"id":{"type":"string","title":"Id"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"status":{"type":"string","const":"unavailable","title":"Status"}},"type":"object","required":["id","first_seen_at","status"],"title":"UnavailableEvent"},"UpdatePage":{"properties":{"monitor_id":{"type":"string","format":"uuid","title":"Monitor Id"},"items":{"items":{"oneOf":[{"$ref":"#/components/schemas/AvailableEvent"},{"$ref":"#/components/schemas/UnavailableEvent"}],"discriminator":{"propertyName":"status","mapping":{"available":"#/components/schemas/AvailableEvent","unavailable":"#/components/schemas/UnavailableEvent"}}},"type":"array","title":"Items"},"next_cursor":{"type":"string","title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"monitor":{"$ref":"#/components/schemas/MonitorView"}},"type":"object","required":["monitor_id","items","next_cursor","has_more","monitor"],"title":"UpdatePage"},"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"},"Window":{"properties":{"start_utc":{"type":"integer","minimum":0.0,"title":"Start Utc"},"end_utc":{"type":"integer","minimum":1.0,"title":"End Utc"}},"additionalProperties":false,"type":"object","required":["start_utc","end_utc"],"title":"Window"}},"securitySchemes":{"MonitorApiKey":{"type":"http","scheme":"bearer"}}}}