{"openapi":"3.1.0","info":{"title":"PoliData Public API","version":"0.1.0","description":"PoliData's service-to-service API for legislative data across the US Congress, the UK Parliament, the European Parliament, the Polish Sejm, the Dutch Tweede Kamer and the German Bundestag, for the parliaments in your plan. Bearer auth with API keys created in Settings → API (Pro, Business, Enterprise and Research Access). Rate limits apply per workspace, per minute and per hour.\n\nThe [developer guide](https://www.getpolidata.com/developers) covers authentication, pagination, rate limits, errors and webhooks: Standard Webhooks signature verification, secret rotation, retries and the catch-up `/events` endpoint. This reference covers the endpoint surface."},"servers":[{"url":"/","description":"PoliData API"}],"paths":{"/api/public/v1/legislative-items":{"get":{"tags":["external-legislative-items"],"summary":"List Legislative Items","description":"List legislative items, ordered by (updated_at, id), paginated by cursor.","operationId":"list_legislative_items_api_public_v1_legislative_items_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque pagination cursor from the previous response.","title":"Cursor"},"description":"Opaque pagination cursor from the previous response."},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only return items updated at or after this ISO-8601 timestamp.","title":"Updated Since"},"description":"Only return items updated at or after this ISO-8601 timestamp."},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"description":"Narrow results to a single jurisdiction.","title":"Jurisdiction"},"description":"Narrow results to a single jurisdiction."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Page size, 1–500 (default 100).","default":100,"title":"Limit"},"description":"Page size, 1–500 (default 100)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_LegislativeItemV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/legislative-items/{item_id}":{"get":{"tags":["external-legislative-items"],"summary":"Get Legislative Item","description":"Fetch a single legislative item by id.\n\nReturns 404 for both \"not found\" and \"exists but outside the API\nkey's jurisdiction allowlist\" — the two cases are deliberately\ncollapsed so jurisdiction-scoped consumers can't probe for the\nexistence of out-of-scope IDs.","operationId":"get_legislative_item_api_public_v1_legislative_items__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativeItemV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/people":{"get":{"tags":["external-people"],"summary":"List People","operationId":"list_people_api_public_v1_people_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_LegislativePersonV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/people/{person_id}":{"get":{"tags":["external-people"],"summary":"Get Person","operationId":"get_person_api_public_v1_people__person_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string","title":"Person Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativePersonV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/votes":{"get":{"tags":["external-votes"],"summary":"List Votes","operationId":"list_votes_api_public_v1_votes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_LegislativeVoteV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/votes/{vote_id}":{"get":{"tags":["external-votes"],"summary":"Get Vote","operationId":"get_vote_api_public_v1_votes__vote_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"vote_id","in":"path","required":true,"schema":{"type":"string","title":"Vote Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativeVoteV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/vote-records":{"get":{"tags":["external-vote-records"],"summary":"List Vote Records","operationId":"list_vote_records_api_public_v1_vote_records_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_LegislativeVoteRecordV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/vote-records/{vote_event_id}/{source_person_id}":{"get":{"tags":["external-vote-records"],"summary":"Get Vote Record","description":"Composite-key lookup: path is ``/{vote_event_id}/{source_person_id}``.\n\nReturns 404 for either \"not found\" or \"jurisdiction-restricted\",\nsame anti-existence-probe semantics as the other single-entity\nendpoints.","operationId":"get_vote_record_api_public_v1_vote_records__vote_event_id___source_person_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"vote_event_id","in":"path","required":true,"schema":{"type":"string","title":"Vote Event Id"}},{"name":"source_person_id","in":"path","required":true,"schema":{"type":"string","title":"Source Person Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativeVoteRecordV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/committees":{"get":{"tags":["external-committees"],"summary":"List Committees","operationId":"list_committees_api_public_v1_committees_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_LegislativeCommitteeV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/committees/{committee_id}":{"get":{"tags":["external-committees"],"summary":"Get Committee","operationId":"get_committee_api_public_v1_committees__committee_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"committee_id","in":"path","required":true,"schema":{"type":"string","title":"Committee Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativeCommitteeV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/parties":{"get":{"tags":["external-parties"],"summary":"List Parties","operationId":"list_parties_api_public_v1_parties_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_LegislativePartyV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/parties/{party_id}":{"get":{"tags":["external-parties"],"summary":"Get Party","operationId":"get_party_api_public_v1_parties__party_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"party_id","in":"path","required":true,"schema":{"type":"string","title":"Party Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegislativePartyV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/webhooks/event-types":{"get":{"tags":["external-webhooks"],"summary":"List Webhook Event Types","description":"Every event type an endpoint can subscribe to, with what triggers it.\n\nLifecycle events (``bill.introduced``, ``bill.updated``,\n``vote.recorded``, ``committee.scheduled``) come first, then each\nrecord's ``created``/``updated``. Types are added over time and never\nrenamed or removed; an endpoint with no ``event_types`` receives all of\nthem, including new ones.","operationId":"list_webhook_event_types_api_public_v1_webhooks_event_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventTypesResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/public/v1/webhooks":{"get":{"tags":["external-webhooks"],"summary":"List Webhooks","description":"List webhook endpoints registered for the API key's organization.","operationId":"list_webhooks_api_public_v1_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["external-webhooks"],"summary":"Mint Webhook","description":"Register a new webhook endpoint. The plain signing secret is returned\nONCE in the response body — the consumer must store it now to verify\nincoming ``webhook-signature`` headers (Standard Webhooks).","operationId":"mint_webhook_api_public_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointMintRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointMintResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/public/v1/webhooks/{endpoint_id}":{"patch":{"tags":["external-webhooks"],"summary":"Update Webhook","description":"Patch mutable fields (url, label, filters, enabled).","operationId":"update_webhook_api_public_v1_webhooks__endpoint_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["external-webhooks"],"summary":"Disable Webhook","description":"Soft-delete a webhook endpoint. Delivery history is preserved for audit.","operationId":"disable_webhook_api_public_v1_webhooks__endpoint_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/webhooks/{endpoint_id}/rotate-secret":{"post":{"tags":["external-webhooks"],"summary":"Rotate Webhook Secret","description":"Rotate the signing secret.\n\nReturns the new plain secret ONCE. The old secret continues to sign\noutgoing requests for a 24-hour grace window (multi-signature header,\nper Standard Webhooks §Signature Rotation) so a consumer can roll\ntheir verifier config without dropping events mid-deploy. After the\ngrace window the old secret is dropped.","operationId":"rotate_webhook_secret_api_public_v1_webhooks__endpoint_id__rotate_secret_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSecretRotateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/webhooks/{endpoint_id}/deliveries":{"get":{"tags":["external-webhooks"],"summary":"List Endpoint Deliveries","description":"Paginated delivery history for one endpoint.\n\nConsumers use this to debug \"did my receiver get event X?\" without\noperator round-trips. ``?status=dead_letter`` is the most useful filter:\nsurfaces every event whose delivery hit a permanent 4xx or exhausted the\nretry budget.\n\nCursor format mirrors the entity collection endpoints — opaque base64\nover ``(created_at, id)``.","operationId":"list_endpoint_deliveries_api_public_v1_webhooks__endpoint_id__deliveries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(pending|in_flight|delivered|dead_letter)$"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/webhooks/{endpoint_id}/test":{"post":{"tags":["external-webhooks"],"summary":"Test Webhook","description":"Send a synthetic ``webhook.test`` event to the endpoint NOW.\n\nBypasses the outbox fan-out path so consumers get immediate feedback\non whether their receiver is reachable and their signature verification\nworks. Returns the receiver's response status + latency. No retry — a\nsingle attempt only. No idempotency — each call uses a fresh delivery_id.\n\nRate limiting is enforced at the service-key auth layer (the\norganization's per-minute and hourly tier quotas in\n``require_service_key`` → ``rate_limit_service``). Don't add\na separate cap here unless usage data shows the global quota is too\nloose for outbound-network endpoints.\n\nThe event has ``aggregate_type=\"webhook\"`` and a payload identifying\nit as a test, so consumers can detect + ignore it server-side. The\nrequest itself is built and sent by ``webhooks_service.send_test_event``,\nshared with the in-app ``/organizations/me/webhooks/{id}/test``; it\nre-checks the URL against private targets first (``unsafe_url``).","operationId":"test_webhook_api_public_v1_webhooks__endpoint_id__test_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestPingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/events":{"get":{"tags":["external-events"],"summary":"List Events","description":"Stream outbox events older→newer with cursor pagination.\n\nTypical recovery flow after a consumer outage:\n\n1. Consumer's webhook receiver was down 2 hours.\n2. Some deliveries dead-lettered (retry budget exhausted) — consumer\n   knows because their delivery introspection endpoint shows them.\n3. Consumer calls ``GET /events?cursor=<last_seen_cursor>`` and walks\n   forward through the missed events with the same wire format.\n4. Once caught up, they resume processing live webhook deliveries.\n\nIf the consumer's last cursor is older than ``DEFAULT_RETENTION_DAYS``\n(30) the catch-up is unrecoverable — the source rows have been\npruned. Return ``410 Gone`` with a hint to bulk-resync via the\nper-entity REST endpoints (``/people``, ``/legislative-items``, etc.).","operationId":"list_events_api_public_v1_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"types","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated event_type values to filter on. Example: ?types=bill.introduced,legislative_party.created. The catalog is GET /api/public/v1/webhooks/event-types.","title":"Types"},"description":"Comma-separated event_type values to filter on. Example: ?types=bill.introduced,legislative_party.created. The catalog is GET /api/public/v1/webhooks/event-types."},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(US|UK|PL|NL|EU|DE)$"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseV1_EventEnvelopeV1_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"APIEntitlementJurisdiction":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"web_access":{"type":"boolean","title":"Web Access"},"api_access":{"type":"boolean","title":"Api Access"}},"type":"object","required":["code","name","web_access","api_access"],"title":"APIEntitlementJurisdiction"},"APIEntitlementsResponse":{"properties":{"subscription_tier":{"type":"string","title":"Subscription Tier"},"api_enabled_jurisdictions":{"items":{"type":"string"},"type":"array","title":"Api Enabled Jurisdictions"},"jurisdictions":{"items":{"$ref":"#/components/schemas/APIEntitlementJurisdiction"},"type":"array","title":"Jurisdictions"}},"type":"object","required":["subscription_tier","api_enabled_jurisdictions","jurisdictions"],"title":"APIEntitlementsResponse"},"APIHourlyUsage":{"properties":{"used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Used","description":"Null when the counters cannot be read right now."},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"},"resets_in":{"type":"integer","title":"Resets In","description":"Seconds until the current hour window closes."},"scope":{"type":"string","title":"Scope","description":"\"per_org\": the limit is shared by all of the organization's keys."}},"type":"object","required":["used","limit","resets_in","scope"],"title":"APIHourlyUsage"},"APIKeyListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/APIKeySummary"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"APIKeyListResponse"},"APIKeyMintRequest":{"properties":{"owner_label":{"type":"string","maxLength":200,"minLength":1,"title":"Owner Label"},"expires_in_days":{"type":"integer","title":"Expires In Days","description":"Number of days until the key expires. Must be one of the industry-standard ranges (30, 60, 90, 180, 365).","default":90},"narrow_to":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Narrow To","description":"Optional list of ISO-2 codes to narrow this key BELOW the org's full API entitlements. Each must be a subset of the org's api_access=true jurisdictions. Null = full set."}},"type":"object","required":["owner_label"],"title":"APIKeyMintRequest"},"APIKeyMintResponse":{"properties":{"key":{"$ref":"#/components/schemas/APIKeySummary"},"plain_key":{"type":"string","title":"Plain Key","description":"The actual key. Shown ONCE — store it now; cannot be recovered."}},"type":"object","required":["key","plain_key"],"title":"APIKeyMintResponse"},"APIKeyRegenerateRequest":{"properties":{"expires_in_days":{"type":"integer","title":"Expires In Days","default":90}},"type":"object","title":"APIKeyRegenerateRequest"},"APIKeySummary":{"properties":{"id":{"type":"string","title":"Id"},"key_prefix":{"type":"string","title":"Key Prefix"},"owner_label":{"type":"string","title":"Owner Label"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"jurisdiction_allowlist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Jurisdiction Allowlist"},"rate_limit_tier":{"type":"string","title":"Rate Limit Tier"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By Email"},"regenerated_from_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Regenerated From Key Id"}},"additionalProperties":false,"type":"object","required":["id","key_prefix","owner_label","scopes","rate_limit_tier","created_at"],"title":"APIKeySummary","description":"Public-safe metadata for one API key. Never includes the plain key."},"APIMonthlyUsage":{"properties":{"used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Used","description":"Null when the counters cannot be read right now."},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"},"resets_at":{"type":"string","format":"date-time","title":"Resets At","description":"Start of the next calendar month (UTC)."}},"type":"object","required":["used","limit","resets_at"],"title":"APIMonthlyUsage"},"APIUsageResponse":{"properties":{"tier":{"type":"string","title":"Tier"},"api_access":{"type":"boolean","title":"Api Access"},"keys":{"type":"integer","title":"Keys","description":"API keys that can make requests now."},"hourly":{"anyOf":[{"$ref":"#/components/schemas/APIHourlyUsage"},{"type":"null"}]},"monthly":{"anyOf":[{"$ref":"#/components/schemas/APIMonthlyUsage"},{"type":"null"}]}},"type":"object","required":["tier","api_access","keys"],"title":"APIUsageResponse"},"AccessInviteCreateRequest":{"properties":{"label":{"type":"string","maxLength":120,"minLength":1,"title":"Label"},"tier":{"type":"string","enum":["explorer","team","pro","business","enterprise","research"],"title":"Tier"},"grant_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Grant Days"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"valid_days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Valid Days","default":30},"send_email":{"type":"boolean","title":"Send Email","default":false},"recipient_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Recipient Name"}},"additionalProperties":false,"type":"object","required":["label","tier","grant_days"],"title":"AccessInviteCreateRequest"},"AccessInviteTestEmailRequest":{"properties":{"tier":{"type":"string","enum":["explorer","team","pro","business","enterprise","research"],"title":"Tier"},"grant_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Grant Days"},"recipient_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Recipient Name"},"valid_days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Valid Days","default":30}},"additionalProperties":false,"type":"object","required":["tier","grant_days"],"title":"AccessInviteTestEmailRequest"},"ActivitySettingsIn":{"properties":{"personalization_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Personalization Enabled"},"sources":{"anyOf":[{"$ref":"#/components/schemas/ActivitySourcesIn"},{"type":"null"}]},"suggestions":{"anyOf":[{"$ref":"#/components/schemas/ActivitySuggestionsIn"},{"type":"null"}]},"topics":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":12},{"type":"null"}],"title":"Topics"}},"type":"object","title":"ActivitySettingsIn","description":"Partial update: omitted fields keep their current value."},"ActivitySourcesIn":{"properties":{"opened":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Opened"},"searches":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Searches"},"topics":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Topics"},"engagement":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Engagement"}},"type":"object","title":"ActivitySourcesIn"},"ActivitySuggestionsIn":{"properties":{"continue":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Continue"},"related":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Related"},"compare":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Compare"}},"type":"object","title":"ActivitySuggestionsIn","description":"Which personal suggestion types Explore's \"For you\" shows."},"ActorLegislativeItemsResponse":{"properties":{"actor":{"$ref":"#/components/schemas/ActorProfile"},"legislative_items":{"items":{"$ref":"#/components/schemas/LegislativeItemListEntry"},"type":"array","title":"Legislative Items"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"},"meta":{"$ref":"#/components/schemas/LegislativeItemsMeta"}},"type":"object","required":["actor","legislative_items","pagination","meta"],"title":"ActorLegislativeItemsResponse","description":"Response for an actor profile's linked legislative items."},"ActorProfile":{"properties":{"actor_type":{"type":"string","enum":["person","committee","organization"],"title":"Actor Type"},"actor_id":{"type":"string","title":"Actor Id"},"name":{"type":"string","title":"Name"},"jurisdiction":{"type":"string","title":"Jurisdiction"}},"type":"object","required":["actor_type","actor_id","name","jurisdiction"],"title":"ActorProfile","description":"Actor profile envelope used by actor->items endpoint."},"ActorVoteHistoryEntry":{"properties":{"bill":{"$ref":"#/components/schemas/VoteLinkedBillSummary"},"vote_event":{"$ref":"#/components/schemas/VoteEventSummary"},"person_record":{"$ref":"#/components/schemas/PersonVoteRecord"}},"type":"object","required":["bill","vote_event","person_record"],"title":"ActorVoteHistoryEntry","description":"One actor vote-history row linking bill, event, and person record."},"ActorVotesResponse":{"properties":{"actor":{"$ref":"#/components/schemas/ActorProfile"},"votes":{"items":{"$ref":"#/components/schemas/ActorVoteHistoryEntry"},"type":"array","title":"Votes"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"}},"type":"object","required":["actor","pagination","coverage"],"title":"ActorVotesResponse","description":"Vote-history response for a person actor."},"AdhocReportRequest":{"properties":{"kind":{"type":"string","title":"Kind"},"scope":{"additionalProperties":true,"type":"object","title":"Scope"},"period":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Period"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"timezone":{"type":"string","maxLength":64,"title":"Timezone","default":"UTC"},"formats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Formats"},"schedule_type":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Schedule Type"}},"type":"object","required":["kind"],"title":"AdhocReportRequest","description":"An unsaved report definition — editor preview or one-off export."},"AdminAPIAccessToggleRequest":{"properties":{"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"enabled":{"type":"boolean","title":"Enabled"}},"additionalProperties":false,"type":"object","required":["jurisdiction_code","enabled"],"title":"AdminAPIAccessToggleRequest","description":"Toggle ``organization_jurisdictions.api_access`` for one (org, jurisdiction)."},"AdminAuditLogItem":{"properties":{"id":{"type":"string","title":"Id"},"platform_admin_id":{"type":"string","title":"Platform Admin Id"},"platform_admin_email":{"type":"string","format":"email","title":"Platform Admin Email"},"action":{"type":"string","title":"Action"},"target_type":{"type":"string","title":"Target Type"},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","platform_admin_id","platform_admin_email","action","target_type","created_at"],"title":"AdminAuditLogItem","description":"Audit event row for company admin action history."},"AdminAuditLogsListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminAuditLogItem"},"type":"array","title":"Items"},"pagination":{"$ref":"#/components/schemas/AdminListPagination"}},"type":"object","required":["items","pagination"],"title":"AdminAuditLogsListResponse","description":"Paginated admin audit-log listing response."},"AdminBackfillConfigUpdateRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"},"config":{"oneOf":[{"$ref":"#/components/schemas/BackfillTermConfig"},{"$ref":"#/components/schemas/BackfillWindowConfig"},{"$ref":"#/components/schemas/BackfillTermWindowedConfig"}],"title":"Config","discriminator":{"propertyName":"type","mapping":{"term":"#/components/schemas/BackfillTermConfig","term_windowed":"#/components/schemas/BackfillTermWindowedConfig","window":"#/components/schemas/BackfillWindowConfig"}}}},"type":"object","required":["jurisdiction_code","config"],"title":"AdminBackfillConfigUpdateRequest","description":"Payload for updating a jurisdiction's backfill configuration."},"AdminBackfillPauseRequest":{"properties":{"reason":{"type":"string","maxLength":500,"minLength":3,"title":"Reason"}},"type":"object","required":["reason"],"title":"AdminBackfillPauseRequest","description":"Payload for pausing backfill for a jurisdiction. Reason is required."},"AdminBackfillResetRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"}},"type":"object","required":["jurisdiction_code"],"title":"AdminBackfillResetRequest","description":"Payload for resetting backfill progress for a jurisdiction."},"AdminBackfillResumeRequest":{"properties":{},"type":"object","title":"AdminBackfillResumeRequest","description":"Payload for resuming backfill for a jurisdiction."},"AdminBackfillTriggerRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"},"term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Term","description":"Specific term to backfill (e.g. US-118)."},"days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Days","description":"Lookback window in days."},"from_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From Date","description":"Start of date range for backfill (YYYY-MM-DD)."},"to_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To Date","description":"End of date range for backfill (YYYY-MM-DD)."}},"type":"object","required":["jurisdiction_code"],"title":"AdminBackfillTriggerRequest","description":"Payload for triggering a manual backfill run for a jurisdiction."},"AdminCursorResetRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"},"source_system":{"type":"string","maxLength":50,"minLength":2,"title":"Source System"},"new_cursor_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Cursor Value","description":"If null/missing, deletes the cursor row (full re-sync). If provided, updates cursor_value."}},"type":"object","required":["jurisdiction_code","source_system"],"title":"AdminCursorResetRequest","description":"Payload for resetting a sync cursor to force re-sync or rewind."},"AdminEmailErrorItem":{"properties":{"event_type":{"type":"string","title":"Event Type"},"recipient_email":{"type":"string","title":"Recipient Email"},"subject":{"type":"string","title":"Subject"},"status":{"type":"string","title":"Status"},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Code"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"provider_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Message Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["event_type","recipient_email","subject","status","created_at"],"title":"AdminEmailErrorItem","description":"Single email delivery issue row for admin troubleshooting."},"AdminEmailErrorsResponse":{"properties":{"window_hours":{"type":"integer","title":"Window Hours"},"status_filter":{"type":"string","enum":["failed","skipped","all"],"title":"Status Filter"},"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/AdminEmailErrorItem"},"type":"array","title":"Items"}},"type":"object","required":["window_hours","status_filter","count","items"],"title":"AdminEmailErrorsResponse","description":"Email issue list response for admin observability."},"AdminExtendTrialRequest":{"properties":{"days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Days"}},"additionalProperties":false,"type":"object","required":["days"],"title":"AdminExtendTrialRequest"},"AdminForceLogoutRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"AdminForceLogoutRequest","description":"Payload for forced session revocation actions."},"AdminGdprActionRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"},"confirm":{"type":"boolean","title":"Confirm","default":true}},"type":"object","title":"AdminGdprActionRequest","description":"Payload for GDPR export/delete actions."},"AdminHealthEndpointState":{"properties":{"label":{"type":"string","title":"Label"},"path":{"type":"string","title":"Path"},"http_status":{"type":"integer","title":"Http Status"},"state":{"type":"string","title":"State"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["label","path","http_status","state"],"title":"AdminHealthEndpointState","description":"State for one health endpoint exposed by the platform."},"AdminHealthRedisQueueState":{"properties":{"queue":{"type":"string","enum":["sync","match","digest_send","raw","project","bill_text","llm_summarize","llm_summarize_priority"],"title":"Queue"},"stream":{"type":"string","title":"Stream"},"depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depth"},"dead_letter_depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dead Letter Depth"},"dead_letter_unique_depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dead Letter Unique Depth"},"dead_letter_oldest_failed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Dead Letter Oldest Failed At"},"status":{"type":"string","enum":["healthy","warning","down"],"title":"Status"}},"type":"object","required":["queue","stream","status"],"title":"AdminHealthRedisQueueState","description":"Health/status snapshot for one Redis stream queue."},"AdminHealthSummaryResponse":{"properties":{"checked_at":{"type":"string","format":"date-time","title":"Checked At"},"overall_status":{"type":"string","enum":["ok","degraded"],"title":"Overall Status"},"endpoints":{"items":{"$ref":"#/components/schemas/AdminHealthEndpointState"},"type":"array","title":"Endpoints"},"components":{"additionalProperties":true,"type":"object","title":"Components"},"redis_queues":{"items":{"$ref":"#/components/schemas/AdminHealthRedisQueueState"},"type":"array","title":"Redis Queues"},"dead_letter_count":{"type":"integer","title":"Dead Letter Count"},"dead_letters":{"items":{"$ref":"#/components/schemas/AdminQueueDeadLetterItem"},"type":"array","title":"Dead Letters"}},"type":"object","required":["checked_at","overall_status","endpoints","components","redis_queues","dead_letter_count","dead_letters"],"title":"AdminHealthSummaryResponse","description":"Platform health summary for the admin dashboard."},"AdminIngestRetryRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"},"source_system":{"anyOf":[{"type":"string","maxLength":50,"minLength":2},{"type":"null"}],"title":"Source System"},"days":{"type":"integer","maximum":60.0,"minimum":1.0,"title":"Days","default":7}},"type":"object","required":["jurisdiction_code"],"title":"AdminIngestRetryRequest","description":"Payload for retrying ingestion using latest failed run context."},"AdminIngestSourceControlRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"},"source_system":{"type":"string","maxLength":50,"minLength":2,"title":"Source System"},"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","required":["jurisdiction_code","source_system"],"title":"AdminIngestSourceControlRequest","description":"Payload for pausing or resuming ingest sources."},"AdminIngestTriggerAllRequest":{"properties":{"stage":{"type":"string","enum":["full","raw_only","projection_only"],"title":"Stage","description":"Pipeline stage to execute for all jurisdictions.","default":"full"}},"type":"object","title":"AdminIngestTriggerAllRequest","description":"Payload for triggering ingestion for all jurisdictions."},"AdminIngestTriggerProjectionRequest":{"properties":{"raw_run_id":{"type":"string","minLength":1,"title":"Raw Run Id","description":"The raw_ingest_runs.id to project."},"term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Term"}},"type":"object","required":["raw_run_id"],"title":"AdminIngestTriggerProjectionRequest","description":"Payload for re-projecting a specific raw staging run."},"AdminIngestTriggerRequest":{"properties":{"jurisdiction_code":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction Code"},"days":{"type":"integer","maximum":3650.0,"minimum":1.0,"title":"Days","default":7},"term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Term"},"stage":{"type":"string","enum":["full","raw_only","projection_only"],"title":"Stage","description":"Pipeline stage to execute: full (raw+projection), raw_only, or projection_only.","default":"full"},"raw_run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Run Id","description":"Required when stage is 'projection_only'. The raw_ingest_runs.id to project."},"max_bill_pages":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Bill Pages"},"page_size":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Page Size"},"max_votes_per_member":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Votes Per Member"}},"type":"object","required":["jurisdiction_code"],"title":"AdminIngestTriggerRequest","description":"Payload for triggering ingestion for a jurisdiction."},"AdminListPagination":{"properties":{"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"total":{"type":"integer","title":"Total"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["page","per_page","total","pages"],"title":"AdminListPagination","description":"Standard pagination metadata for admin list responses."},"AdminLockUserRequest":{"properties":{"reason":{"type":"string","maxLength":500,"minLength":3,"title":"Reason"}},"type":"object","required":["reason"],"title":"AdminLockUserRequest","description":"Payload for locking a user account."},"AdminOrganizationCounts":{"properties":{"users":{"type":"integer","title":"Users"},"admins":{"type":"integer","title":"Admins"},"members":{"type":"integer","title":"Members"},"jurisdictions":{"type":"integer","title":"Jurisdictions"}},"type":"object","required":["users","admins","members","jurisdictions"],"title":"AdminOrganizationCounts","description":"Organization-level related entity counters for admin listing."},"AdminOrganizationListItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"subscription_tier":{"type":"string","title":"Subscription Tier"},"subscription_status":{"type":"string","title":"Subscription Status"},"user_limit":{"type":"integer","title":"User Limit"},"keyword_limit":{"type":"integer","title":"Keyword Limit"},"workspace_kind":{"type":"string","enum":["personal","team"],"title":"Workspace Kind"},"counts":{"$ref":"#/components/schemas/AdminOrganizationCounts"},"trial_ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Trial Ends At"},"current_period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Current Period End"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"deleted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deleted At"}},"type":"object","required":["id","name","subscription_tier","subscription_status","user_limit","keyword_limit","workspace_kind","counts","created_at","updated_at"],"title":"AdminOrganizationListItem","description":"Organization summary row in admin organization listing."},"AdminOrganizationSubscriptionUpdateRequest":{"properties":{"subscription_tier":{"anyOf":[{"type":"string","enum":["explorer","team","pro","business"]},{"type":"null"}],"title":"Subscription Tier"},"subscription_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Status"},"user_limit":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"User Limit"},"keyword_limit":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Keyword Limit"}},"type":"object","title":"AdminOrganizationSubscriptionUpdateRequest","description":"Payload for company admins to edit organization subscription settings."},"AdminOrganizationsListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminOrganizationListItem"},"type":"array","title":"Items"},"pagination":{"$ref":"#/components/schemas/AdminListPagination"}},"type":"object","required":["items","pagination"],"title":"AdminOrganizationsListResponse","description":"Paginated organization listing response for admin panel."},"AdminOverviewOperational":{"properties":{"failed_sync_runs":{"type":"integer","title":"Failed Sync Runs"},"email":{"additionalProperties":true,"type":"object","title":"Email"}},"type":"object","required":["failed_sync_runs","email"],"title":"AdminOverviewOperational","description":"Operational health aggregate for the admin overview endpoint."},"AdminOverviewResponse":{"properties":{"window_hours":{"type":"integer","title":"Window Hours"},"totals":{"$ref":"#/components/schemas/AdminOverviewTotals"},"operational":{"$ref":"#/components/schemas/AdminOverviewOperational"}},"type":"object","required":["window_hours","totals","operational"],"title":"AdminOverviewResponse","description":"Top-level admin overview response."},"AdminOverviewTotals":{"properties":{"organizations":{"type":"integer","title":"Organizations"},"users":{"type":"integer","title":"Users"},"admins":{"type":"integer","title":"Admins"},"members":{"type":"integer","title":"Members"},"unverified_users":{"type":"integer","title":"Unverified Users"},"active_invites":{"type":"integer","title":"Active Invites"}},"type":"object","required":["organizations","users","admins","members","unverified_users","active_invites"],"title":"AdminOverviewTotals","description":"Global object count totals for the admin overview endpoint."},"AdminQueueDeadLetterItem":{"properties":{"queue":{"type":"string","enum":["sync","match","digest_send","raw","project","bill_text","llm_summarize","llm_summarize_priority"],"title":"Queue"},"dead_letter_stream":{"type":"string","title":"Dead Letter Stream"},"message_id":{"type":"string","title":"Message Id"},"source_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Message Id"},"group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Name"},"consumer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consumer Name"},"delivery_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Delivery Count"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"failed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Failed At"},"work_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Work Identity"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"}},"type":"object","required":["queue","dead_letter_stream","message_id"],"title":"AdminQueueDeadLetterItem","description":"One dead-letter queue message for admin troubleshooting."},"AdminQueueDeadLettersResponse":{"properties":{"queue_filter":{"type":"string","enum":["all","sync","match","digest_send","raw","project","bill_text","llm_summarize","llm_summarize_priority"],"title":"Queue Filter"},"limit":{"type":"integer","title":"Limit"},"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/AdminQueueDeadLetterItem"},"type":"array","title":"Items"}},"type":"object","required":["queue_filter","limit","count","items"],"title":"AdminQueueDeadLettersResponse","description":"Dead-letter queue listing response for admin observability."},"AdminRestoreOrganizationRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"AdminRestoreOrganizationRequest","description":"Payload for restoring a soft-deleted organization within its window."},"AdminRetentionApplyRequest":{"properties":{"dry_run":{"type":"boolean","title":"Dry Run","default":true}},"type":"object","title":"AdminRetentionApplyRequest","description":"Payload for applying configured retention policies."},"AdminRetentionPolicyUpdateRequest":{"properties":{"retention_days":{"type":"integer","maximum":3650.0,"minimum":1.0,"title":"Retention Days"}},"type":"object","required":["retention_days"],"title":"AdminRetentionPolicyUpdateRequest","description":"Payload for configuring data retention windows."},"AdminSetJurisdictionsRequest":{"properties":{"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":0,"title":"Jurisdiction Codes"}},"type":"object","required":["jurisdiction_codes"],"title":"AdminSetJurisdictionsRequest","description":"Payload for directly setting an org's jurisdiction entitlements."},"AdminSupportActionRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"AdminSupportActionRequest","description":"Payload for support actions on user accounts."},"AdminSuspendOrganizationRequest":{"properties":{"reason":{"type":"string","maxLength":500,"minLength":3,"title":"Reason"}},"type":"object","required":["reason"],"title":"AdminSuspendOrganizationRequest","description":"Payload for suspending an organization account."},"AdminSyncErrorItem":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"source_system":{"type":"string","title":"Source System"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"finished_at":{"type":"string","format":"date-time","title":"Finished At"}},"type":"object","required":["id","jurisdiction_code","source_system","started_at","finished_at"],"title":"AdminSyncErrorItem","description":"Single failed sync run row for admin troubleshooting."},"AdminSyncErrorsResponse":{"properties":{"window_hours":{"type":"integer","title":"Window Hours"},"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/AdminSyncErrorItem"},"type":"array","title":"Items"}},"type":"object","required":["window_hours","count","items"],"title":"AdminSyncErrorsResponse","description":"Failed sync list response for admin observability."},"AdminTransferOwnershipRequest":{"properties":{"new_owner_user_id":{"type":"string","title":"New Owner User Id"},"keep_previous_owner_as_admin":{"type":"boolean","title":"Keep Previous Owner As Admin","default":true},"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","required":["new_owner_user_id"],"title":"AdminTransferOwnershipRequest","description":"Payload for transferring organization ownership to another user."},"AdminUnlockUserRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"AdminUnlockUserRequest","description":"Payload for unlocking a user account."},"AdminUnsuspendOrganizationRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"AdminUnsuspendOrganizationRequest","description":"Payload for unsuspending an organization account."},"AdminUserEmailDeliveryItem":{"properties":{"event_type":{"type":"string","title":"Event Type"},"recipient_email":{"type":"string","format":"email","title":"Recipient Email"},"subject":{"type":"string","title":"Subject"},"status":{"type":"string","title":"Status"},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Code"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"provider_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Message Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["event_type","recipient_email","subject","status","created_at"],"title":"AdminUserEmailDeliveryItem","description":"Recent email delivery record for a specific user recipient address."},"AdminUserEmailDeliveryResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","format":"email","title":"User Email"},"status_filter":{"type":"string","enum":["all","sent","failed","skipped"],"title":"Status Filter"},"event_scope":{"type":"string","enum":["all","auth","digest","ingest","system"],"title":"Event Scope"},"limit":{"type":"integer","title":"Limit"},"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/AdminUserEmailDeliveryItem"},"type":"array","title":"Items"}},"type":"object","required":["user_id","user_email","status_filter","event_scope","limit","count","items"],"title":"AdminUserEmailDeliveryResponse","description":"Email delivery history payload for a single user."},"AdminUserListItem":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"role":{"type":"string","title":"Role"},"email_verified":{"type":"boolean","title":"Email Verified"},"organization_id":{"type":"string","title":"Organization Id"},"organization_name":{"type":"string","title":"Organization Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_login_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Login At"}},"type":"object","required":["id","email","role","email_verified","organization_id","organization_name","created_at"],"title":"AdminUserListItem","description":"User summary row in admin user listing."},"AdminUserRoleUpdateRequest":{"properties":{"role":{"type":"string","enum":["admin","member"],"title":"Role"}},"type":"object","required":["role"],"title":"AdminUserRoleUpdateRequest","description":"Payload for company admins to change a user's workspace role."},"AdminUsersListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminUserListItem"},"type":"array","title":"Items"},"pagination":{"$ref":"#/components/schemas/AdminListPagination"}},"type":"object","required":["items","pagination"],"title":"AdminUsersListResponse","description":"Paginated user listing response for admin panel."},"AiSummaryProvenance":{"properties":{"model":{"type":"string","title":"Model"},"prompt_version":{"type":"string","title":"Prompt Version"},"confidence":{"type":"number","title":"Confidence"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"source_jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Jurisdiction"},"source_notes":{"items":{"type":"string"},"type":"array","title":"Source Notes"}},"type":"object","required":["model","prompt_version","confidence","generated_at"],"title":"AiSummaryProvenance","description":"Provenance metadata for an AI-generated bill summary (#126).\n\nMirrors what ``services/llm/tasks/summarize_bill.py`` writes into\n``legislative_items.metadata.ai_provenance.summarize_bill``. The\nfrontend uses this to drive the \"AI-generated summary — may contain\nerrors\" disclaimer and to surface model/version info on hover."},"AlertClusterConvertRequest":{"properties":{"subject_type":{"type":"string","maxLength":20,"minLength":1,"title":"Subject Type"},"subject_id":{"type":"string","maxLength":64,"minLength":1,"title":"Subject Id"},"alert_ids":{"items":{"type":"string"},"type":"array","minItems":2,"title":"Alert Ids"},"watchlist_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Watchlist Name"}},"type":"object","required":["subject_type","subject_id","alert_ids"],"title":"AlertClusterConvertRequest","description":"Payload for converting a cluster onto a shared watchlist."},"AlertClusterConvertResponse":{"properties":{"watchlist_id":{"type":"string","title":"Watchlist Id"},"subject_type":{"type":"string","title":"Subject Type"},"subject_id":{"type":"string","title":"Subject Id"},"alert_ids":{"items":{"type":"string"},"type":"array","title":"Alert Ids"}},"type":"object","required":["watchlist_id","subject_type","subject_id","alert_ids"],"title":"AlertClusterConvertResponse","description":"Result of a one-click cluster→watchlist migration."},"AlertClusterItem":{"properties":{"subject_type":{"type":"string","title":"Subject Type"},"subject_id":{"type":"string","title":"Subject Id"},"subject_label":{"type":"string","title":"Subject Label"},"alert_ids":{"items":{"type":"string"},"type":"array","title":"Alert Ids"}},"type":"object","required":["subject_type","subject_id","subject_label","alert_ids"],"title":"AlertClusterItem","description":"A group of >=2 alerts that share the same direct subject target."},"AlertClustersResponse":{"properties":{"clusters":{"items":{"$ref":"#/components/schemas/AlertClusterItem"},"type":"array","title":"Clusters"}},"type":"object","required":["clusters"],"title":"AlertClustersResponse","description":"Wrapper for the duplicate-target detection feed."},"AlertCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"jurisdiction":{"type":"string","maxLength":10,"minLength":2,"title":"Jurisdiction"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"item_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Item Types"},"alert_type":{"type":"string","maxLength":32,"title":"Alert Type","default":"keyword"},"category":{"type":"string","maxLength":20,"title":"Category","default":"keyword"},"target_actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Actor Id"},"target_bill_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Bill Id"},"target_committee_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Committee Id"},"target_topic_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Target Topic Label"},"rule_json":{"additionalProperties":true,"type":"object","title":"Rule Json"},"jurisdiction_scope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Jurisdiction Scope"},"delivery_mode":{"type":"string","maxLength":32,"title":"Delivery Mode","default":"digest"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"type":"string","enum":["low","normal","high"],"title":"Priority","default":"normal"},"enabled":{"type":"boolean","title":"Enabled","default":true},"watchlist_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Watchlist Ids"},"reminder_lead_minutes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Reminder Lead Minutes"}},"type":"object","required":["name","jurisdiction"],"title":"AlertCreateRequest","description":"Payload for creating a jurisdiction-scoped alert."},"AlertItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"jurisdiction_metadata":{"additionalProperties":true,"type":"object","title":"Jurisdiction Metadata"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"item_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Item Types"},"enabled":{"type":"boolean","title":"Enabled"},"alert_type":{"type":"string","title":"Alert Type","default":"keyword"},"category":{"type":"string","title":"Category","default":"keyword"},"target_actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Actor Id"},"target_bill_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Bill Id"},"target_committee_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Committee Id"},"target_topic_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Topic Label"},"rule_json":{"additionalProperties":true,"type":"object","title":"Rule Json"},"jurisdiction_scope":{"additionalProperties":true,"type":"object","title":"Jurisdiction Scope"},"delivery_mode":{"type":"string","title":"Delivery Mode","default":"digest"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"priority":{"type":"string","enum":["low","normal","high"],"title":"Priority","default":"normal"},"watchlist_ids":{"items":{"type":"string"},"type":"array","title":"Watchlist Ids"},"linked_sources":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Linked Sources"},"reminder_lead_minutes":{"items":{"type":"integer"},"type":"array","title":"Reminder Lead Minutes"},"last_matched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Matched At"},"last_digest_sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Digest Sent At"},"fresh_count":{"type":"integer","title":"Fresh Count","default":0},"week_count":{"type":"integer","title":"Week Count","default":0},"snoozed_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Snoozed Until"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","jurisdiction","keywords","enabled","created_at","updated_at"],"title":"AlertItem","description":"Alert payload optimized for frontend settings and list rendering."},"AlertNotificationItem":{"properties":{"id":{"type":"string","title":"Id"},"state":{"type":"string","title":"State"},"matched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Matched At"},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Read At"},"item_id":{"type":"string","title":"Item Id"},"item_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Reference"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"item_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Type"},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Status"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","state","item_id","title"],"title":"AlertNotificationItem","description":"One matched alert notification with joined legislative item data."},"AlertNotificationsResponse":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/AlertNotificationItem"},"type":"array","title":"Notifications"}},"type":"object","required":["notifications"],"title":"AlertNotificationsResponse","description":"Response wrapper for matched notifications tied to one alert."},"AlertPreferencesResponse":{"properties":{"timezone":{"type":"string","title":"Timezone"},"digest_hour":{"type":"integer","title":"Digest Hour"},"digest_minute":{"type":"integer","title":"Digest Minute"},"weekdays":{"items":{"type":"integer"},"type":"array","title":"Weekdays"},"max_digests_per_day":{"type":"integer","title":"Max Digests Per Day"},"last_sent_local_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Sent Local Date"}},"type":"object","required":["timezone","digest_hour","digest_minute","weekdays","max_digests_per_day"],"title":"AlertPreferencesResponse","description":"Digest delivery preference payload for the authenticated user."},"AlertPreferencesUpdateRequest":{"properties":{"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"digest_hour":{"anyOf":[{"type":"integer","maximum":23.0,"minimum":0.0},{"type":"null"}],"title":"Digest Hour"},"digest_minute":{"anyOf":[{"type":"integer","maximum":59.0,"minimum":0.0},{"type":"null"}],"title":"Digest Minute"},"weekdays":{"anyOf":[{"items":{"type":"integer"},"type":"array","minItems":1},{"type":"null"}],"title":"Weekdays"},"max_digests_per_day":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":1.0},{"type":"null"}],"title":"Max Digests Per Day"}},"type":"object","title":"AlertPreferencesUpdateRequest","description":"Patch payload for updating digest delivery preferences."},"AlertResponse":{"properties":{"alert":{"$ref":"#/components/schemas/AlertItem"}},"type":"object","required":["alert"],"title":"AlertResponse","description":"Response wrapper for a single alert record."},"AlertSnoozeRequest":{"properties":{"until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},"type":"object","title":"AlertSnoozeRequest","description":"Set or clear the snooze window for an alert."},"AlertStreamEvent":{"properties":{"id":{"type":"string","title":"Id"},"alert_id":{"type":"string","title":"Alert Id"},"alert_name":{"type":"string","title":"Alert Name"},"category":{"type":"string","title":"Category","default":"keyword"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"title":{"type":"string","title":"Title"},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"matched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Matched At"},"when":{"type":"string","title":"When"},"fresh":{"type":"boolean","title":"Fresh"},"bucket":{"type":"string","title":"Bucket"}},"type":"object","required":["id","alert_id","alert_name","jurisdiction","title","when","fresh","bucket"],"title":"AlertStreamEvent","description":"One event in the cross-alert triggered feed on the alerts index."},"AlertStreamResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/AlertStreamEvent"},"type":"array","title":"Events"}},"type":"object","required":["events"],"title":"AlertStreamResponse","description":"Response wrapper for the triggered feed."},"AlertUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":10,"minLength":2},{"type":"null"}],"title":"Jurisdiction"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"item_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Item Types"},"alert_type":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Alert Type"},"category":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Category"},"target_actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Actor Id"},"target_bill_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Bill Id"},"target_committee_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Committee Id"},"target_topic_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Target Topic Label"},"rule_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Rule Json"},"jurisdiction_scope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Jurisdiction Scope"},"delivery_mode":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Delivery Mode"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high"]},{"type":"null"}],"title":"Priority"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"watchlist_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Watchlist Ids"},"reminder_lead_minutes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Reminder Lead Minutes"}},"type":"object","title":"AlertUpdateRequest","description":"Patch payload for an existing alert."},"AlertVocabulariesResponse":{"properties":{"milestones":{"items":{"$ref":"#/components/schemas/VocabularyOption"},"type":"array","title":"Milestones"},"relationships":{"items":{"$ref":"#/components/schemas/VocabularyOption"},"type":"array","title":"Relationships"},"vote_choices":{"items":{"$ref":"#/components/schemas/VocabularyOption"},"type":"array","title":"Vote Choices"},"event_families":{"items":{"$ref":"#/components/schemas/VocabularyOption"},"type":"array","title":"Event Families"},"secondary_act_events":{"items":{"$ref":"#/components/schemas/VocabularyOption"},"type":"array","title":"Secondary Act Events"},"secondary_act_default_events":{"items":{"type":"string"},"type":"array","title":"Secondary Act Default Events"},"secondary_act_default_deadline_lead_days":{"items":{"type":"integer"},"type":"array","title":"Secondary Act Default Deadline Lead Days"},"classes":{"items":{"$ref":"#/components/schemas/MilestoneClassOption"},"type":"array","title":"Classes"},"native_milestones":{"additionalProperties":{"items":{"$ref":"#/components/schemas/NativeMilestoneOption"},"type":"array"},"type":"object","title":"Native Milestones"},"native_languages":{"additionalProperties":{"type":"string"},"type":"object","title":"Native Languages"}},"type":"object","required":["milestones","relationships","vote_choices","event_families"],"title":"AlertVocabulariesResponse","description":"All alert filter vocabularies the wizard + ConfigurationPane consume.\n\nSourced from ``app/services/alerts/vocabularies.py``. The frontend\nfetches this once per session and caches via React Query so adding a\nnew milestone or relationship is a backend-only change — no frontend\nconstants to keep in sync."},"AlertsResponse":{"properties":{"alerts":{"items":{"$ref":"#/components/schemas/AlertItem"},"type":"array","title":"Alerts"}},"type":"object","required":["alerts"],"title":"AlertsResponse","description":"Response model listing all alerts owned by the authenticated user."},"AnnouncementCta":{"properties":{"label":{"type":"string","title":"Label"},"href":{"type":"string","title":"Href"}},"type":"object","required":["label","href"],"title":"AnnouncementCta"},"AnnouncementInput":{"properties":{"kind":{"type":"string","enum":["general","jurisdiction_launch"],"title":"Kind","default":"general"},"jurisdiction_code":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Jurisdiction Code"},"title":{"$ref":"#/components/schemas/LocalizedText"},"body":{"$ref":"#/components/schemas/LocalizedText"},"cta_label":{"anyOf":[{"$ref":"#/components/schemas/LocalizedText"},{"type":"null"}]},"cta_href":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cta Href"},"audience":{"type":"string","enum":["all","org_admins"],"title":"Audience","default":"all"},"tiers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tiers"},"existing_users_only":{"type":"boolean","title":"Existing Users Only","default":true},"starts_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"priority":{"type":"integer","maximum":100.0,"minimum":-100.0,"title":"Priority","default":0}},"additionalProperties":false,"type":"object","required":["title","body"],"title":"AnnouncementInput","description":"What a platform admin writes. Validated the same way for save and preview."},"AnnouncementOrgContext":{"properties":{"state":{"type":"string","enum":["entitled","can_add","slots_full","not_admin"],"title":"State"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"workspace_kind":{"type":"string","enum":["personal","team"],"title":"Workspace Kind"}},"type":"object","required":["state","jurisdiction_code","workspace_kind"],"title":"AnnouncementOrgContext","description":"Where the workspace stands with a launched jurisdiction (launch cards only)."},"AnnouncementPreviewRequest":{"properties":{"announcement":{"$ref":"#/components/schemas/AnnouncementInput"},"locale":{"type":"string","enum":["en","pl","nl"],"title":"Locale","default":"en"},"org_context":{"type":"string","enum":["entitled","can_add","slots_full","not_admin"],"title":"Org Context","default":"entitled"},"workspace_kind":{"type":"string","enum":["personal","team"],"title":"Workspace Kind","default":"team"}},"type":"object","required":["announcement"],"title":"AnnouncementPreviewRequest"},"AuditEntry":{"properties":{"id":{"type":"string","title":"Id"},"actor_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor User Id"},"actor_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Email"},"actor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Name"},"action":{"type":"string","title":"Action"},"target_type":{"type":"string","title":"Target Type"},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"},"target_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Label"},"before":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Before"},"after":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"After"},"network":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Network"},"browser":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Browser"},"os":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Os"},"occurred_at":{"type":"string","title":"Occurred At"}},"type":"object","required":["id","action","target_type","occurred_at"],"title":"AuditEntry","description":"One row from org_audit_log. Powers both Activity + Audit Log tabs.\n\nNever the raw IP address or user agent: the Audit Log (owners and admins)\nshows the approximate network (IPv4 /24, IPv6 /48) and the browser and\noperating system read from the user agent; the Activity feed shows none\nof them (``services/audit.admin_view`` / ``member_view``)."},"AuditExportRequest":{"properties":{"event_type":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Event Type"},"rows":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Rows"}},"additionalProperties":false,"type":"object","required":["rows"],"title":"AuditExportRequest","description":"An owner or admin downloaded the audit log (recorded before the download)."},"AuditListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AuditEntry"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"AuditListResponse"},"AuthResponse":{"properties":{"user":{"$ref":"#/components/schemas/UserResponse"},"organization":{"anyOf":[{"$ref":"#/components/schemas/OrganizationResponse"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["user","organization","message"],"title":"AuthResponse","description":"Authentication response including user and optional org context."},"AutoDraftRunRequest":{"properties":{"candidate_keys":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Candidate Keys"},"draft_through_gaps":{"type":"boolean","title":"Draft Through Gaps","default":false}},"type":"object","title":"AutoDraftRunRequest","description":"Optional proposal topic keys a person picked from the last program run."},"AvatarColorUpdateRequest":{"properties":{"avatar_color":{"anyOf":[{"type":"string","maxLength":9},{"type":"null"}],"title":"Avatar Color"}},"type":"object","title":"AvatarColorUpdateRequest","description":"Patch payload for the avatar color preference.\n\nPass ``None`` (or omit) to clear the override and fall back to the\ndeterministic palette mapping the frontend uses by default."},"BackfillTermConfig":{"properties":{"type":{"type":"string","const":"term","title":"Type","default":"term"},"include_terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Terms","description":"Explicit list of term IDs to include. If omitted, all past terms are walked."},"exclude_terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Terms","description":"Term IDs to skip during backfill."},"floor_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Floor Year","description":"Do not backfill terms ending before this year."}},"type":"object","title":"BackfillTermConfig","description":"Configuration for term-based backfill jurisdictions (US, PL)."},"BackfillTermWindowedConfig":{"properties":{"type":{"type":"string","const":"term_windowed","title":"Type","default":"term_windowed"},"include_terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Terms","description":"Explicit list of term IDs to include. If omitted, all past terms are walked."},"exclude_terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Terms","description":"Term IDs to skip during backfill."},"floor_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Floor Year","description":"Do not backfill terms ending before this year."},"batch_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Batch Days","description":"Override batch_days from the backfill_config row."}},"type":"object","title":"BackfillTermWindowedConfig","description":"Configuration for term-windowed backfill jurisdictions (US, PL).\n\nCombines term iteration with date-windowed batching within each term."},"BackfillWindowConfig":{"properties":{"type":{"type":"string","const":"window","title":"Type","default":"window"},"max_age_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Max Age Days","description":"Override max_age_days from the backfill_config row."},"batch_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Batch Days","description":"Override batch_days from the backfill_config row."}},"type":"object","title":"BackfillWindowConfig","description":"Configuration for window-based backfill jurisdictions (UK, NL, EU)."},"BriefBulkAlertsRequest":{"properties":{"change_keys":{"items":{"type":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Change Keys"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"type":"string","title":"Priority","default":"normal"}},"type":"object","required":["change_keys"],"title":"BriefBulkAlertsRequest","description":"Bulk create-alert over selected change rows."},"BriefBulkWatchlistRequest":{"properties":{"change_keys":{"items":{"type":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Change Keys"},"watchlist_id":{"type":"string","title":"Watchlist Id"}},"type":"object","required":["change_keys","watchlist_id"],"title":"BriefBulkWatchlistRequest","description":"Bulk save-to-watchlist over selected change rows."},"BriefChangeKeysRequest":{"properties":{"change_keys":{"items":{"type":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Change Keys"},"read":{"type":"boolean","title":"Read","default":true}},"type":"object","required":["change_keys"],"title":"BriefChangeKeysRequest","description":"Bulk read/unread over selected change rows."},"BriefNarrativeBlock":{"properties":{"narrative":{"type":"string","title":"Narrative"},"narrative_parts":{"additionalProperties":true,"type":"object","title":"Narrative Parts"},"source":{"type":"string","title":"Source"},"is_pending":{"type":"boolean","title":"Is Pending","default":false},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"act_today_count":{"type":"integer","title":"Act Today Count","default":0},"must_act":{"items":{"$ref":"#/components/schemas/MustActRow"},"type":"array","title":"Must Act"}},"type":"object","required":["narrative","source"],"title":"BriefNarrativeBlock","description":"The hero card's overnight narrative (#496)."},"BriefWindowOut":{"properties":{"kind":{"type":"string","title":"Kind"},"from":{"type":"string","title":"From"},"to":{"type":"string","title":"To"},"timezone":{"type":"string","title":"Timezone"}},"type":"object","required":["kind","from","to","timezone"],"title":"BriefWindowOut","description":"The resolved day window, echoed so the UI never re-derives boundaries."},"BudgetPolicyUpdate":{"properties":{"expected_version":{"type":"integer","exclusiveMinimum":0.0,"title":"Expected Version"},"monthly_cap_cents":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Monthly Cap Cents"},"editorial_cap_cents":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Editorial Cap Cents"},"reason":{"type":"string","maxLength":2000,"minLength":1,"title":"Reason"}},"additionalProperties":false,"type":"object","required":["expected_version","monthly_cap_cents","editorial_cap_cents","reason"],"title":"BudgetPolicyUpdate"},"CalendarEventCommitteeSummary":{"properties":{"committee_id":{"type":"string","title":"Committee Id"},"name":{"type":"string","title":"Name"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"}},"type":"object","required":["committee_id","name"],"title":"CalendarEventCommitteeSummary","description":"Committee linked to a shared calendar event."},"CalendarEventRelatedItemSummary":{"properties":{"item_id":{"type":"string","title":"Item Id"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"item_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Type"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["item_id","title"],"title":"CalendarEventRelatedItemSummary","description":"Legislative item linked to a shared calendar event."},"CalendarEventsResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/CommitteeEventSummary"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"available_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Available From"},"available_to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Available To"}},"type":"object","required":["events","total","page","per_page"],"title":"CalendarEventsResponse","description":"Response model for cross-jurisdiction calendar endpoint."},"CardClickEvent":{"properties":{"card_kind":{"type":"string","enum":["continue","related","compare","search","topic","trending","popular","starter"],"title":"Card Kind"},"position":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":0.0},{"type":"null"}],"title":"Position"},"item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Item Id"},"topic":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Topic"},"query":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Query"},"event_type":{"type":"string","const":"card_click","title":"Event Type"},"surface":{"type":"string","enum":["search_page","explore","command_palette","discovery","detail"],"title":"Surface","default":"discovery"}},"type":"object","required":["card_kind","event_type"],"title":"CardClickEvent"},"CardRef":{"properties":{"card_kind":{"type":"string","enum":["continue","related","compare","search","topic","trending","popular","starter"],"title":"Card Kind"},"position":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":0.0},{"type":"null"}],"title":"Position"},"item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Item Id"},"topic":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Topic"},"query":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Query"}},"type":"object","required":["card_kind"],"title":"CardRef","description":"One Explore suggestion card: its kind plus the record, topic or search it\npoints at (continue/popular/related: the record; topic/trending/starter:\nthe topic; search/compare: the search text). Explore shows each record of a\nrelated card as its own card."},"ChangePasswordRequest":{"properties":{"current_password":{"type":"string","title":"Current Password"},"new_password":{"type":"string","minLength":8,"title":"New Password"},"code":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Code"},"method":{"type":"string","enum":["totp","recovery_code","passkey"],"title":"Method","default":"totp"},"challenge":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Challenge"},"credential":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Credential"}},"type":"object","required":["current_password","new_password"],"title":"ChangePasswordRequest","description":"Payload for authenticated password change flow.\n\n``code`` (and ``method``) are required when the account has a second\nfactor: the change checks its own factors instead of sudo mode. With\n``method: \"passkey\"`` send ``challenge`` and ``credential`` instead."},"CheckoutSessionRequest":{"properties":{"plan":{"anyOf":[{"type":"string","enum":["explorer","team","pro","business"]},{"type":"null"}],"title":"Plan"},"currency":{"anyOf":[{"type":"string","enum":["eur","usd"]},{"type":"null"}],"title":"Currency"}},"type":"object","title":"CheckoutSessionRequest","description":"Optional plan choice for Checkout (#967).\n\nOmitted, Checkout uses the plan chosen at signup. Required for a Research\nAccess workspace converting to a paid plan."},"ClosestVote":{"properties":{"vote_event_id":{"type":"string","title":"Vote Event Id"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"},"yes":{"type":"integer","title":"Yes"},"no":{"type":"integer","title":"No"},"margin":{"type":"integer","title":"Margin"},"margin_pct":{"type":"number","title":"Margin Pct"},"jurisdiction":{"type":"string","title":"Jurisdiction"}},"type":"object","required":["vote_event_id","yes","no","margin","margin_pct","jurisdiction"],"title":"ClosestVote","description":"Yesterday's narrowest margin (>= 20 total votes noise floor)."},"CollectionResponseV1_EventEnvelopeV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EventEnvelopeV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[EventEnvelopeV1]"},"CollectionResponseV1_LegislativeCommitteeV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LegislativeCommitteeV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[LegislativeCommitteeV1]"},"CollectionResponseV1_LegislativeItemV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LegislativeItemV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[LegislativeItemV1]"},"CollectionResponseV1_LegislativePartyV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LegislativePartyV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[LegislativePartyV1]"},"CollectionResponseV1_LegislativePersonV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LegislativePersonV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[LegislativePersonV1]"},"CollectionResponseV1_LegislativeVoteRecordV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LegislativeVoteRecordV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[LegislativeVoteRecordV1]"},"CollectionResponseV1_LegislativeVoteV1_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LegislativeVoteV1"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"as_of":{"type":"string","format":"date-time","title":"As Of"}},"additionalProperties":false,"type":"object","required":["items","has_more","as_of"],"title":"CollectionResponseV1[LegislativeVoteV1]"},"CommitteeActivityEntry":{"properties":{"event_id":{"type":"string","title":"Event Id"},"bill_id":{"type":"string","title":"Bill Id"},"bill_title":{"type":"string","title":"Bill Title"},"bill_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Identifier"},"bill_print_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Print Number"},"bill_project_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Project Number"},"bill_title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Title Native"},"bill_native_language":{"type":"string","title":"Bill Native Language","default":"en"},"bill_title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Title En"},"bill_title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Title En Source"},"action_date":{"type":"string","format":"date","title":"Action Date"},"action_text":{"type":"string","title":"Action Text"},"action_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Code"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"}},"type":"object","required":["event_id","bill_id","bill_title","action_date","action_text"],"title":"CommitteeActivityEntry","description":"Single committee activity event entry."},"CommitteeActivityResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/CommitteeActivityEntry"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"}},"type":"object","required":["events","total","page","per_page"],"title":"CommitteeActivityResponse","description":"Response model for committee activity endpoint."},"CommitteeBillsResponse":{"properties":{"bills":{"items":{"$ref":"#/components/schemas/LegislativeItemListEntry"},"type":"array","title":"Bills"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"}},"type":"object","required":["bills","total","page","per_page"],"title":"CommitteeBillsResponse","description":"Response model for committee bills endpoint."},"CommitteeEventAgendaItemSummary":{"properties":{"agenda_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agenda Item Id"},"source_agenda_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Agenda Item Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"starts_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"sort_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sort Order"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["title"],"title":"CommitteeEventAgendaItemSummary","description":"Agenda line item attached to a calendar event."},"CommitteeEventDocumentSummary":{"properties":{"document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Id"},"source_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Document Id"},"title":{"type":"string","title":"Title"},"document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"sort_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sort Order"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["title"],"title":"CommitteeEventDocumentSummary","description":"Document, transcript, package, or download attached to a calendar event."},"CommitteeEventParticipantSummary":{"properties":{"participant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Participant Id"},"source_participant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Participant Id"},"name":{"type":"string","title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"organization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization"},"position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position"},"participation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Participation Status"},"sort_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sort Order"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["name"],"title":"CommitteeEventParticipantSummary","description":"Normalized participant, witness, or attendee attached to a calendar event."},"CommitteeEventSummary":{"properties":{"event_id":{"type":"string","title":"Event Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"title":{"type":"string","title":"Title"},"event_family":{"type":"string","title":"Event Family"},"source_event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Event Type"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"all_day":{"type":"boolean","title":"All Day","default":false},"starts_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Starts On"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"agenda_html":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agenda Html"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"source_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Source Updated At"},"access_level":{"type":"string","title":"Access Level","default":"public"},"is_closed":{"type":"boolean","title":"Is Closed","default":false},"is_remote":{"type":"boolean","title":"Is Remote","default":false},"related_items_total":{"type":"integer","title":"Related Items Total","default":0},"participant_count":{"type":"integer","title":"Participant Count","default":0},"document_count":{"type":"integer","title":"Document Count","default":0},"agenda_item_count":{"type":"integer","title":"Agenda Item Count","default":0},"committees":{"items":{"$ref":"#/components/schemas/CalendarEventCommitteeSummary"},"type":"array","title":"Committees"},"related_items":{"items":{"$ref":"#/components/schemas/CalendarEventRelatedItemSummary"},"type":"array","title":"Related Items"},"participants":{"items":{"$ref":"#/components/schemas/CommitteeEventParticipantSummary"},"type":"array","title":"Participants"},"documents":{"items":{"$ref":"#/components/schemas/CommitteeEventDocumentSummary"},"type":"array","title":"Documents"},"agenda_items":{"items":{"$ref":"#/components/schemas/CommitteeEventAgendaItemSummary"},"type":"array","title":"Agenda Items"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["event_id","jurisdiction","title","event_family","starts_at"],"title":"CommitteeEventSummary","description":"Schedule/history event entry for a committee."},"CommitteeEventsResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/CommitteeEventSummary"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"}},"type":"object","required":["events","total","page","per_page"],"title":"CommitteeEventsResponse","description":"Response model for committee schedule/history endpoint."},"CommitteeMembershipEntry":{"properties":{"legislator_id":{"type":"string","title":"Legislator Id"},"legislator_name":{"type":"string","title":"Legislator Name"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"membership_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Membership Role"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"term_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Term Number"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["legislator_id","legislator_name"],"title":"CommitteeMembershipEntry","description":"Legislator membership history entry for a committee."},"CommitteeNextEventSummary":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"event_family":{"type":"string","title":"Event Family"},"source_event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Event Type"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"}},"type":"object","required":["id","title","event_family","starts_at"],"title":"CommitteeNextEventSummary","description":"Compact upcoming event block embedded on committee list/detail payloads."},"ComparabilityTiers":{"properties":{"actors":{"type":"string","enum":["full","conditional","none"],"title":"Actors","default":"none"},"committees":{"type":"string","enum":["full","conditional","none"],"title":"Committees","default":"none"},"parties":{"type":"string","enum":["full","conditional","none"],"title":"Parties","default":"none"},"votes_person":{"type":"string","enum":["full","conditional","none"],"title":"Votes Person","default":"none"},"votes_group":{"type":"string","enum":["full","conditional","none"],"title":"Votes Group","default":"none"}},"type":"object","title":"ComparabilityTiers","description":"Cross-jurisdiction comparability tiers per semantic dimension."},"ComparabilityValidationIssue":{"properties":{"jurisdiction":{"type":"string","title":"Jurisdiction"},"dimension":{"type":"string","enum":["actors","committees","parties","votes_person","votes_group"],"title":"Dimension"},"tier":{"type":"string","enum":["full","conditional","none"],"title":"Tier"}},"type":"object","required":["jurisdiction","dimension","tier"],"title":"ComparabilityValidationIssue","description":"One blocking issue returned by comparability validation."},"ComparabilityValidationRequest":{"properties":{"jurisdictions":{"items":{"type":"string"},"type":"array","minItems":2,"title":"Jurisdictions"},"dimensions":{"items":{"type":"string","enum":["actors","committees","parties","votes_person","votes_group"]},"type":"array","minItems":1,"title":"Dimensions"}},"type":"object","required":["jurisdictions","dimensions"],"title":"ComparabilityValidationRequest","description":"Request payload for cross-jurisdiction comparability checks."},"ComparabilityValidationResponse":{"properties":{"comparable":{"type":"boolean","title":"Comparable"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"dimensions":{"items":{"type":"string","enum":["actors","committees","parties","votes_person","votes_group"]},"type":"array","title":"Dimensions"},"blocked":{"items":{"$ref":"#/components/schemas/ComparabilityValidationIssue"},"type":"array","title":"Blocked"},"tiers":{"additionalProperties":{"additionalProperties":{"type":"string","enum":["full","conditional","none"]},"type":"object"},"type":"object","title":"Tiers"}},"type":"object","required":["comparable","jurisdictions","dimensions"],"title":"ComparabilityValidationResponse","description":"Validation response for cross-jurisdiction comparison eligibility."},"Completion":{"properties":{"text":{"type":"string","title":"Text"},"kind":{"type":"string","enum":["history","word"],"title":"Kind"}},"type":"object","required":["text","kind"],"title":"Completion","description":"``text`` is the whole query with its last word (or all of it) completed."},"ConfirmRenewalRequest":{"properties":{"token":{"type":"string","maxLength":256,"minLength":16,"title":"Token"}},"type":"object","required":["token"],"title":"ConfirmRenewalRequest"},"CoverageDimensionBlock":{"properties":{"status":{"type":"string","enum":["available","missing","unavailable","not_ingested"],"title":"Status","default":"missing"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","title":"CoverageDimensionBlock","description":"Coverage block for one semantic dimension."},"CoverageDimensions":{"properties":{"actors":{"$ref":"#/components/schemas/CoverageDimensionBlock"},"committees":{"$ref":"#/components/schemas/CoverageDimensionBlock"},"votes_person":{"$ref":"#/components/schemas/CoverageDimensionBlock"},"votes_group":{"$ref":"#/components/schemas/CoverageDimensionBlock"}},"type":"object","title":"CoverageDimensions","description":"Coverage state across canonical actor and vote dimensions."},"CreateSilenceRequest":{"properties":{"duration_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Minutes"},"severities":{"type":"string","title":"Severities"},"reason":{"type":"string","title":"Reason"},"starts_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Starts At"},"ends_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ends At"}},"type":"object","required":["severities","reason"],"title":"CreateSilenceRequest"},"DailyBriefBootstrapResponse":{"properties":{"jurisdictions":{"$ref":"#/components/schemas/JurisdictionsResponse"},"overview":{"$ref":"#/components/schemas/DailyBriefOverviewResponse"},"volume":{"$ref":"#/components/schemas/DailyBriefVolumeResponse"},"changes":{"$ref":"#/components/schemas/DailyBriefChangesResponse"},"topics":{"anyOf":[{"$ref":"#/components/schemas/TopicStatsOut"},{"type":"null"}]},"reminders":{"$ref":"#/components/schemas/RemindersOut"},"watchlists":{"$ref":"#/components/schemas/WatchlistsResponse"}},"type":"object","required":["jurisdictions","overview","volume","changes","reminders","watchlists"],"title":"DailyBriefBootstrapResponse","description":"One bounded initial read model for the Daily Brief page.\n\nEach section retains the contract of its standalone endpoint. Mutations\nand later interaction-specific refreshes therefore remain independently\ncacheable; this envelope only removes cold-load browser fan-out.\n``include_topics=false`` leaves ``topics`` null so filter metadata can\nload on demand without blocking the visible deck."},"DailyBriefChange":{"properties":{"change_key":{"type":"string","title":"Change Key"},"entity_type":{"type":"string","title":"Entity Type"},"change_type":{"type":"string","enum":["new_bill","status_change","latest_action","vote","committee_event"],"title":"Change Type"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Id"},"vote_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vote Event Id"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"change_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Date"},"change_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change At"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"topics":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Topics"},"topic_primary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Primary"},"why_it_matters":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why It Matters"},"key_actors":{"items":{"type":"string"},"type":"array","title":"Key Actors"},"suggested_action":{"type":"string","title":"Suggested Action"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"detail":{"additionalProperties":true,"type":"object","title":"Detail"},"act_today":{"type":"boolean","title":"Act Today","default":false},"urgency":{"type":"integer","title":"Urgency","default":0},"due_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due At"},"due_label_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Label Key"},"act_today_reason_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Act Today Reason Key"},"on_watchlists":{"type":"boolean","title":"On Watchlists","default":false},"is_read":{"type":"boolean","title":"Is Read","default":false}},"type":"object","required":["change_key","entity_type","change_type","jurisdiction","suggested_action"],"title":"DailyBriefChange","description":"One change row in the queue."},"DailyBriefChangesResponse":{"properties":{"window":{"$ref":"#/components/schemas/BriefWindowOut"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"stats":{"$ref":"#/components/schemas/DailyBriefStats"},"days":{"items":{"$ref":"#/components/schemas/DailyBriefDayGroup"},"type":"array","title":"Days"},"pagination":{"$ref":"#/components/schemas/PaginationOut"},"earlier_count":{"type":"integer","title":"Earlier Count"}},"type":"object","required":["window","jurisdictions","stats","days","pagination","earlier_count"],"title":"DailyBriefChangesResponse","description":"GET /daily-brief/changes — the triage queue."},"DailyBriefDayGroup":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"label_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label Key"},"count":{"type":"integer","title":"Count"},"changes":{"items":{"$ref":"#/components/schemas/DailyBriefChange"},"type":"array","title":"Changes"}},"type":"object","required":["count","changes"],"title":"DailyBriefDayGroup","description":"The queue is rendered in day sections (\"Today · 12 changes\")."},"DailyBriefOverviewResponse":{"properties":{"date":{"type":"string","title":"Date"},"timezone":{"type":"string","title":"Timezone"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"sections":{"$ref":"#/components/schemas/DailyBriefSections"},"upcoming":{"items":{"$ref":"#/components/schemas/UpcomingEvent"},"type":"array","title":"Upcoming"},"votes":{"anyOf":[{"$ref":"#/components/schemas/VotesYesterday"},{"type":"null"}]},"watchlists":{"items":{"$ref":"#/components/schemas/WatchlistRollup"},"type":"array","title":"Watchlists"},"brief":{"anyOf":[{"$ref":"#/components/schemas/BriefNarrativeBlock"},{"type":"null"}]},"digest":{"anyOf":[{"$ref":"#/components/schemas/DigestBlock"},{"type":"null"}]},"radar":{"anyOf":[{"$ref":"#/components/schemas/RadarBriefBlock"},{"type":"null"}]}},"type":"object","required":["date","timezone","jurisdictions","sections"],"title":"DailyBriefOverviewResponse","description":"GET /daily-brief/overview — the deck's context blocks."},"DailyBriefSections":{"properties":{"act_today":{"type":"integer","title":"Act Today"},"moved_since_yesterday":{"type":"integer","title":"Moved Since Yesterday"},"next_7_days":{"type":"integer","title":"Next 7 Days"},"on_watchlists":{"type":"integer","title":"On Watchlists"},"everything":{"type":"integer","title":"Everything"}},"type":"object","required":["act_today","moved_since_yesterday","next_7_days","on_watchlists","everything"],"title":"DailyBriefSections","description":"Sections-rail counts; each equals the queue total under its filter."},"DailyBriefStats":{"properties":{"total":{"type":"integer","title":"Total"},"new_bill":{"type":"integer","title":"New Bill"},"status_change":{"type":"integer","title":"Status Change"},"latest_action":{"type":"integer","title":"Latest Action"},"vote":{"type":"integer","title":"Vote"},"committee_event":{"type":"integer","title":"Committee Event"},"act_today":{"type":"integer","title":"Act Today"},"unread":{"type":"integer","title":"Unread","default":0}},"type":"object","required":["total","new_bill","status_change","latest_action","vote","committee_event","act_today"],"title":"DailyBriefStats","description":"Window-wide counts (type tabs + act-today badge). Scope-aware."},"DailyBriefVolumeResponse":{"properties":{"range":{"type":"integer","title":"Range"},"timezone":{"type":"string","title":"Timezone"},"buckets":{"items":{"$ref":"#/components/schemas/VolumeBucket"},"type":"array","title":"Buckets"},"total":{"type":"integer","title":"Total"},"busiest_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Busiest Date"}},"type":"object","required":["range","timezone","buckets","total"],"title":"DailyBriefVolumeResponse","description":"GET /daily-brief/volume — per-day change counts for the bar chart."},"DefaultJurisdictionUpdateRequest":{"properties":{"code":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Code"}},"type":"object","title":"DefaultJurisdictionUpdateRequest","description":"Patch payload for the user's default jurisdiction.\n\nOrg-scoped: the chosen code must be entitled to the user's\norganization. Pass ``None`` to clear back to the org default."},"DeleteWorkspaceRequest":{"properties":{"confirmation_name":{"type":"string","maxLength":200,"minLength":1,"title":"Confirmation Name"}},"type":"object","required":["confirmation_name"],"title":"DeleteWorkspaceRequest"},"DigestBlock":{"properties":{"kind":{"type":"string","title":"Kind"},"profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"timezone":{"type":"string","title":"Timezone"},"next_run_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Run At"},"recipient_count":{"type":"integer","title":"Recipient Count"},"last_run":{"anyOf":[{"$ref":"#/components/schemas/DigestLastRun"},{"type":"null"}]},"edit_href":{"type":"string","title":"Edit Href"}},"type":"object","required":["kind","timezone","recipient_count","edit_href"],"title":"DigestBlock","description":"The Digest card block (#497). kind=profile (org digest profile) or\nkind=personal (the user's own daily digest — the provably-working\nfallback when no profile exists)."},"DigestLastRun":{"properties":{"run_id":{"type":"string","title":"Run Id"},"sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sent At"},"delivered":{"type":"integer","title":"Delivered"},"opened":{"type":"integer","title":"Opened"}},"type":"object","required":["run_id","delivered","opened"],"title":"DigestLastRun"},"DigestPreviewItem":{"properties":{"source_type":{"type":"string","title":"Source Type"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["source_type","title"],"title":"DigestPreviewItem","description":"One preview item assembled for a digest run."},"DigestPreviewResponse":{"properties":{"digest":{"$ref":"#/components/schemas/DigestProfileResponse"},"items":{"items":{"$ref":"#/components/schemas/DigestPreviewItem"},"type":"array","title":"Items"}},"type":"object","required":["digest","items"],"title":"DigestPreviewResponse","description":"Preview payload for one digest."},"DigestProfileCreateRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"timezone":{"type":"string","maxLength":64,"title":"Timezone","default":"UTC"},"schedule_type":{"type":"string","maxLength":20,"title":"Schedule Type","default":"daily"},"schedule_hour":{"type":"integer","maximum":23.0,"minimum":0.0,"title":"Schedule Hour","default":8},"schedule_minute":{"type":"integer","maximum":59.0,"minimum":0.0,"title":"Schedule Minute","default":0},"schedule_day":{"anyOf":[{"type":"integer","maximum":31.0,"minimum":1.0},{"type":"null"}],"title":"Schedule Day"},"weekdays":{"items":{"type":"integer"},"type":"array","title":"Weekdays"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"severity_filter":{"items":{"type":"string"},"type":"array","title":"Severity Filter"},"content_options":{"additionalProperties":true,"type":"object","title":"Content Options"},"enabled":{"type":"boolean","title":"Enabled","default":true},"watchlist_ids":{"items":{"type":"string"},"type":"array","title":"Watchlist Ids"},"alert_ids":{"items":{"type":"string"},"type":"array","title":"Alert Ids"},"recipients":{"items":{"$ref":"#/components/schemas/DigestRecipientCreateRequest"},"type":"array","title":"Recipients"},"sections":{"anyOf":[{"items":{"$ref":"#/components/schemas/ReportBlockSpec"},"type":"array"},{"type":"null"}],"title":"Sections"},"export_formats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Export Formats"}},"type":"object","required":["name"],"title":"DigestProfileCreateRequest","description":"Create a digest profile."},"DigestProfileResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"timezone":{"type":"string","title":"Timezone"},"schedule_type":{"type":"string","title":"Schedule Type"},"schedule_hour":{"type":"integer","title":"Schedule Hour"},"schedule_minute":{"type":"integer","title":"Schedule Minute"},"schedule_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Schedule Day"},"weekdays":{"items":{"type":"integer"},"type":"array","title":"Weekdays"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"severity_filter":{"items":{"type":"string"},"type":"array","title":"Severity Filter"},"content_options":{"additionalProperties":true,"type":"object","title":"Content Options"},"enabled":{"type":"boolean","title":"Enabled"},"watchlist_ids":{"items":{"type":"string"},"type":"array","title":"Watchlist Ids"},"alert_ids":{"items":{"type":"string"},"type":"array","title":"Alert Ids"},"recipients":{"items":{"$ref":"#/components/schemas/DigestRecipientResponse"},"type":"array","title":"Recipients"},"sections":{"items":{"$ref":"#/components/schemas/ReportBlockSpec"},"type":"array","title":"Sections"},"export_formats":{"items":{"type":"string"},"type":"array","title":"Export Formats"},"auto_seeded":{"type":"boolean","title":"Auto Seeded","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","timezone","schedule_type","schedule_hour","schedule_minute","weekdays","channels","severity_filter","enabled","created_at","updated_at"],"title":"DigestProfileResponse","description":"Digest profile summary/detail response."},"DigestProfileUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"},"timezone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Timezone"},"schedule_type":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Schedule Type"},"schedule_hour":{"anyOf":[{"type":"integer","maximum":23.0,"minimum":0.0},{"type":"null"}],"title":"Schedule Hour"},"schedule_minute":{"anyOf":[{"type":"integer","maximum":59.0,"minimum":0.0},{"type":"null"}],"title":"Schedule Minute"},"schedule_day":{"anyOf":[{"type":"integer","maximum":31.0,"minimum":1.0},{"type":"null"}],"title":"Schedule Day"},"weekdays":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Weekdays"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"severity_filter":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Severity Filter"},"content_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Content Options"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"watchlist_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Watchlist Ids"},"alert_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Alert Ids"},"recipients":{"anyOf":[{"items":{"$ref":"#/components/schemas/DigestRecipientCreateRequest"},"type":"array"},{"type":"null"}],"title":"Recipients"},"sections":{"anyOf":[{"items":{"$ref":"#/components/schemas/ReportBlockSpec"},"type":"array"},{"type":"null"}],"title":"Sections"},"export_formats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Export Formats"}},"type":"object","title":"DigestProfileUpdateRequest","description":"Patch a digest profile."},"DigestProfilesResponse":{"properties":{"digests":{"items":{"$ref":"#/components/schemas/DigestProfileResponse"},"type":"array","title":"Digests"}},"type":"object","required":["digests"],"title":"DigestProfilesResponse","description":"List wrapper for digest profiles."},"DigestRecipientCreateRequest":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","title":"DigestRecipientCreateRequest","description":"Add one digest recipient."},"DigestRecipientResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","created_at"],"title":"DigestRecipientResponse","description":"One digest recipient."},"DigestSendTestDelivery":{"properties":{"email":{"type":"string","title":"Email"},"status":{"type":"string","title":"Status"},"message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Id"}},"type":"object","required":["email","status"],"title":"DigestSendTestDelivery","description":"One recipient's send result."},"DigestSendTestResponse":{"properties":{"digest_run_id":{"type":"string","title":"Digest Run Id"},"deliveries":{"items":{"$ref":"#/components/schemas/DigestSendTestDelivery"},"type":"array","title":"Deliveries"}},"type":"object","required":["digest_run_id","deliveries"],"title":"DigestSendTestResponse","description":"Response after running a test digest send."},"DismissEvent":{"properties":{"card_kind":{"type":"string","enum":["continue","related","compare","search","topic","trending","popular","starter"],"title":"Card Kind"},"position":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":0.0},{"type":"null"}],"title":"Position"},"item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Item Id"},"topic":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Topic"},"query":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Query"},"event_type":{"type":"string","const":"dismiss","title":"Event Type"}},"type":"object","required":["card_kind","event_type"],"title":"DismissEvent"},"DraftContext":{"properties":{"title":{"type":"string","maxLength":240,"minLength":1,"title":"Title"},"selected_text":{"type":"string","maxLength":6000,"title":"Selected Text","default":""},"headings":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Headings"},"instruction":{"type":"string","maxLength":1000,"title":"Instruction","default":""}},"additionalProperties":false,"type":"object","required":["title"],"title":"DraftContext"},"DwellEvent":{"properties":{"event_type":{"type":"string","const":"dwell","title":"Event Type"},"item_id":{"type":"string","format":"uuid","title":"Item Id"},"seconds":{"type":"integer","maximum":3600.0,"minimum":1.0,"title":"Seconds"}},"type":"object","required":["event_type","item_id","seconds"],"title":"DwellEvent"},"EditorialOverlapRequest":{"properties":{"reader_task":{"type":"string","maxLength":8000,"minLength":3,"title":"Reader Task"},"topic":{"type":"string","maxLength":8000,"title":"Topic","default":""},"original_contribution":{"type":"string","maxLength":8000,"minLength":10,"title":"Original Contribution"}},"type":"object","required":["reader_task","original_contribution"],"title":"EditorialOverlapRequest"},"EditorialProgramPatch":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"template_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Template Ids"},"jurisdiction_mode":{"anyOf":[{"type":"string","enum":["all_supported","explicit"]},{"type":"null"}],"title":"Jurisdiction Mode"},"jurisdiction_codes":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Jurisdiction Codes"},"max_candidates":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":1.0},{"type":"null"}],"title":"Max Candidates"},"max_research":{"anyOf":[{"type":"integer","maximum":20.0,"minimum":1.0},{"type":"null"}],"title":"Max Research"},"max_drafts":{"anyOf":[{"type":"integer","maximum":20.0,"minimum":1.0},{"type":"null"}],"title":"Max Drafts"},"max_per_template":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":1.0},{"type":"null"}],"title":"Max Per Template"},"max_per_jurisdiction":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":1.0},{"type":"null"}],"title":"Max Per Jurisdiction"},"max_full_research_runs":{"anyOf":[{"type":"integer","maximum":20.0,"minimum":1.0},{"type":"null"}],"title":"Max Full Research Runs"}},"type":"object","title":"EditorialProgramPatch"},"EmailChangeRequest":{"properties":{"new_email":{"type":"string","format":"email","title":"New Email"},"turnstile_token":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Turnstile Token"}},"additionalProperties":false,"type":"object","required":["new_email"],"title":"EmailChangeRequest"},"EmailChangeTokenRequest":{"properties":{"token":{"type":"string","maxLength":64,"title":"Token"}},"additionalProperties":false,"type":"object","required":["token"],"title":"EmailChangeTokenRequest"},"EntityLookupPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EntityOption"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"EntityLookupPage"},"EntityMatch":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","enum":["person","committee"],"title":"Type"},"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"}},"type":"object","required":["label","type","id","jurisdiction"],"title":"EntityMatch"},"EntityOption":{"properties":{"id":{"type":"string","title":"Id"},"primary":{"type":"string","title":"Primary"},"secondary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secondary"}},"type":"object","required":["id","primary"],"title":"EntityOption"},"EuActDetailResponse":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"item":{"anyOf":[{"$ref":"#/components/schemas/EuActItem"},{"type":"null"}]},"amended_by":{"$ref":"#/components/schemas/EuAmendedBy"},"amends":{"items":{"$ref":"#/components/schemas/EuAmendsEntry"},"type":"array","title":"Amends"},"versions":{"items":{"$ref":"#/components/schemas/EuVersionEntry"},"type":"array","title":"Versions"},"versions_total":{"type":"integer","title":"Versions Total","default":0}},"type":"object","required":["celex","label"],"title":"EuActDetailResponse","description":"One EU act: what amends it, what it amends, its consolidated versions."},"EuActItem":{"properties":{"id":{"type":"string","title":"Id"},"procedure_code":{"type":"string","title":"Procedure Code"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"}},"type":"object","required":["id","procedure_code"],"title":"EuActItem","description":"The PoliData EU item of the procedure that produced an act."},"EuActRef":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"}},"type":"object","required":["celex","label"],"title":"EuActRef","description":"An EU legal work by CELEX with its short citation (``Regulation (EU) 2018/1724``)."},"EuActWithItem":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"item":{"anyOf":[{"$ref":"#/components/schemas/EuActItem"},{"type":"null"}]}},"type":"object","required":["celex","label"],"title":"EuActWithItem"},"EuAmendedBy":{"properties":{"total":{"type":"integer","title":"Total","default":0},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"},"entries":{"items":{"$ref":"#/components/schemas/EuAmendedByEntry"},"type":"array","title":"Entries"},"proposed":{"items":{"$ref":"#/components/schemas/EuPendingProposal"},"type":"array","title":"Proposed"}},"type":"object","title":"EuAmendedBy"},"EuAmendedByEntry":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"relation":{"type":"string","title":"Relation"},"link_source":{"type":"string","title":"Link Source"},"provisions":{"$ref":"#/components/schemas/EuProvisionView"},"item":{"anyOf":[{"$ref":"#/components/schemas/EuActItem"},{"type":"null"}]},"version":{"anyOf":[{"$ref":"#/components/schemas/EuVersionRef"},{"type":"null"}]}},"type":"object","required":["celex","label","relation","link_source","provisions"],"title":"EuAmendedByEntry"},"EuAmendedTarget":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"item":{"anyOf":[{"$ref":"#/components/schemas/EuActItem"},{"type":"null"}]},"proposed_by":{"items":{"$ref":"#/components/schemas/EuProposedBy"},"type":"array","title":"Proposed By"},"enacted":{"items":{"$ref":"#/components/schemas/EuEnactedLink"},"type":"array","title":"Enacted"},"outcome":{"type":"string","title":"Outcome"},"versions":{"$ref":"#/components/schemas/EuVersionsSummary"}},"type":"object","required":["celex","label","outcome"],"title":"EuAmendedTarget","description":"An act a procedure proposes to amend or whose final act amends/repeals."},"EuAmendsEntry":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"relation":{"type":"string","title":"Relation"},"link_source":{"type":"string","title":"Link Source"},"provisions":{"$ref":"#/components/schemas/EuProvisionView"},"item":{"anyOf":[{"$ref":"#/components/schemas/EuActItem"},{"type":"null"}]}},"type":"object","required":["celex","label","relation","link_source","provisions"],"title":"EuAmendsEntry"},"EuDossierEvent":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"source":{"type":"string","title":"Source"},"code":{"type":"string","title":"Code"},"label":{"type":"string","title":"Label"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"institution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Institution"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase"},"document_refs":{"items":{"type":"string"},"type":"array","title":"Document Refs"},"scheduled":{"type":"boolean","title":"Scheduled","default":false},"substantive":{"type":"boolean","title":"Substantive","default":true},"duplicate_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duplicate Of"},"cellar_twin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cellar Twin"},"cellar_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cellar Event Id"},"projected":{"type":"boolean","title":"Projected","default":false},"step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step"},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template"},"params":{"additionalProperties":{"type":"string"},"type":"object","title":"Params"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","required":["date","source","code","label"],"title":"EuDossierEvent","description":"One event of an EU procedure, from the EP API or Cellar (#1204)."},"EuDossierSummary":{"properties":{"procedure_key":{"type":"string","title":"Procedure Key"},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference"},"procedure_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedure Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"com_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Com Reference"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"adopted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Adopted"},"pending":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pending"},"withdrawn":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Withdrawn"},"adopted_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Adopted On"},"withdrawn_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Withdrawn On"},"event_count":{"type":"integer","title":"Event Count","default":0},"last_event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Event Date"},"last_substantive_event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Substantive Event Date"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"cellar_modified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cellar Modified At"},"checked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Checked At"}},"type":"object","required":["procedure_key"],"title":"EuDossierSummary","description":"Cellar's inter-institutional dossier of an EU procedure (#1204)."},"EuEnactedLink":{"properties":{"relation":{"type":"string","title":"Relation"},"act":{"type":"string","title":"Act"},"act_label":{"type":"string","title":"Act Label"},"link_source":{"type":"string","title":"Link Source"},"provisions":{"$ref":"#/components/schemas/EuProvisionView"},"version":{"anyOf":[{"$ref":"#/components/schemas/EuVersionRef"},{"type":"null"}]}},"type":"object","required":["relation","act","act_label","link_source","provisions"],"title":"EuEnactedLink"},"EuOwnAct":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"},"amended_by":{"$ref":"#/components/schemas/EuAmendedBy"},"versions":{"items":{"$ref":"#/components/schemas/EuVersionEntry"},"type":"array","title":"Versions"},"versions_total":{"type":"integer","title":"Versions Total","default":0}},"type":"object","required":["celex","label"],"title":"EuOwnAct"},"EuPendingProposal":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind","default":"other"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"in_force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Force"},"item":{"anyOf":[{"$ref":"#/components/schemas/EuActItem"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["celex","label"],"title":"EuPendingProposal","description":"A pending proposal of a tracked procedure that would amend the act."},"EuProcedureDormancy":{"properties":{"tier":{"type":"string","title":"Tier"},"tier_since":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Tier Since"},"last_activity_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Activity On"},"idle_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idle Days"},"announcement":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Announcement"},"withdrawn_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Withdrawn On"},"lapsed_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Lapsed On"},"lapse_term":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lapse Term"},"resumed_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Resumed On"},"lapse_risk":{"type":"boolean","title":"Lapse Risk","default":false},"term_last_session":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Term Last Session"},"term_last_session_estimated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Term Last Session Estimated"},"revival_signal_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Revival Signal On"},"revival_signals":{"items":{"$ref":"#/components/schemas/EuRevivalSignal"},"type":"array","title":"Revival Signals"},"computed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Computed At"}},"type":"object","required":["tier"],"title":"EuProcedureDormancy","description":"Dormancy, withdrawal and lapse tier of an EU file (#1206), rebuilt daily.\n\n``tier``: active | no_recent_progress (9 months without substantive\nactivity, a hint) | dormant (24 months) | withdrawal_announced (Commission\nWork Programme Annex IV) | lapsed (Rule 250, not resumed) | withdrawn |\nrejected | adopted."},"EuProcedureForecast":{"properties":{"method":{"type":"string","title":"Method","default":"kaplan_meier"},"step_key":{"type":"string","title":"Step Key"},"basis":{"type":"string","title":"Basis"},"n_done":{"type":"integer","title":"N Done"},"n_censored":{"type":"integer","title":"N Censored"},"entered_on":{"type":"string","format":"date","title":"Entered On"},"elapsed_days":{"type":"integer","title":"Elapsed Days"},"p10_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P10 Days"},"p50_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P50 Days"},"p90_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P90 Days"},"p10_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"P10 Date"},"p50_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"P50 Date"},"p90_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"P90 Date"},"beyond_history":{"type":"boolean","title":"Beyond History","default":false},"computed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Computed At"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution"}},"type":"object","required":["step_key","basis","n_done","n_censored","entered_on","elapsed_days"],"title":"EuProcedureForecast","description":"Kaplan-Meier interval for leaving the current step (#1205), an estimate.\n\nQuantiles are conditional on the days already spent at the step; dates are\nnever before today. ``p90_date`` None (``beyond_history``) means the file\nhas waited longer than the history can bound."},"EuProcedureLastChange":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"source":{"type":"string","title":"Source"},"code":{"type":"string","title":"Code"},"label":{"type":"string","title":"Label"},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template"},"params":{"additionalProperties":{"type":"string"},"type":"object","title":"Params"},"text":{"type":"string","title":"Text"}},"type":"object","required":["date","source","code","label","text"],"title":"EuProcedureLastChange"},"EuProcedureNextStep":{"properties":{"step":{"type":"string","title":"Step"},"share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Share"}},"type":"object","required":["step"],"title":"EuProcedureNextStep"},"EuProcedureScheduled":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"kind":{"type":"string","title":"Kind"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step"},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template"},"source":{"type":"string","title":"Source"},"label":{"type":"string","title":"Label","default":""},"stale":{"type":"boolean","title":"Stale","default":false}},"type":"object","required":["date","kind","source"],"title":"EuProcedureScheduled","description":"A known date: an EP sitting agenda item or a Cellar planned event (#1205)."},"EuProcedureScrutiny":{"properties":{"institution":{"type":"string","title":"Institution"},"deadline":{"type":"string","format":"date","title":"Deadline"},"deadline_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deadline Source"},"error_band_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Error Band Days"},"status":{"type":"string","title":"Status"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"c_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C Number"}},"type":"object","required":["institution","deadline","status"],"title":"EuProcedureScrutiny","description":"Next open scrutiny deadline of a delegated act or RPS measure (#1200)."},"EuProcedureStep":{"properties":{"step":{"type":"string","title":"Step"},"reached_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Reached On"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"current":{"type":"boolean","title":"Current","default":false},"branch":{"type":"boolean","title":"Branch","default":false}},"type":"object","required":["step"],"title":"EuProcedureStep","description":"One step of the file's procedure state machine (#1205)."},"EuProcedureView":{"properties":{"family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"},"procedure_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedure Type"},"step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step"},"entered_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Entered On"},"branch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Branch"},"terminal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terminal"},"terminal_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Terminal On"},"path":{"items":{"$ref":"#/components/schemas/EuProcedureStep"},"type":"array","title":"Path"},"next_steps":{"items":{"$ref":"#/components/schemas/EuProcedureNextStep"},"type":"array","title":"Next Steps"},"forecast":{"anyOf":[{"$ref":"#/components/schemas/EuProcedureForecast"},{"type":"null"}]},"forecast_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Note"},"scheduled":{"items":{"$ref":"#/components/schemas/EuProcedureScheduled"},"type":"array","title":"Scheduled"},"scrutiny":{"anyOf":[{"$ref":"#/components/schemas/EuProcedureScrutiny"},{"type":"null"}]},"dormancy":{"anyOf":[{"$ref":"#/components/schemas/EuProcedureDormancy"},{"type":"null"}]},"last_change":{"anyOf":[{"$ref":"#/components/schemas/EuProcedureLastChange"},{"type":"null"}]}},"type":"object","title":"EuProcedureView","description":"Where an EU file stands and what is expected next (#1205)."},"EuProposedBy":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"link_source":{"type":"string","title":"Link Source"}},"type":"object","required":["celex","label","link_source"],"title":"EuProposedBy"},"EuProvisionUnit":{"properties":{"unit":{"type":"string","title":"Unit"},"ref":{"type":"string","title":"Ref"}},"type":"object","required":["unit","ref"],"title":"EuProvisionUnit","description":"A top-level unit an amendment touches; ``unit`` is a vocabulary key\n(article, annex, part, title, chapter, section, recital, ...)."},"EuProvisionView":{"properties":{"units":{"items":{"$ref":"#/components/schemas/EuProvisionUnit"},"type":"array","title":"Units"},"count":{"type":"integer","title":"Count","default":0},"roles":{"items":{"type":"string"},"type":"array","title":"Roles"},"start_of_validity":{"items":{"type":"string"},"type":"array","title":"Start Of Validity"}},"type":"object","title":"EuProvisionView","description":"Cellar ``owl:Axiom`` provisions of one link, summarised."},"EuRevivalSignal":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"source":{"type":"string","title":"Source"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"radar_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Radar Item Id"}},"type":"object","required":["date","source"],"title":"EuRevivalSignal","description":"Related Commission activity on a file (#1206): a radar item or a Have Your Say publication."},"EuVersionChangesResponse":{"properties":{"celex":{"type":"string","title":"Celex"},"label":{"type":"string","title":"Label"},"version":{"type":"string","title":"Version"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"previous":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous"},"previous_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Date"},"status":{"type":"string","title":"Status"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"algorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Algorithm"},"computed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Computed At"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"changes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Changes"},"acts":{"items":{"$ref":"#/components/schemas/EuActWithItem"},"type":"array","title":"Acts"}},"type":"object","required":["celex","label","version","status"],"title":"EuVersionChangesResponse","description":"Provision-level changes of one consolidated version against its predecessor.\n\nEach change: ``key`` (``art:3/par:2``, ``annex:i``), ``label``\n(``Article 3(2)``), ``provision`` (``Article 3``), ``provision_kind``,\n``change`` (added | removed | modified), ``acts`` (``{act, location,\naction}`` from Cellar's change markers), and either ``segments``\n(``{kind: unchanged|removed|added, text}``) or annex ``hunks`` (rows of\n``{kind: context|removed|added, text}``); ``truncated`` / ``omitted`` when\na stored text was cut to bound its size."},"EuVersionEntry":{"properties":{"celex":{"type":"string","title":"Celex"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"status":{"type":"string","title":"Status"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"previous_celex":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Celex"},"changed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Changed"},"provisions":{"items":{"type":"string"},"type":"array","title":"Provisions"},"provisions_total":{"type":"integer","title":"Provisions Total","default":0},"acts":{"items":{"type":"string"},"type":"array","title":"Acts"},"repealed_by":{"items":{"type":"string"},"type":"array","title":"Repealed By"}},"type":"object","required":["celex","status"],"title":"EuVersionEntry","description":"One consolidated version and the summary of its comparison."},"EuVersionRef":{"properties":{"celex":{"type":"string","title":"Celex"},"date":{"type":"string","title":"Date"},"status":{"type":"string","title":"Status"}},"type":"object","required":["celex","date","status"],"title":"EuVersionRef"},"EuVersionsSummary":{"properties":{"count":{"type":"integer","title":"Count","default":0},"latest":{"anyOf":[{"$ref":"#/components/schemas/EuVersionEntry"},{"type":"null"}]}},"type":"object","title":"EuVersionsSummary"},"EventEnvelopeV1":{"properties":{"event_type":{"type":"string","title":"Event Type"},"aggregate_type":{"type":"string","title":"Aggregate Type"},"aggregate_id":{"type":"string","title":"Aggregate Id"},"jurisdiction_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction Code"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"},"idempotency_key":{"type":"string","title":"Idempotency Key"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"additionalProperties":false,"type":"object","required":["event_type","aggregate_type","aggregate_id","jurisdiction_code","occurred_at","idempotency_key","data","created_at"],"title":"EventEnvelopeV1","description":"One outbox event row as consumers see it on the wire."},"Exchange":{"properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","title":"Code"},"verifier":{"type":"string","pattern":"^[A-Za-z0-9_-]{43,128}$","title":"Verifier"},"state":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","title":"State"},"audience":{"type":"string","title":"Audience"}},"type":"object","required":["code","verifier","state","audience"],"title":"Exchange"},"FeaturePreviewGrantRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"FeaturePreviewGrantRequest","description":"Why the organization gets the preview (kept in the audit log)."},"GroupVoteRecord":{"properties":{"record_kind":{"type":"string","const":"group","title":"Record Kind","default":"group"},"group_type":{"type":"string","enum":["faction","party","bloc","other"],"title":"Group Type"},"group_key":{"type":"string","title":"Group Key"},"group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Name"},"vote_choice":{"type":"string","enum":["YES","NO","ABSTAIN","NOT_VOTING","UNKNOWN"],"title":"Vote Choice"},"support_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Support Count"},"oppose_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oppose Count"},"abstain_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Abstain Count"},"not_voting_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Not Voting Count"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["group_type","group_key","vote_choice"],"title":"GroupVoteRecord","description":"Per-group/faction vote record row."},"GroupedInboxResponse":{"properties":{"unread_count":{"type":"integer","title":"Unread Count"},"groups":{"items":{"$ref":"#/components/schemas/InboxGroup"},"type":"array","title":"Groups"},"standalone":{"anyOf":[{"$ref":"#/components/schemas/InboxGroup"},{"type":"null"}]}},"type":"object","required":["unread_count","groups"],"title":"GroupedInboxResponse","description":"Outlook-style inbox grouped by source watchlist (Phase 5)."},"GuidesUpdate":{"properties":{"welcome_seen":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Welcome Seen"},"checklist_dismissed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Checklist Dismissed"},"complete":{"anyOf":[{"type":"string","pattern":"^[a-z0-9-]{1,40}$"},{"type":"null"}],"title":"Complete"},"restart":{"type":"boolean","title":"Restart","default":false}},"additionalProperties":false,"type":"object","title":"GuidesUpdate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HistoryEntry":{"properties":{"query":{"type":"string","title":"Query"},"scope":{"type":"string","title":"Scope"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","title":"Jurisdiction Codes"}},"type":"object","required":["query","scope","jurisdiction_codes"],"title":"HistoryEntry"},"ImpressionsEvent":{"properties":{"event_type":{"type":"string","const":"impressions","title":"Event Type"},"surface":{"type":"string","enum":["search_page","explore","command_palette","discovery","detail"],"title":"Surface","default":"discovery"},"cards":{"items":{"$ref":"#/components/schemas/CardRef"},"type":"array","maxItems":12,"minItems":1,"title":"Cards"}},"type":"object","required":["event_type","cards"],"title":"ImpressionsEvent"},"InboxGroup":{"properties":{"kind":{"type":"string","title":"Kind"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"unread":{"type":"integer","title":"Unread"},"total":{"type":"integer","title":"Total"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"items":{"items":{"$ref":"#/components/schemas/InboxItem"},"type":"array","title":"Items"}},"type":"object","required":["kind","id","name","unread","total","items"],"title":"InboxGroup","description":"One source bucket in the grouped inbox view (Phase 5).\n\nA group is a watchlist (kind=\"watchlist\", id is the watchlist\nUUID), an alert that is not linked to a watchlist (kind=\"alert\",\nid is the alert UUID, name is the alert name), or a synthetic\nfolder (kind=\"saved_searches\" or \"system\"). The\n``jurisdictions`` array surfaces the distinct jurisdiction codes\nseen in the visible items so the frontend can render a secondary\nheader inside folders that span multiple jurisdictions."},"InboxItem":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","title":"Kind","default":"legislative"},"alert_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alert Id"},"alert_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alert Name"},"category":{"type":"string","title":"Category","default":"keyword"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtitle"},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"watchlist_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Watchlist Id"},"bill_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Id"},"bill_href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Href"},"event_href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Href"},"link_href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Href"},"event_starts_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Starts At"},"event_change_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Change Kind"},"event_prev_starts_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Prev Starts At"},"matched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Matched At"},"read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Read At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id"],"title":"InboxItem","description":"One row in the inbox.\n\nDefault shape is legislative (matcher hit). Non-legislative kinds\n(watchlist_shared, future role-changes, etc.) carry their context\nin ``metadata`` and may leave ``alert_id`` / ``reference`` /\n``status`` blank."},"InboxResponse":{"properties":{"unread_count":{"type":"integer","title":"Unread Count"},"items":{"items":{"$ref":"#/components/schemas/InboxItem"},"type":"array","title":"Items"}},"type":"object","required":["unread_count","items"],"title":"InboxResponse","description":"Recent notifications across all of the user's alerts."},"InviteCreateRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","enum":["admin","member"],"title":"Role","default":"member"},"expires_in_days":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Expires In Days","default":7}},"type":"object","required":["email"],"title":"InviteCreateRequest","description":"Payload used by admins to create organization invites."},"InviteResendRequest":{"properties":{"expires_in_days":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Expires In Days","default":7}},"type":"object","title":"InviteResendRequest","description":"Optional body for resending an invite: how long the new link lasts."},"InviteResendResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","title":"Role"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["id","email","role","expires_at"],"title":"InviteResendResponse","description":"The resent invite. The new token is only in the email."},"InviteResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","title":"Role"},"token":{"type":"string","title":"Token"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["id","email","role","token","expires_at","organization_id"],"title":"InviteResponse","description":"Response model for created organization invites."},"Issue":{"properties":{"sid":{"type":"string","format":"uuid","title":"Sid"},"audience":{"type":"string","title":"Audience"},"origin":{"type":"string","title":"Origin"},"challenge":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","title":"Challenge"},"state":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","title":"State"}},"type":"object","required":["sid","audience","origin","challenge","state"],"title":"Issue"},"ItemScheduledEvent":{"properties":{"event_id":{"type":"string","title":"Event Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"title":{"type":"string","title":"Title"},"event_family":{"type":"string","title":"Event Family"},"source_event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Event Type"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"all_day":{"type":"boolean","title":"All Day","default":false},"starts_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Starts On"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"access_level":{"type":"string","title":"Access Level","default":"public"},"relationship_type":{"type":"string","title":"Relationship Type"},"upcoming":{"type":"boolean","title":"Upcoming"}},"type":"object","required":["event_id","jurisdiction","title","event_family","starts_at","relationship_type","upcoming"],"title":"ItemScheduledEvent","description":"A calendar event this item is linked to (sitting, committee meeting, plenary slot)."},"ItemViewEvent":{"properties":{"event_type":{"type":"string","const":"item_view","title":"Event Type"},"item_id":{"type":"string","format":"uuid","title":"Item Id"},"surface":{"type":"string","enum":["search_page","explore","command_palette","discovery","detail"],"title":"Surface","default":"detail"}},"type":"object","required":["event_type","item_id"],"title":"ItemViewEvent"},"ItemVoteEventRecords":{"properties":{"vote_event":{"$ref":"#/components/schemas/VoteEventSummary"},"records":{"items":{"anyOf":[{"$ref":"#/components/schemas/PersonVoteRecord"},{"$ref":"#/components/schemas/GroupVoteRecord"}]},"type":"array","title":"Records"}},"type":"object","required":["vote_event"],"title":"ItemVoteEventRecords","description":"Vote event rows for one item, combining person and group records."},"ItemVotesResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"vote_events":{"items":{"$ref":"#/components/schemas/ItemVoteEventRecords"},"type":"array","title":"Vote Events"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"}},"type":"object","required":["item_id","coverage"],"title":"ItemVotesResponse","description":"Vote events and mixed rows for one legislative item."},"JurisdictionExtensions":{"properties":{"procedure_phase":{"additionalProperties":true,"type":"object","title":"Procedure Phase"},"faction_details":{"additionalProperties":true,"type":"object","title":"Faction Details"},"enrichment_confidence":{"additionalProperties":true,"type":"object","title":"Enrichment Confidence"},"eu_initiative":{"additionalProperties":true,"type":"object","title":"Eu Initiative"}},"type":"object","title":"JurisdictionExtensions","description":"Jurisdiction-native semantics surfaced without polluting canonical fields."},"JurisdictionFreshness":{"properties":{"last_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced At"},"last_sync_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync Status"},"items_synced":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Items Synced"},"is_stale":{"type":"boolean","title":"Is Stale","default":true}},"type":"object","title":"JurisdictionFreshness","description":"Per-jurisdiction data freshness indicator from sync_log."},"JurisdictionItem":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"default_language":{"type":"string","title":"Default Language"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"staged":{"type":"boolean","title":"Staged","default":false},"freshness":{"$ref":"#/components/schemas/JurisdictionFreshness"}},"type":"object","required":["code","name","default_language"],"title":"JurisdictionItem","description":"Jurisdiction descriptor with localization and metadata fields."},"JurisdictionsResponse":{"properties":{"jurisdictions":{"items":{"$ref":"#/components/schemas/JurisdictionItem"},"type":"array","title":"Jurisdictions"}},"type":"object","required":["jurisdictions"],"title":"JurisdictionsResponse","description":"Response model listing entitled jurisdictions."},"LegalAcknowledgement":{"properties":{"consent_version":{"type":"string","maxLength":200,"minLength":1,"title":"Consent Version"},"privacy_accepted":{"type":"boolean","title":"Privacy Accepted","default":false},"terms_accepted":{"type":"boolean","title":"Terms Accepted","default":false}},"type":"object","required":["consent_version"],"title":"LegalAcknowledgement"},"LegalConsentRequest":{"properties":{"consent":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Consent"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"terms_accepted":{"type":"boolean","title":"Terms Accepted","default":false},"privacy_accepted":{"type":"boolean","title":"Privacy Accepted","default":false},"consent_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consent Version"}},"type":"object","title":"LegalConsentRequest","description":"Acceptance of the current legal terms during sign-in.\n\nNormally carries the ``cc_`` consent challenge from ``/auth/login`` and\nreturns a login ticket. The older email+password form is kept for\ncompatibility: it records acceptance only and never creates a session."},"LegislativeCommitteeDetail":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_committee_id":{"type":"string","title":"Source Committee Id"},"name":{"type":"string","title":"Name"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"committee_mode":{"type":"string","title":"Committee Mode","default":"legislative"},"committee_kind":{"type":"string","title":"Committee Kind","default":"other"},"handles_bills":{"type":"boolean","title":"Handles Bills","default":true},"calendar_coverage":{"type":"string","title":"Calendar Coverage","default":"unavailable"},"active_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Active From"},"active_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Active To"},"next_event":{"anyOf":[{"$ref":"#/components/schemas/CommitteeNextEventSummary"},{"type":"null"}]},"member_count":{"type":"integer","title":"Member Count","default":0},"linked_items_total":{"type":"integer","title":"Linked Items Total","default":0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"memberships":{"items":{"$ref":"#/components/schemas/CommitteeMembershipEntry"},"type":"array","title":"Memberships"}},"type":"object","required":["id","jurisdiction","source_system","source_committee_id","name"],"title":"LegislativeCommitteeDetail","description":"Committee detail including membership history and actor counts."},"LegislativeCommitteeDetailResponse":{"properties":{"committee":{"$ref":"#/components/schemas/LegislativeCommitteeDetail"}},"type":"object","required":["committee"],"title":"LegislativeCommitteeDetailResponse","description":"Response model for single committee detail endpoint."},"LegislativeCommitteeSummary":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_committee_id":{"type":"string","title":"Source Committee Id"},"name":{"type":"string","title":"Name"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"committee_mode":{"type":"string","title":"Committee Mode","default":"legislative"},"committee_kind":{"type":"string","title":"Committee Kind","default":"other"},"handles_bills":{"type":"boolean","title":"Handles Bills","default":true},"calendar_coverage":{"type":"string","title":"Calendar Coverage","default":"unavailable"},"active_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Active From"},"active_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Active To"},"next_event":{"anyOf":[{"$ref":"#/components/schemas/CommitteeNextEventSummary"},{"type":"null"}]},"member_count":{"type":"integer","title":"Member Count","default":0},"linked_items_total":{"type":"integer","title":"Linked Items Total","default":0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","jurisdiction","source_system","source_committee_id","name"],"title":"LegislativeCommitteeSummary","description":"Directory summary entry for a legislative committee."},"LegislativeCommitteeV1":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"source_system":{"type":"string","title":"Source System"},"source_committee_id":{"type":"string","title":"Source Committee Id"},"name":{"type":"string","title":"Name"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"committee_mode":{"type":"string","title":"Committee Mode"},"committee_kind":{"type":"string","title":"Committee Kind"},"handles_bills":{"type":"boolean","title":"Handles Bills"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","jurisdiction_code","source_system","source_committee_id","name","committee_mode","committee_kind","handles_bills","created_at","updated_at"],"title":"LegislativeCommitteeV1","description":"Parliamentary committee — standing, select, joint, sub-committee, etc.\n\n``committee_mode`` and ``committee_kind`` are NOT NULL on the\nsource table (with sensible defaults), so they're always\npopulated in the external payload.\n\nExcluded: ``metadata`` (internal flags), ``calendar_coverage``\n(operational status of PoliData's calendar scraper — not a\nconsumer concern)."},"LegislativeCommitteesResponse":{"properties":{"committees":{"items":{"$ref":"#/components/schemas/LegislativeCommitteeSummary"},"type":"array","title":"Committees"},"total":{"type":"integer","title":"Total","default":0},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":50}},"type":"object","required":["committees"],"title":"LegislativeCommitteesResponse","description":"Response model for committee directory list endpoint."},"LegislativeItemAction":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"text":{"type":"string","title":"Text"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"scheduled":{"type":"boolean","title":"Scheduled","default":false}},"type":"object","required":["date","text"],"title":"LegislativeItemAction","description":"Single legislative item action history entry.\n\n``source`` is set on EU items: ``europarl`` (EP API activity) or ``cellar``\n(inter-institutional event from the Publications Office, #1204).\n``scheduled`` marks a planned event (Cellar ``event_legal_projected`` or a\nfuture date)."},"LegislativeItemActor":{"properties":{"actor_type":{"type":"string","enum":["person","committee","organization"],"title":"Actor Type"},"actor_id":{"type":"string","title":"Actor Id"},"name":{"type":"string","title":"Name"},"relationship_type":{"type":"string","title":"Relationship Type"},"role_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Role Order"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source":{"anyOf":[{"type":"string","enum":["api","enrichment","name_match","vote_participant","sponsor_fallback"]},{"type":"null"}],"title":"Source"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["actor_type","actor_id","name","relationship_type"],"title":"LegislativeItemActor","description":"Normalized actor relationship attached to a legislative item."},"LegislativeItemAmendment":{"properties":{"id":{"type":"string","title":"Id"},"source_system":{"type":"string","title":"Source System"},"source_item_id":{"type":"string","title":"Source Item Id"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"introduced_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Introduced Date"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"latest_action_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Action Text"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"full_text_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text Url"},"parent_source_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Source Item Id"},"source_amendment_stage_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Amendment Stage Id"},"supersedes_source_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supersedes Source Item Id"},"link_strength":{"anyOf":[{"type":"string","enum":["explicit","stage","process","text_only"]},{"type":"null"}],"title":"Link Strength"},"sponsors":{"items":{"$ref":"#/components/schemas/LegislativeItemAmendmentSponsor"},"type":"array","title":"Sponsors"},"source_links":{"items":{"$ref":"#/components/schemas/LegislativeItemAmendmentSourceLink"},"type":"array","title":"Source Links"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","source_system","source_item_id","title"],"title":"LegislativeItemAmendment","description":"Related amendment summary surfaced on a bill detail response."},"LegislativeItemAmendmentPreview":{"properties":{"id":{"type":"string","title":"Id"},"source_item_id":{"type":"string","title":"Source Item Id"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"latest_action_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Action Text"},"link_strength":{"anyOf":[{"type":"string","enum":["explicit","stage","process","text_only"]},{"type":"null"}],"title":"Link Strength"},"lead_sponsor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Sponsor Name"},"lead_sponsor_party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Sponsor Party"},"lead_sponsor_actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Sponsor Actor Id"}},"type":"object","required":["id","source_item_id","title"],"title":"LegislativeItemAmendmentPreview","description":"Compact amendment summary surfaced inline on list cards.\n\nThe grouped-cards legislation design (#204 amendment history)\ntucks a bill's amendments and clauses into an expandable strip at\nthe bottom of each card. To render that strip — and the nested\nchildren when expanded — without an extra round-trip per card, the\nlist endpoint returns the most-recent few amendments per bill in\nthis trimmed shape. The full amendment record (source links,\nfull sponsor list, etc.) still lives on the bill detail response."},"LegislativeItemAmendmentSourceLink":{"properties":{"label":{"type":"string","title":"Label"},"url":{"type":"string","title":"Url"}},"type":"object","required":["label","url"],"title":"LegislativeItemAmendmentSourceLink","description":"One official source link associated with an amendment."},"LegislativeItemAmendmentSponsor":{"properties":{"name":{"type":"string","title":"Name"},"actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Id"},"source_person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Person Id"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"is_lead":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Lead"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["name"],"title":"LegislativeItemAmendmentSponsor","description":"Normalized sponsor summary for a related amendment."},"LegislativeItemAmendmentsResponse":{"properties":{"amendments":{"items":{"$ref":"#/components/schemas/LegislativeItemAmendment"},"type":"array","title":"Amendments"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"}},"type":"object","required":["pagination"],"title":"LegislativeItemAmendmentsResponse","description":"Paginated amendments for one bill (detail Amendments tab)."},"LegislativeItemChildDocument":{"properties":{"id":{"type":"string","title":"Id"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"item_type":{"type":"string","title":"Item Type"},"item_type_label":{"type":"string","title":"Item Type Label"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"}},"type":"object","required":["id","item_type","item_type_label","title"],"title":"LegislativeItemChildDocument","description":"A non-amendment document linked to a bill via ``parent_item_id``.\n\nCommittee reports, PL prints, etc. — feeds the bill detail Documents\ntab (#220). Amendments are excluded; they have their own tab."},"LegislativeItemDetail":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"jurisdiction_metadata":{"additionalProperties":true,"type":"object","title":"Jurisdiction Metadata"},"comparability_tiers":{"$ref":"#/components/schemas/ComparabilityTiers"},"jurisdiction_extensions":{"$ref":"#/components/schemas/JurisdictionExtensions"},"source_system":{"type":"string","title":"Source System"},"item_type":{"type":"string","title":"Item Type"},"congress":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Congress"},"bill_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Type"},"bill_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bill Number"},"title":{"type":"string","title":"Title"},"title_native":{"type":"string","title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"summary_native_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Native En"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"summary_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary En"},"summary_translations":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Summary Translations"},"ai_summary":{"anyOf":[{"$ref":"#/components/schemas/AiSummaryProvenance"},{"type":"null"}]},"summary_short":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Short"},"summary_long":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Long"},"topics":{"items":{"$ref":"#/components/schemas/TopicLabel"},"type":"array","title":"Topics"},"summary_bullets":{"items":{"type":"string"},"type":"array","title":"Summary Bullets"},"actors_preview":{"items":{"$ref":"#/components/schemas/LegislativeItemActor"},"type":"array","title":"Actors Preview"},"actors_total":{"type":"integer","title":"Actors Total","default":0},"sponsors_total":{"type":"integer","title":"Sponsors Total","default":0},"transposes_eu":{"type":"boolean","title":"Transposes Eu","default":false},"eu_transposes_celex":{"items":{"type":"string"},"type":"array","title":"Eu Transposes Celex"},"eu_implements_celex":{"items":{"type":"string"},"type":"array","title":"Eu Implements Celex"},"amendments_total":{"type":"integer","title":"Amendments Total","default":0},"amendments_preview":{"items":{"$ref":"#/components/schemas/LegislativeItemAmendmentPreview"},"type":"array","title":"Amendments Preview"},"introduced_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Introduced Date"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"latest_action_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Action Text"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"full_text_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text Url"},"parent_legislative_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Legislative Item Id"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"summary_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Native"},"public_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Url"},"public_full_text_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Full Text Url"},"actors":{"items":{"$ref":"#/components/schemas/LegislativeItemActor"},"type":"array","title":"Actors"},"actions":{"items":{"$ref":"#/components/schemas/LegislativeItemAction"},"type":"array","title":"Actions"},"vote_links":{"items":{"$ref":"#/components/schemas/LegislativeItemVoteLink"},"type":"array","title":"Vote Links"},"amendments":{"items":{"$ref":"#/components/schemas/LegislativeItemAmendment"},"type":"array","title":"Amendments"},"related_bills":{"items":{"$ref":"#/components/schemas/RelatedBill"},"type":"array","title":"Related Bills"},"transposes_celex":{"items":{"type":"string"},"type":"array","title":"Transposes Celex"},"implements_celex":{"items":{"type":"string"},"type":"array","title":"Implements Celex"},"cites_celex":{"items":{"type":"string"},"type":"array","title":"Cites Celex"},"eu_transposition_status":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Eu Transposition Status"},"adopted_acts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Adopted Acts"},"eu_documents":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Eu Documents"},"eu_consultation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Eu Consultation"},"enacted_law":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Enacted Law"},"scheduled_events":{"items":{"$ref":"#/components/schemas/ItemScheduledEvent"},"type":"array","title":"Scheduled Events"},"scheduled_events_upcoming_total":{"type":"integer","title":"Scheduled Events Upcoming Total","default":0},"scheduled_events_past_total":{"type":"integer","title":"Scheduled Events Past Total","default":0}},"type":"object","required":["id","jurisdiction","source_system","item_type","title","title_native"],"title":"LegislativeItemDetail","description":"Extended legislative item payload including native text, actions, and vote links."},"LegislativeItemDetailResponse":{"properties":{"legislative_item":{"$ref":"#/components/schemas/LegislativeItemDetail"}},"type":"object","required":["legislative_item"],"title":"LegislativeItemDetailResponse","description":"Response model wrapping a single detailed legislative item payload."},"LegislativeItemDocumentsResponse":{"properties":{"documents":{"items":{"$ref":"#/components/schemas/LegislativeItemChildDocument"},"type":"array","title":"Documents"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"}},"type":"object","required":["pagination"],"title":"LegislativeItemDocumentsResponse","description":"Paginated child documents for one bill (detail Documents tab)."},"LegislativeItemEuAmendmentsResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"available":{"type":"boolean","title":"Available","default":false},"procedure_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedure Code"},"stage":{"type":"string","title":"Stage","default":"none"},"proposals":{"items":{"$ref":"#/components/schemas/EuActRef"},"type":"array","title":"Proposals"},"targets":{"items":{"$ref":"#/components/schemas/EuAmendedTarget"},"type":"array","title":"Targets"},"acts":{"items":{"$ref":"#/components/schemas/EuOwnAct"},"type":"array","title":"Acts"},"proposal_checked":{"type":"boolean","title":"Proposal Checked","default":false},"refreshed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Refreshed At"}},"type":"object","required":["item_id"],"title":"LegislativeItemEuAmendmentsResponse","description":"What an EU procedure amends, re-resolved at adoption, and what amends\nthe acts it produced (#1207)."},"LegislativeItemEuDossierResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"available":{"type":"boolean","title":"Available","default":false},"dossier":{"anyOf":[{"$ref":"#/components/schemas/EuDossierSummary"},{"type":"null"}]},"events":{"items":{"$ref":"#/components/schemas/EuDossierEvent"},"type":"array","title":"Events"},"procedure":{"anyOf":[{"$ref":"#/components/schemas/EuProcedureView"},{"type":"null"}]}},"type":"object","required":["item_id"],"title":"LegislativeItemEuDossierResponse","description":"EP and Cellar events of an EU item merged, each with its source (#1204),\nplus the procedure state and forecast (#1205)."},"LegislativeItemListEntry":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"jurisdiction_metadata":{"additionalProperties":true,"type":"object","title":"Jurisdiction Metadata"},"comparability_tiers":{"$ref":"#/components/schemas/ComparabilityTiers"},"jurisdiction_extensions":{"$ref":"#/components/schemas/JurisdictionExtensions"},"source_system":{"type":"string","title":"Source System"},"item_type":{"type":"string","title":"Item Type"},"congress":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Congress"},"bill_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Type"},"bill_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bill Number"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"summary_native_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Native En"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"summary_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary En"},"summary_translations":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Summary Translations"},"ai_summary":{"anyOf":[{"$ref":"#/components/schemas/AiSummaryProvenance"},{"type":"null"}]},"summary_short":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Short"},"summary_long":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Long"},"topics":{"items":{"$ref":"#/components/schemas/TopicLabel"},"type":"array","title":"Topics"},"summary_bullets":{"items":{"type":"string"},"type":"array","title":"Summary Bullets"},"actors_preview":{"items":{"$ref":"#/components/schemas/LegislativeItemActor"},"type":"array","title":"Actors Preview"},"actors_total":{"type":"integer","title":"Actors Total","default":0},"sponsors_total":{"type":"integer","title":"Sponsors Total","default":0},"transposes_eu":{"type":"boolean","title":"Transposes Eu","default":false},"eu_transposes_celex":{"items":{"type":"string"},"type":"array","title":"Eu Transposes Celex"},"eu_implements_celex":{"items":{"type":"string"},"type":"array","title":"Eu Implements Celex"},"amendments_total":{"type":"integer","title":"Amendments Total","default":0},"amendments_preview":{"items":{"$ref":"#/components/schemas/LegislativeItemAmendmentPreview"},"type":"array","title":"Amendments Preview"},"introduced_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Introduced Date"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"latest_action_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Action Text"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"full_text_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text Url"},"parent_legislative_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Legislative Item Id"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","jurisdiction","source_system","item_type","title"],"title":"LegislativeItemListEntry","description":"Legislative item summary returned from paginated list endpoint."},"LegislativeItemSecondaryLegislationResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"role":{"type":"string","title":"Role"},"basic_acts":{"items":{"$ref":"#/components/schemas/SecondaryBasicAct"},"type":"array","title":"Basic Acts"},"acts":{"items":{"$ref":"#/components/schemas/SecondaryAct"},"type":"array","title":"Acts"},"total":{"type":"integer","title":"Total","default":0},"counts":{"$ref":"#/components/schemas/SecondaryLegislationCounts"},"other_acts":{"items":{"$ref":"#/components/schemas/SecondaryOtherAct"},"type":"array","title":"Other Acts"},"other_acts_total":{"type":"integer","title":"Other Acts Total","default":0},"limit":{"type":"integer","title":"Limit","default":50},"offset":{"type":"integer","title":"Offset","default":0}},"type":"object","required":["item_id","role"],"title":"LegislativeItemSecondaryLegislationResponse","description":"Secondary legislation of an EU item (#1200).\n\n``role``: ``basic_act`` (acts adopted under the act this procedure\nproduced), ``scrutiny`` (the act an EP DEA/RPS procedure scrutinises) or\n``none``."},"LegislativeItemV1":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code","description":"ISO-2 jurisdiction code: US | UK | PL | NL | EU."},"source_system":{"type":"string","title":"Source System"},"source_bill_id":{"type":"string","title":"Source Bill Id"},"item_type":{"type":"string","title":"Item Type"},"item_subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Subtype"},"source_document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Document Type"},"congress":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Congress","description":"Term / parliament / cadencja number. Jurisdiction-specific."},"bill_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Type"},"bill_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bill Number"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"summary_short":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Short","description":"LLM-generated short blurb (~140 chars). Present only if classified."},"summary_long":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Long"},"introduced_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Introduced Date"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"latest_action_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Action Text"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"full_text_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text Url"},"topics":{"items":{"$ref":"#/components/schemas/TopicLabelV1"},"type":"array","title":"Topics","description":"LLM-classified topic labels. Empty list if not classified."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","jurisdiction_code","source_system","source_bill_id","item_type","title","created_at","updated_at"],"title":"LegislativeItemV1","description":"Bills, amendments, resolutions, motions, reports, etc.\n\nThe full canonical taxonomy lives in #218/#220 — ``item_type`` is\nthe coarse bucket (``bill``, ``amendment``, ``resolution``,\n``committee_report``, ``inter_chamber_message`` …),\n``item_subtype`` is the canonical refinement (e.g., ``senate_action``\nfor an inter-chamber Senate response), and ``source_document_type``\npreserves the native upstream label untranslated (``\"H.R.\"``,\n``\"Uchwała Senatu\"``, ``\"Begroting\"``).\n\nInternal fields excluded (see #226 acceptance criteria + design\ndoc §4.1): ``metadata``, ``full_text``, ``embedding_status``,\n``embedding_updated_at``, ``summary_translations``, ``title_en``,\n``summary_en``.\n\n``full_text`` is reachable via ``full_text_url`` for consumers\nthat need it — keeping it out of the list payload avoids hundreds\nof KB per row."},"LegislativeItemVoteLink":{"properties":{"source_system":{"type":"string","title":"Source System"},"source_vote_id":{"type":"string","title":"Source Vote Id"},"vote_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Vote Date"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"},"result_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Text"},"yes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yes Count"},"no_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"No Count"},"abstain_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Abstain Count"},"absent_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Absent Count"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"link_method":{"type":"string","title":"Link Method"},"confidence":{"type":"string","title":"Confidence"},"comparability_tiers":{"$ref":"#/components/schemas/ComparabilityTiers"},"jurisdiction_extensions":{"$ref":"#/components/schemas/JurisdictionExtensions"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["source_system","source_vote_id","link_method","confidence"],"title":"LegislativeItemVoteLink","description":"Linked vote event metadata for a legislative item detail response."},"LegislativeItemsAppliedFilters":{"properties":{"jurisdiction":{"type":"string","title":"Jurisdiction"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"item_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Type"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"date_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"},"date_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"},"date_field":{"type":"string","enum":["introduced_date","latest_action_date"],"title":"Date Field","default":"introduced_date"},"actor_type":{"anyOf":[{"type":"string","enum":["person","committee","organization"]},{"type":"null"}],"title":"Actor Type"},"actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Id"},"relationship_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relationship Type"}},"type":"object","required":["jurisdiction"],"title":"LegislativeItemsAppliedFilters","description":"Canonical filter echo for list responses."},"LegislativeItemsMeta":{"properties":{"applied_filters":{"$ref":"#/components/schemas/LegislativeItemsAppliedFilters"},"sort":{"$ref":"#/components/schemas/LegislativeItemsSort"},"query_time_ms":{"type":"integer","title":"Query Time Ms"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["applied_filters","sort","query_time_ms","generated_at"],"title":"LegislativeItemsMeta","description":"Operational and query metadata returned with list responses."},"LegislativeItemsPagination":{"properties":{"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"total":{"type":"integer","title":"Total"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["page","per_page","total","pages"],"title":"LegislativeItemsPagination","description":"Pagination metadata for list responses."},"LegislativeItemsResponse":{"properties":{"legislative_items":{"items":{"$ref":"#/components/schemas/LegislativeItemListEntry"},"type":"array","title":"Legislative Items"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"},"meta":{"$ref":"#/components/schemas/LegislativeItemsMeta"}},"type":"object","required":["legislative_items","pagination","meta"],"title":"LegislativeItemsResponse","description":"Response model for paginated legislative item list endpoint."},"LegislativeItemsSort":{"properties":{"field":{"type":"string","title":"Field"},"order":{"type":"string","title":"Order"}},"type":"object","required":["field","order"],"title":"LegislativeItemsSort","description":"Deterministic sort descriptor returned by list endpoint."},"LegislativeOrganizationDetail":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_organization_id":{"type":"string","title":"Source Organization Id"},"name":{"type":"string","title":"Name"},"organization_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"linked_items_total":{"type":"integer","title":"Linked Items Total","default":0}},"type":"object","required":["id","jurisdiction","source_system","source_organization_id","name"],"title":"LegislativeOrganizationDetail","description":"Organization detail including linked item count."},"LegislativeOrganizationDetailResponse":{"properties":{"organization":{"$ref":"#/components/schemas/LegislativeOrganizationDetail"}},"type":"object","required":["organization"],"title":"LegislativeOrganizationDetailResponse","description":"Response model for single organization detail endpoint."},"LegislativeOrganizationSummary":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_organization_id":{"type":"string","title":"Source Organization Id"},"name":{"type":"string","title":"Name"},"organization_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","jurisdiction","source_system","source_organization_id","name"],"title":"LegislativeOrganizationSummary","description":"Directory summary entry for a legislative organization."},"LegislativeOrganizationsResponse":{"properties":{"organizations":{"items":{"$ref":"#/components/schemas/LegislativeOrganizationSummary"},"type":"array","title":"Organizations"}},"type":"object","required":["organizations"],"title":"LegislativeOrganizationsResponse","description":"Response model for organization directory list endpoint."},"LegislativePartiesResponse":{"properties":{"parties":{"items":{"$ref":"#/components/schemas/LegislativePartySummary"},"type":"array","title":"Parties"},"members_total":{"type":"integer","title":"Members Total","description":"Distinct parliamentary members across the returned groups.","default":0}},"type":"object","required":["parties"],"title":"LegislativePartiesResponse","description":"Response model for party directory list endpoint."},"LegislativePartyDetail":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_party_id":{"type":"string","title":"Source Party Id"},"name":{"type":"string","title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"color_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color Code"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"members_total":{"type":"integer","title":"Members Total","default":0},"party_type":{"type":"string","title":"Party Type","default":"party"},"parent_party_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Party Id"},"parent_party_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Party Name"},"member_parties_count":{"type":"integer","title":"Member Parties Count","default":0},"memberships":{"items":{"$ref":"#/components/schemas/PartyMembershipEntry"},"type":"array","title":"Memberships"},"leadership":{"items":{"$ref":"#/components/schemas/PartyLeadershipEntry"},"type":"array","title":"Leadership"},"stats":{"$ref":"#/components/schemas/PartyStats"},"member_parties":{"items":{"$ref":"#/components/schemas/LegislativePartySummary"},"type":"array","title":"Member Parties"}},"type":"object","required":["id","jurisdiction","source_system","source_party_id","name"],"title":"LegislativePartyDetail","description":"Party detail including membership roster."},"LegislativePartyDetailResponse":{"properties":{"party":{"$ref":"#/components/schemas/LegislativePartyDetail"}},"type":"object","required":["party"],"title":"LegislativePartyDetailResponse","description":"Response model for single party detail endpoint."},"LegislativePartySummary":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_party_id":{"type":"string","title":"Source Party Id"},"name":{"type":"string","title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"color_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color Code"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"members_total":{"type":"integer","title":"Members Total","default":0},"party_type":{"type":"string","title":"Party Type","default":"party"},"parent_party_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Party Id"},"parent_party_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Party Name"},"member_parties_count":{"type":"integer","title":"Member Parties Count","default":0}},"type":"object","required":["id","jurisdiction","source_system","source_party_id","name"],"title":"LegislativePartySummary","description":"Directory summary entry for a political party."},"LegislativePartyV1":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"source_system":{"type":"string","title":"Source System"},"source_party_id":{"type":"string","title":"Source Party Id"},"name":{"type":"string","title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"color_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color Code","description":"Hex color string (e.g., '#0033A0'). Useful for consumer UIs."},"party_type":{"type":"string","title":"Party Type"},"parent_party_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Party Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","jurisdiction_code","source_system","source_party_id","name","party_type","created_at","updated_at"],"title":"LegislativePartyV1","description":"Political party.\n\n``party_type`` is NOT NULL on source (default ``'party'``), so\nalways populated.  ``parent_party_id`` points at another party row\nwhen this row is a sub-faction or a coalition member.\n\n``color_code`` is the hex string the frontend uses for party\nswatches (e.g., ``\"#0033A0\"``) — exposed because consumer UIs\nbenefit from consistent party styling.\n\nExcluded: ``metadata``."},"LegislativePersonV1":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"source_system":{"type":"string","title":"Source System"},"source_person_id":{"type":"string","title":"Source Person Id"},"bioguide_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bioguide Id"},"lis_member_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lis Member Id"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"middle_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Middle Name"},"last_name":{"type":"string","title":"Last Name"},"full_name":{"type":"string","title":"Full Name"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"district":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"District"},"current_member":{"type":"boolean","title":"Current Member"},"official_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Official Url"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","jurisdiction_code","source_system","source_person_id","last_name","full_name","current_member","created_at","updated_at"],"title":"LegislativePersonV1","description":"Politician — MP / MEP / Senator / Representative.\n\nThe ``state`` field is jurisdiction-specific: US states for US, NULL\nor a region code for UK/PL/NL/EU. Consumers should not assume a\nsingle semantic.\n\nInternal fields excluded:\n\n- ``metadata`` — staging refs, source IDs, internal flags\n- ``office_address``, ``office_city``, ``office_state``, ``office_zip``,\n  ``office_phone`` — PII not relevant to consumers like CC. If a\n  future consumer needs these, that's a scope discussion in a v1\n  additive field or a separate ``/v1/people/{id}/contact`` endpoint."},"LegislativeVoteRecordV1":{"properties":{"id":{"type":"string","title":"Id"},"vote_event_id":{"type":"string","title":"Vote Event Id"},"source_person_id":{"type":"string","title":"Source Person Id"},"legislator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legislator Id"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"vote_choice":{"type":"string","enum":["YES","NO","ABSTAIN","NOT_VOTING","UNKNOWN"],"title":"Vote Choice"},"source_vote_choice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Vote Choice"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","vote_event_id","source_person_id","vote_choice","created_at","updated_at"],"title":"LegislativeVoteRecordV1","description":"One politician's vote on one vote event.\n\nNatural identity is the composite ``(vote_event_id, source_person_id)``.\n``id`` is a deterministic UUIDv5 derived from that pair so consumers\nhave a single-column id for ON CONFLICT-style upserts (same shape\nas every other external entity).\n\n``legislator_id`` is nullable — present once PoliData has resolved\nthe source person to a canonical ``legislative_people`` row;\nNULL for historical records the resolver hasn't reached yet.\n\nThe exact source-native choice is exposed separately from the stable canonical enum."},"LegislativeVoteV1":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"source_system":{"type":"string","title":"Source System"},"source_vote_id":{"type":"string","title":"Source Vote Id"},"vote_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Vote Date"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"},"result_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Text"},"yes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yes Count"},"no_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"No Count"},"abstain_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Abstain Count"},"absent_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Absent Count"},"binary_comparable":{"type":"boolean","title":"Binary Comparable","default":true},"choice_semantics":{"type":"string","title":"Choice Semantics","default":"binary_roll_call"},"source_choice_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Source Choice Counts"},"unknown_choice_count":{"type":"integer","title":"Unknown Choice Count","default":0},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","jurisdiction_code","source_system","source_vote_id","created_at","updated_at"],"title":"LegislativeVoteV1","description":"Chamber-level vote event with aggregate counts.\n\nSource semantics are exposed explicitly without publishing internal metadata."},"LinkIntentRequest":{"properties":{"provider":{"type":"string","enum":["google","microsoft"],"title":"Provider"}},"additionalProperties":false,"type":"object","required":["provider"],"title":"LinkIntentRequest"},"LinkTokenRequest":{"properties":{"link_token":{"type":"string","maxLength":64,"title":"Link Token"}},"additionalProperties":false,"type":"object","required":["link_token"],"title":"LinkTokenRequest"},"LocalizedText":{"properties":{"en":{"type":"string","minLength":1,"title":"En"},"pl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pl"},"nl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nl"}},"additionalProperties":false,"type":"object","required":["en"],"title":"LocalizedText","description":"English is required; Polish and Dutch fall back to English when empty."},"LoginChallengeRequest":{"properties":{"challenge":{"type":"string","maxLength":64,"title":"Challenge"}},"additionalProperties":false,"type":"object","required":["challenge"],"title":"LoginChallengeRequest"},"LoginMfaRequest":{"properties":{"challenge":{"type":"string","maxLength":64,"title":"Challenge"},"method":{"type":"string","enum":["totp","recovery_code","passkey"],"title":"Method"},"code":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Code"},"credential":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Credential"}},"additionalProperties":false,"type":"object","required":["challenge","method"],"title":"LoginMfaRequest"},"MeResponse":{"properties":{"user":{"$ref":"#/components/schemas/UserResponse"},"organization":{"$ref":"#/components/schemas/OrganizationResponse"},"workspace_kind":{"type":"string","enum":["personal","team"],"title":"Workspace Kind"},"features":{"additionalProperties":{"type":"string"},"type":"object","title":"Features","default":{}},"previews":{"items":{"type":"string"},"type":"array","title":"Previews","default":[]}},"type":"object","required":["user","organization","workspace_kind"],"title":"MeResponse","description":"Response model for authenticated `/me` endpoint."},"MilestoneClassOption":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"terminal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terminal"},"default":{"type":"boolean","title":"Default"}},"type":"object","required":["id","label","description","default"],"title":"MilestoneClassOption","description":"One shared outcome class a status alert can watch."},"MustActRow":{"properties":{"change_key":{"type":"string","title":"Change Key"},"change_type":{"type":"string","title":"Change Type"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"stake":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stake"},"due_label_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Label Key"},"act_today_reason_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Act Today Reason Key"},"due_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due At"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Id"},"vote_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vote Event Id"}},"type":"object","required":["change_key","change_type","jurisdiction"],"title":"MustActRow","description":"One numbered row on the hero's must-act list (#496)."},"NativeMilestoneOption":{"properties":{"id":{"type":"string","title":"Id"},"native_label":{"type":"string","title":"Native Label"},"label":{"type":"string","title":"Label"},"class":{"type":"string","title":"Class"},"position":{"type":"integer","title":"Position"}},"type":"object","required":["id","native_label","label","class","position"],"title":"NativeMilestoneOption","description":"One native milestone of a jurisdiction's procedure, in procedure order."},"NotificationPreferencesResponse":{"properties":{"timezone":{"type":"string","title":"Timezone"},"digest_hour":{"type":"integer","title":"Digest Hour"},"digest_minute":{"type":"integer","title":"Digest Minute"},"weekdays":{"items":{"type":"integer"},"type":"array","title":"Weekdays"},"max_digests_per_day":{"type":"integer","title":"Max Digests Per Day"},"severity_floor":{"type":"string","enum":["low","normal","high"],"title":"Severity Floor"},"quiet_hours_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quiet Hours Start"},"quiet_hours_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quiet Hours End"},"realtime_email_cap":{"type":"integer","title":"Realtime Email Cap"}},"type":"object","required":["timezone","digest_hour","digest_minute","weekdays","max_digests_per_day","severity_floor","realtime_email_cap"],"title":"NotificationPreferencesResponse","description":"Consolidated /settings/notifications payload — schedule + account-level."},"NotificationPreferencesUpdateRequest":{"properties":{"severity_floor":{"anyOf":[{"type":"string","enum":["low","normal","high"]},{"type":"null"}],"title":"Severity Floor"},"quiet_hours_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quiet Hours Start"},"quiet_hours_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quiet Hours End"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"digest_hour":{"anyOf":[{"type":"integer","maximum":23.0,"minimum":0.0},{"type":"null"}],"title":"Digest Hour"},"digest_minute":{"anyOf":[{"type":"integer","maximum":59.0,"minimum":0.0},{"type":"null"}],"title":"Digest Minute"},"weekdays":{"anyOf":[{"items":{"type":"integer"},"type":"array","minItems":1},{"type":"null"}],"title":"Weekdays"},"max_digests_per_day":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":1.0},{"type":"null"}],"title":"Max Digests Per Day"}},"type":"object","title":"NotificationPreferencesUpdateRequest","description":"Patch payload for the consolidated /settings/notifications surface."},"NotificationsMarkReadRequest":{"properties":{"notification_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notification Ids"},"alert_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alert Id"},"watchlist_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Watchlist Id"},"saved_search_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saved Search Id"},"mark_all":{"type":"boolean","title":"Mark All","default":false}},"type":"object","title":"NotificationsMarkReadRequest","description":"Mark a set of notifications read.\n\nProvide ``notification_ids`` to target specific rows, or set\n``mark_all=True`` (with optional ``alert_id``) to mark a wider set.\n``watchlist_id`` marks every notification under one inbox folder\n(legislative + saved-search hits + share invites). ``saved_search_id``\ntargets only the synthetic Saved-searches folder."},"NotificationsMarkReadResponse":{"properties":{"marked":{"type":"integer","title":"Marked"}},"type":"object","required":["marked"],"title":"NotificationsMarkReadResponse","description":"Count of notifications that flipped unread→read."},"OAuthSignupConfirmRequest":{"properties":{"signup":{"type":"string","pattern":"^os_[A-Za-z0-9_-]{43}$","title":"Signup"},"code":{"type":"string","pattern":"^\\d{6}$","title":"Code"}},"additionalProperties":false,"type":"object","required":["signup","code"],"title":"OAuthSignupConfirmRequest","description":"The 6-digit code emailed to the address of a provider sign-up."},"OAuthSignupPendingRequest":{"properties":{"signup":{"type":"string","pattern":"^os_[A-Za-z0-9_-]{43}$","title":"Signup"}},"additionalProperties":false,"type":"object","required":["signup"],"title":"OAuthSignupPendingRequest","description":"The ``os_`` challenge of a Google or Microsoft sign-up, to read its prefill."},"OAuthSignupRequest":{"properties":{"signup":{"type":"string","pattern":"^os_[A-Za-z0-9_-]{43}$","title":"Signup"},"first_name":{"type":"string","maxLength":100,"minLength":1,"title":"First Name"},"last_name":{"type":"string","maxLength":100,"minLength":1,"title":"Last Name"},"organization_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Organization Name"},"selected_plan":{"anyOf":[{"type":"string","enum":["explorer","team","pro","business","research"]},{"type":"string","const":"enterprise"}],"title":"Selected Plan"},"access_invite":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Access Invite"},"research":{"anyOf":[{"$ref":"#/components/schemas/ResearchApplicationPayload"},{"type":"null"}]},"billing_currency":{"anyOf":[{"type":"string","enum":["eur","usd"]},{"type":"null"}],"title":"Billing Currency"},"default_jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Jurisdiction","default":"US"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","default":"UTC"},"terms_accepted":{"type":"boolean","title":"Terms Accepted","default":false},"privacy_accepted":{"type":"boolean","title":"Privacy Accepted","default":false},"consent_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consent Version"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"additionalProperties":false,"type":"object","required":["signup","first_name","last_name","selected_plan"],"title":"OAuthSignupRequest","description":"Finish a Google or Microsoft sign-up: what the provider cannot tell us.\n\nThe address and the identity come from the ``os_`` challenge; the name\nis prefilled from the provider and may be edited. No password and no\ninvite (invited people sign up with their email, then connect)."},"OnboardingTopicsIn":{"properties":{"topics":{"items":{"type":"string"},"type":"array","maxItems":12,"minItems":1,"title":"Topics"}},"additionalProperties":false,"type":"object","required":["topics"],"title":"OnboardingTopicsIn"},"OrgJurisdictionSelectionRequest":{"properties":{"jurisdictions":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Jurisdictions"}},"type":"object","required":["jurisdictions"],"title":"OrgJurisdictionSelectionRequest","description":"Payload for selecting additional entitled jurisdictions."},"OrgJurisdictionSelectionResult":{"properties":{"slots":{"type":"integer","title":"Slots"},"used":{"type":"integer","title":"Used"},"jurisdictions":{"items":{"$ref":"#/components/schemas/JurisdictionItem"},"type":"array","title":"Jurisdictions"},"included":{"items":{"type":"string"},"type":"array","title":"Included","default":[]},"pending_downgrade":{"anyOf":[{"$ref":"#/components/schemas/PendingDowngrade"},{"type":"null"}]},"choice_slots":{"type":"integer","title":"Choice Slots","default":0},"pending":{"anyOf":[{"$ref":"#/components/schemas/PendingJurisdictionSelection"},{"type":"null"}]},"can_edit":{"type":"boolean","title":"Can Edit","default":false},"change_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Mode"},"renews_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Renews At"},"added_now":{"items":{"type":"string"},"type":"array","title":"Added Now","default":[]},"removed_now":{"items":{"type":"string"},"type":"array","title":"Removed Now","default":[]}},"type":"object","required":["slots","used","jurisdictions"],"title":"OrgJurisdictionSelectionResult","description":"Selection update result: what applied now, plus the refreshed state."},"OrgJurisdictionSelectionUpdate":{"properties":{"jurisdictions":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Jurisdictions"}},"type":"object","title":"OrgJurisdictionSelectionUpdate","description":"The full desired list of chosen jurisdictions (included ones are implicit)."},"OrgJurisdictionsResponse":{"properties":{"slots":{"type":"integer","title":"Slots"},"used":{"type":"integer","title":"Used"},"jurisdictions":{"items":{"$ref":"#/components/schemas/JurisdictionItem"},"type":"array","title":"Jurisdictions"},"included":{"items":{"type":"string"},"type":"array","title":"Included","default":[]},"pending_downgrade":{"anyOf":[{"$ref":"#/components/schemas/PendingDowngrade"},{"type":"null"}]},"choice_slots":{"type":"integer","title":"Choice Slots","default":0},"pending":{"anyOf":[{"$ref":"#/components/schemas/PendingJurisdictionSelection"},{"type":"null"}]},"can_edit":{"type":"boolean","title":"Can Edit","default":false},"change_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Mode"},"renews_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Renews At"}},"type":"object","required":["slots","used","jurisdictions"],"title":"OrgJurisdictionsResponse","description":"Response model for entitlement slots and selected jurisdictions."},"OrgSummaryResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"tier":{"type":"string","title":"Tier"},"member_count":{"type":"integer","title":"Member Count"},"pending_invite_count":{"type":"integer","title":"Pending Invite Count","default":0},"seats_used":{"type":"integer","title":"Seats Used","default":0},"seats_total":{"type":"integer","title":"Seats Total"},"seats_unlimited":{"type":"boolean","title":"Seats Unlimited","default":false},"created_at":{"type":"string","title":"Created At"},"workspace_kind":{"type":"string","enum":["personal","team"],"title":"Workspace Kind"}},"type":"object","required":["id","name","tier","member_count","seats_total","created_at","workspace_kind"],"title":"OrgSummaryResponse"},"OrgTierChangeRequest":{"properties":{"target_tier":{"type":"string","enum":["explorer","team","pro","business"],"title":"Target Tier"},"jurisdictions":{"anyOf":[{"items":{"type":"string"},"type":"array","minItems":1},{"type":"null"}],"title":"Jurisdictions"}},"type":"object","required":["target_tier"],"title":"OrgTierChangeRequest","description":"Payload for entitlement tier upgrades or downgrades."},"OrgUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"}},"type":"object","title":"OrgUpdateRequest"},"OrganizationResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"subscription_tier":{"type":"string","title":"Subscription Tier"},"user_limit":{"type":"integer","title":"User Limit"},"keyword_limit":{"type":"integer","title":"Keyword Limit"},"default_jurisdiction":{"type":"string","title":"Default Jurisdiction"},"subscription_status":{"type":"string","title":"Subscription Status"},"workspace_kind":{"type":"string","enum":["personal","team"],"title":"Workspace Kind"}},"type":"object","required":["id","name","subscription_tier","user_limit","keyword_limit","default_jurisdiction","subscription_status","workspace_kind"],"title":"OrganizationResponse","description":"Organization details embedded in auth and profile responses."},"OrganizationSecurityUpdate":{"properties":{"require_mfa":{"type":"boolean","title":"Require Mfa"}},"additionalProperties":false,"type":"object","required":["require_mfa"],"title":"OrganizationSecurityUpdate"},"PacketValidation":{"properties":{"packet_id":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$","title":"Packet Id"},"digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Digest"},"require_reviewed":{"type":"boolean","title":"Require Reviewed","default":false}},"type":"object","required":["packet_id","digest"],"title":"PacketValidation"},"PaginationOut":{"properties":{"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"total":{"type":"integer","title":"Total"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["page","per_page","total","pages"],"title":"PaginationOut"},"PartyAlignmentEntry":{"properties":{"party_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party Id"},"party_name":{"type":"string","title":"Party Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"color_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color Code"},"alignment_pct":{"type":"number","title":"Alignment Pct"},"shared_votes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shared Votes"}},"type":"object","required":["party_name","alignment_pct"],"title":"PartyAlignmentEntry","description":"Voting alignment between this party and another party.\n\n``alignment_pct``: % of shared votes on which both parties' majorities\nvoted the same way. ``shared_votes``: votes on which both parties took a\nposition (absent on rows computed before 2026-10-13)."},"PartyAreaAlignment":{"properties":{"area":{"type":"string","title":"Area"},"shared_votes":{"type":"integer","title":"Shared Votes"},"agreed_votes":{"type":"integer","title":"Agreed Votes"},"alignment_pct":{"type":"number","title":"Alignment Pct"}},"type":"object","required":["area","shared_votes","agreed_votes","alignment_pct"],"title":"PartyAreaAlignment","description":"Agreement with one partner party on votes about one policy area."},"PartyAreaComparison":{"properties":{"basis":{"type":"string","title":"Basis"},"min_votes":{"type":"integer","title":"Min Votes"},"votes_total":{"type":"integer","title":"Votes Total","default":0},"votes_with_area":{"type":"integer","title":"Votes With Area","default":0},"partners":{"items":{"$ref":"#/components/schemas/PartyComparisonPartner"},"type":"array","title":"Partners"}},"type":"object","required":["basis","min_votes"],"title":"PartyAreaComparison","description":"Where the party agrees and disagrees with its largest partners.\n\n``basis`` is ``member_votes`` (positions = members' majority) or\n``group_votes`` (positions = per-faction records, Tweede Kamer).\n``votes_total`` counts votes on which the party took a position,\n``votes_with_area`` those on a bill with a policy area. Areas with fewer\nthan ``min_votes`` shared votes are too few to compare."},"PartyColorsResponse":{"properties":{"colors":{"additionalProperties":{"type":"string"},"type":"object","title":"Colors"},"names":{"additionalProperties":{"type":"string"},"type":"object","title":"Names"}},"type":"object","required":["colors","names"],"title":"PartyColorsResponse","description":"Map of party key → hex color for pie chart rendering."},"PartyComparisonPartner":{"properties":{"party_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party Id"},"party_name":{"type":"string","title":"Party Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"color_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color Code"},"shared_votes":{"type":"integer","title":"Shared Votes"},"agreed_votes":{"type":"integer","title":"Agreed Votes"},"alignment_pct":{"type":"number","title":"Alignment Pct"},"areas":{"items":{"$ref":"#/components/schemas/PartyAreaAlignment"},"type":"array","title":"Areas"}},"type":"object","required":["party_name","shared_votes","agreed_votes","alignment_pct"],"title":"PartyComparisonPartner","description":"A partner party with its overall and per-policy-area agreement."},"PartyDissent":{"properties":{"status":{"type":"string","title":"Status"},"min_decided":{"type":"integer","title":"Min Decided"},"members_assessed":{"type":"integer","title":"Members Assessed","default":0},"members_with_dissent":{"type":"integer","title":"Members With Dissent","default":0},"party_line_votes":{"type":"integer","title":"Party Line Votes","default":0},"members":{"items":{"$ref":"#/components/schemas/PartyDissenter"},"type":"array","title":"Members"}},"type":"object","required":["status","min_decided"],"title":"PartyDissent","description":"Members ranked by % of decided votes cast against the party majority.\n\n``status``: ``ok``; ``group_votes`` (votes recorded per party, so\nindividual dissent does not exist); ``unaffiliated`` (no shared party\nline); ``no_votes``. ``decided`` counts a member's votes on which the\nparty had a clear line; members need ``min_decided`` of them to be ranked."},"PartyDissenter":{"properties":{"legislator_id":{"type":"string","title":"Legislator Id"},"name":{"type":"string","title":"Name"},"against":{"type":"integer","title":"Against"},"decided":{"type":"integer","title":"Decided"},"against_pct":{"type":"number","title":"Against Pct"}},"type":"object","required":["legislator_id","name","against","decided","against_pct"],"title":"PartyDissenter","description":"A member's votes against the party majority."},"PartyLeadershipEntry":{"properties":{"name":{"type":"string","title":"Name"},"qid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qid"},"role":{"type":"string","title":"Role"},"legislator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legislator Id"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"verified_at":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Verified At"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["name","role"],"title":"PartyLeadershipEntry","description":"A current leadership office, independent of parliamentary membership.\n\n``legislator_id`` is optional: a party chair need not hold a seat in the\nparliament. Party and parliamentary-group leadership have distinct roles."},"PartyMembershipEntry":{"properties":{"legislator_id":{"type":"string","title":"Legislator Id"},"legislator_name":{"type":"string","title":"Legislator Name"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"membership_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Membership Role"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["legislator_id","legislator_name"],"title":"PartyMembershipEntry","description":"Legislator membership history entry for a political party."},"PartyStats":{"properties":{"current_members":{"type":"integer","title":"Current Members","default":0},"vote_count":{"type":"integer","title":"Vote Count","default":0},"discipline_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Discipline Pct"},"chamber_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Chamber Share Pct"},"alignment":{"items":{"$ref":"#/components/schemas/PartyAlignmentEntry"},"type":"array","title":"Alignment"},"area_alignment":{"anyOf":[{"$ref":"#/components/schemas/PartyAreaComparison"},{"type":"null"}]},"dissenters":{"anyOf":[{"$ref":"#/components/schemas/PartyDissent"},{"type":"null"}]}},"type":"object","title":"PartyStats","description":"Aggregated voting statistics for a party.\n\n``area_alignment`` and ``dissenters`` are ``None`` until the precompute\nhas covered this party and term."},"PasskeyRegisterRequest":{"properties":{"challenge":{"type":"string","maxLength":64,"title":"Challenge"},"credential":{"additionalProperties":true,"type":"object","title":"Credential"},"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"}},"additionalProperties":false,"type":"object","required":["challenge","credential"],"title":"PasskeyRegisterRequest"},"PasskeyRenameRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"}},"additionalProperties":false,"type":"object","required":["name"],"title":"PasskeyRenameRequest"},"PasskeySignInRequest":{"properties":{"challenge":{"type":"string","maxLength":64,"title":"Challenge"},"credential":{"additionalProperties":true,"type":"object","title":"Credential"},"remember":{"type":"boolean","title":"Remember","default":false}},"additionalProperties":false,"type":"object","required":["challenge","credential"],"title":"PasskeySignInRequest"},"PasswordLoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","maxLength":1024,"minLength":1,"title":"Password"},"remember":{"type":"boolean","title":"Remember","default":false}},"additionalProperties":false,"type":"object","required":["email","password"],"title":"PasswordLoginRequest"},"PasswordResetRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["email"],"title":"PasswordResetRequest","description":"Payload for initiating password reset by email."},"PendingDowngrade":{"properties":{"target_tier":{"type":"string","title":"Target Tier"},"effective_at":{"type":"string","format":"date-time","title":"Effective At"},"jurisdictions":{"items":{"$ref":"#/components/schemas/JurisdictionItem"},"type":"array","title":"Jurisdictions"}},"type":"object","required":["target_tier","effective_at","jurisdictions"],"title":"PendingDowngrade","description":"Scheduled downgrade metadata and target jurisdictions."},"PendingJurisdictionSelection":{"properties":{"codes":{"items":{"type":"string"},"type":"array","title":"Codes"},"jurisdictions":{"items":{"$ref":"#/components/schemas/JurisdictionItem"},"type":"array","title":"Jurisdictions"},"effective_at":{"type":"string","format":"date-time","title":"Effective At"}},"type":"object","required":["codes","jurisdictions","effective_at"],"title":"PendingJurisdictionSelection","description":"A swap or removal scheduled for renewal; current access is unchanged until then."},"PeopleListResponse":{"properties":{"people":{"items":{"$ref":"#/components/schemas/PersonSummary"},"type":"array","title":"People"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"}},"type":"object","required":["people","pagination"],"title":"PeopleListResponse","description":"Paginated response for the people directory."},"PersonCommitteeMembershipEntry":{"properties":{"committee_id":{"type":"string","title":"Committee Id"},"committee_name":{"type":"string","title":"Committee Name"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"membership_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Membership Role"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"term_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Term Number"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["committee_id","committee_name"],"title":"PersonCommitteeMembershipEntry","description":"Committee membership entry for a person's committee history."},"PersonDetail":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"source_system":{"type":"string","title":"Source System"},"source_person_id":{"type":"string","title":"Source Person Id"},"source_person_ids":{"items":{"type":"string"},"type":"array","title":"Source Person Ids"},"bioguide_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bioguide Id"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"middle_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Middle Name"},"last_name":{"type":"string","title":"Last Name"},"full_name":{"type":"string","title":"Full Name"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"district":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"District"},"current_member":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Current Member"},"office_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office Address"},"office_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office City"},"office_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office State"},"office_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office Zip"},"office_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office Phone"},"official_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Official Url"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"party_memberships":{"items":{"$ref":"#/components/schemas/PersonPartyHistoryEntry"},"type":"array","title":"Party Memberships"},"committee_memberships":{"items":{"$ref":"#/components/schemas/PersonCommitteeMembershipEntry"},"type":"array","title":"Committee Memberships"},"current_regions":{"items":{"$ref":"#/components/schemas/RegionSummary"},"type":"array","title":"Current Regions"},"sponsored_items_total":{"type":"integer","title":"Sponsored Items Total","default":0},"vote_records_total":{"type":"integer","title":"Vote Records Total","default":0}},"type":"object","required":["id","jurisdiction","source_system","source_person_id","last_name","full_name"],"title":"PersonDetail","description":"Full person profile with all columns and related memberships."},"PersonDetailResponse":{"properties":{"person":{"$ref":"#/components/schemas/PersonDetail"}},"type":"object","required":["person"],"title":"PersonDetailResponse","description":"Response model wrapping a single person profile."},"PersonPartyHistoryEntry":{"properties":{"party_id":{"type":"string","title":"Party Id"},"party_name":{"type":"string","title":"Party Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"color_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color Code"},"party_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party Type"},"membership_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Membership Role"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["party_id","party_name"],"title":"PersonPartyHistoryEntry","description":"Party membership entry for a person's party history."},"PersonPartyHistoryResponse":{"properties":{"actor":{"$ref":"#/components/schemas/ActorProfile"},"party_memberships":{"items":{"$ref":"#/components/schemas/PersonPartyHistoryEntry"},"type":"array","title":"Party Memberships"}},"type":"object","required":["actor"],"title":"PersonPartyHistoryResponse","description":"Response model for a person's party history."},"PersonRegionHistoryEntry":{"properties":{"region_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region Id"},"region_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region Name"},"region_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region Type"},"region_external_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region External Code"},"parent_region_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Region Id"},"parent_region_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Region Name"},"relationship_type":{"type":"string","title":"Relationship Type","default":"represents"},"mandate_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mandate Type"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"is_current":{"type":"boolean","title":"Is Current","default":true},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"PersonRegionHistoryEntry","description":"Region representation entry for a person's region history."},"PersonRegionHistoryResponse":{"properties":{"actor":{"$ref":"#/components/schemas/ActorProfile"},"region_memberships":{"items":{"$ref":"#/components/schemas/PersonRegionHistoryEntry"},"type":"array","title":"Region Memberships"}},"type":"object","required":["actor"],"title":"PersonRegionHistoryResponse","description":"Response model for a person's region representation history."},"PersonSummary":{"properties":{"id":{"type":"string","title":"Id"},"full_name":{"type":"string","title":"Full Name"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"type":"string","title":"Last Name"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"party_abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party Abbreviation"},"party_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party Color"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"current_member":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Current Member"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"sponsored_items_total":{"type":"integer","title":"Sponsored Items Total","default":0},"vote_records_total":{"type":"integer","title":"Vote Records Total","default":0}},"type":"object","required":["id","full_name","last_name","jurisdiction_code"],"title":"PersonSummary","description":"Lightweight person record for directory listing."},"PersonTopicBreakdownResponse":{"properties":{"actor":{"$ref":"#/components/schemas/ActorProfile"},"topics":{"items":{"$ref":"#/components/schemas/PersonTopicBreakdownRow"},"type":"array","title":"Topics"},"total_votes":{"type":"integer","title":"Total Votes","default":0},"topics_covered":{"type":"integer","title":"Topics Covered","default":0}},"type":"object","required":["actor"],"title":"PersonTopicBreakdownResponse","description":"Per-topic engagement + voting behaviour for one politician."},"PersonTopicBreakdownRow":{"properties":{"topic":{"type":"string","title":"Topic"},"bills_sponsored":{"type":"integer","title":"Bills Sponsored","default":0},"bills_cosponsored":{"type":"integer","title":"Bills Cosponsored","default":0},"engagement":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Engagement"},"votes":{"type":"integer","title":"Votes","default":0},"yes":{"type":"integer","title":"Yes","default":0},"no":{"type":"integer","title":"No","default":0},"with_party":{"type":"integer","title":"With Party","default":0},"against_party":{"type":"integer","title":"Against Party","default":0}},"type":"object","required":["topic"],"title":"PersonTopicBreakdownRow","description":"How one politician engages with, and votes on, a single topic."},"PersonVoteRecord":{"properties":{"record_kind":{"type":"string","const":"person","title":"Record Kind","default":"person"},"source_person_id":{"type":"string","title":"Source Person Id"},"legislator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legislator Id"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Party"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"vote_choice":{"type":"string","enum":["YES","NO","ABSTAIN","NOT_VOTING","UNKNOWN"],"title":"Vote Choice"},"source_vote_choice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Vote Choice"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["source_person_id","vote_choice"],"title":"PersonVoteRecord","description":"Per-person vote record row."},"PersonVoteSummaryResponse":{"properties":{"actor":{"$ref":"#/components/schemas/ActorProfile"},"total":{"type":"integer","title":"Total","default":0},"yes":{"type":"integer","title":"Yes","default":0},"no":{"type":"integer","title":"No","default":0},"abstain":{"type":"integer","title":"Abstain","default":0},"not_voting":{"type":"integer","title":"Not Voting","default":0},"non_binary":{"type":"integer","title":"Non Binary","default":0},"unknown":{"type":"integer","title":"Unknown","default":0},"binary_total":{"type":"integer","title":"Binary Total","default":0}},"type":"object","required":["actor"],"title":"PersonVoteSummaryResponse","description":"Aggregated vote choice counts for a person."},"PlatformAdminAuthResponse":{"properties":{"admin":{"$ref":"#/components/schemas/PlatformAdminResponse"},"token":{"type":"string","title":"Token"}},"type":"object","required":["admin","token"],"title":"PlatformAdminAuthResponse","description":"Auth response for platform admin access tokens."},"PlatformAdminBootstrapRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","minLength":8,"title":"Password"},"first_name":{"type":"string","minLength":1,"title":"First Name"},"last_name":{"type":"string","minLength":1,"title":"Last Name"}},"type":"object","required":["email","password","first_name","last_name"],"title":"PlatformAdminBootstrapRequest","description":"One-time bootstrap payload for initial platform admin creation."},"PlatformAdminLoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"PlatformAdminLoginRequest","description":"Credentials payload for platform admin login."},"PlatformAdminResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"is_active":{"type":"boolean","title":"Is Active"},"last_login_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Login At"}},"type":"object","required":["id","email","is_active"],"title":"PlatformAdminResponse","description":"Platform admin profile used in control-plane auth responses."},"PrivacyChoicesUpdateRequest":{"properties":{"product_analytics":{"$ref":"#/components/schemas/ProductAnalyticsChoiceRequest"}},"additionalProperties":false,"type":"object","required":["product_analytics"],"title":"PrivacyChoicesUpdateRequest"},"ProductAnalyticsChoiceRequest":{"properties":{"choice":{"type":"string","enum":["enabled","disabled"],"title":"Choice"},"consent_version":{"type":"string","maxLength":20,"pattern":"^\\d{4}-\\d{2}-\\d{2}(\\.\\d{1,3})?$","title":"Consent Version"}},"additionalProperties":false,"type":"object","required":["choice","consent_version"],"title":"ProductAnalyticsChoiceRequest","description":"An explicit choice about optional product analytics, made while signed in."},"ProductCapabilityBulkReview":{"properties":{"expected_revisions":{"additionalProperties":{"type":"integer"},"propertyNames":{"format":"uuid"},"type":"object","maxProperties":200,"title":"Expected Revisions"},"capability_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":200,"minItems":1,"title":"Capability Ids"},"review_state":{"type":"string","enum":["approved","rejected"],"title":"Review State"}},"type":"object","required":["capability_ids","review_state"],"title":"ProductCapabilityBulkReview"},"ProductCapabilityInput":{"properties":{"expected_revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Expected Revision"},"capability_key":{"type":"string","maxLength":120,"minLength":3,"pattern":"^[a-z0-9_.:-]+$","title":"Capability Key"},"label":{"type":"string","maxLength":240,"minLength":3,"title":"Label"},"description":{"type":"string","maxLength":8000,"minLength":10,"title":"Description"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Jurisdiction Codes"},"access":{"additionalProperties":true,"type":"object","title":"Access"},"limitations":{"type":"string","maxLength":8000,"title":"Limitations","default":""},"evidence":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":50,"title":"Evidence"}},"type":"object","required":["capability_key","label","description"],"title":"ProductCapabilityInput"},"ProductCapabilityReview":{"properties":{"expected_revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Expected Revision"},"review_state":{"type":"string","enum":["approved","rejected"],"title":"Review State"}},"type":"object","required":["review_state"],"title":"ProductCapabilityReview"},"ProductCapabilitySelection":{"properties":{"template_id":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Template Id"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Jurisdiction Codes"},"selected_capability_keys":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Selected Capability Keys"},"brief":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":50,"title":"Brief"},"original_contribution":{"anyOf":[{"type":"string","maxLength":8000},{"type":"null"}],"title":"Original Contribution"}},"type":"object","title":"ProductCapabilitySelection"},"ProductStoryContext":{"properties":{"story_id":{"type":"string","format":"uuid","title":"Story Id"},"title":{"type":"string","maxLength":240,"minLength":1,"title":"Title"},"brief":{"type":"string","maxLength":8000,"title":"Brief","default":""},"original_contribution":{"type":"string","maxLength":8000,"title":"Original Contribution","default":""},"canonical_locale":{"type":"string","enum":["en","pl","nl"],"title":"Canonical Locale"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Jurisdiction Codes"},"selected_capability_keys":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Selected Capability Keys"},"capability_digest":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Capability Digest"}},"additionalProperties":false,"type":"object","required":["story_id","title","canonical_locale"],"title":"ProductStoryContext"},"ProfileUpdateRequest":{"properties":{"first_name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Last Name"},"timezone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Timezone"}},"type":"object","title":"ProfileUpdateRequest","description":"Patch payload for the authenticated user's profile fields.\n\nUpdates the parts of the user record that teammates see — the\n\"identity\" half of the profile/settings split. Per-user preferences\n(digest schedule, theme, etc.) live behind separate endpoints so we\ncan evolve them independently without touching identity rows."},"ProposalRequest":{"properties":{"proposal_id":{"type":"string","format":"uuid","title":"Proposal Id"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"story_id":{"type":"string","format":"uuid","title":"Story Id"},"python_piece_id":{"type":"string","format":"uuid","title":"Python Piece Id"},"locale":{"type":"string","enum":["en","pl","nl"],"title":"Locale"},"base_version_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Base Version Id"},"base_content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Base Content Hash"},"input_fingerprint":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Input Fingerprint"},"task_type":{"type":"string","enum":["article_body","seo"],"title":"Task Type"},"selected_scope":{"additionalProperties":true,"type":"object","title":"Selected Scope"},"source_packet_id":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","title":"Source Packet Id"},"source_packet_digest":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Source Packet Digest"},"capability_digest":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Capability Digest"},"draft_context":{"$ref":"#/components/schemas/DraftContext"}},"additionalProperties":false,"type":"object","required":["proposal_id","article_id","story_id","python_piece_id","locale","base_version_id","base_content_hash","input_fingerprint","task_type","selected_scope","source_packet_id","source_packet_digest","capability_digest","draft_context"],"title":"ProposalRequest"},"PublicCoverageResponse":{"properties":{"tracked_items":{"type":"integer","title":"Tracked Items"},"individual_vote_records":{"type":"integer","title":"Individual Vote Records"},"committees":{"type":"integer","title":"Committees"},"covered_jurisdictions":{"type":"integer","title":"Covered Jurisdictions"},"refreshed_at":{"type":"string","format":"date-time","title":"Refreshed At"}},"type":"object","required":["tracked_items","individual_vote_records","committees","covered_jurisdictions","refreshed_at"],"title":"PublicCoverageResponse"},"QueueLabel":{"type":"string","enum":["sync","match","digest_send","raw","project","bill_text","llm_summarize","llm_summarize_priority"]},"RadarBriefBlock":{"properties":{"days":{"type":"integer","title":"Days"},"total_new":{"type":"integer","title":"Total New"},"profile_count":{"type":"integer","title":"Profile Count"},"profiles":{"items":{"$ref":"#/components/schemas/RadarBriefProfile"},"type":"array","title":"Profiles"}},"type":"object","required":["days","total_new","profile_count"],"title":"RadarBriefBlock","description":"The policy radar card (#1203): EU radar subjects of the last\n``days`` days relevant to the user's watchlists and EU saved searches."},"RadarBriefItem":{"properties":{"subject_kind":{"type":"string","title":"Subject Kind"},"subject_id":{"type":"string","title":"Subject Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"score":{"type":"number","title":"Score"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["subject_kind","subject_id","score"],"title":"RadarBriefItem"},"RadarBriefProfile":{"properties":{"key":{"type":"string","title":"Key"},"kind":{"type":"string","title":"Kind"},"name":{"type":"string","title":"Name"},"new_count":{"type":"integer","title":"New Count"},"items":{"items":{"$ref":"#/components/schemas/RadarBriefItem"},"type":"array","title":"Items"}},"type":"object","required":["key","kind","name","new_count"],"title":"RadarBriefProfile"},"RadarFeedbackRequest":{"properties":{"profile":{"type":"string","maxLength":80,"title":"Profile"},"subject_kind":{"type":"string","enum":["radar_item","initiative","secondary_act"],"title":"Subject Kind"},"subject_id":{"type":"string","maxLength":64,"minLength":1,"title":"Subject Id"},"label":{"anyOf":[{"type":"string","enum":["relevant","not_relevant"]},{"type":"null"}],"title":"Label"}},"type":"object","required":["profile","subject_kind","subject_id","label"],"title":"RadarFeedbackRequest"},"ReauthRequest":{"properties":{"password":{"anyOf":[{"type":"string","maxLength":1024,"minLength":1},{"type":"null"}],"title":"Password"},"code":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Code"},"method":{"type":"string","enum":["totp","recovery_code","passkey"],"title":"Method","default":"totp"},"challenge":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Challenge"},"credential":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Credential"}},"additionalProperties":false,"type":"object","title":"ReauthRequest","description":"``{password, code?, method?}``, or ``{method: \"passkey\", challenge, credential}``.\n\nA passkey assertion (user verification required) is enough on its own."},"RegionDetail":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"region_type":{"type":"string","title":"Region Type"},"external_code":{"type":"string","title":"External Code"},"external_id_source":{"type":"string","title":"External Id Source"},"name":{"type":"string","title":"Name"},"parent_region_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Region Id"},"parent_region_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Region Name"},"children":{"items":{"$ref":"#/components/schemas/RegionSummary"},"type":"array","title":"Children"},"current_members_total":{"type":"integer","title":"Current Members Total","default":0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","jurisdiction_code","region_type","external_code","external_id_source","name"],"title":"RegionDetail","description":"Region detail including parent + children + current member count."},"RegionDetailResponse":{"properties":{"region":{"$ref":"#/components/schemas/RegionDetail"}},"type":"object","required":["region"],"title":"RegionDetailResponse","description":"Response wrapping a single region detail."},"RegionSummary":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction_code":{"type":"string","title":"Jurisdiction Code"},"region_type":{"type":"string","title":"Region Type"},"external_code":{"type":"string","title":"External Code"},"external_id_source":{"type":"string","title":"External Id Source"},"name":{"type":"string","title":"Name"},"parent_region_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Region Id"},"parent_region_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Region Name"}},"type":"object","required":["id","jurisdiction_code","region_type","external_code","external_id_source","name"],"title":"RegionSummary","description":"Lightweight region record for directory listing and embedded use."},"RegionsListResponse":{"properties":{"regions":{"items":{"$ref":"#/components/schemas/RegionSummary"},"type":"array","title":"Regions"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"}},"type":"object","required":["regions","pagination"],"title":"RegionsListResponse","description":"Response for the regions directory list endpoint."},"RelatedBill":{"properties":{"id":{"type":"string","title":"Id"},"source_bill_id":{"type":"string","title":"Source Bill Id"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"item_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Type"},"relationship_type":{"type":"string","title":"Relationship Type"},"identified_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identified By"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"}},"type":"object","required":["id","source_bill_id","title","relationship_type"],"title":"RelatedBill","description":"A legislative item related to the current item (procedural rule, companion, etc)."},"ReminderCreate":{"properties":{"event_id":{"type":"string","title":"Event Id"},"lead_minutes":{"type":"integer","title":"Lead Minutes","default":60}},"type":"object","required":["event_id"],"title":"ReminderCreate"},"ReminderOut":{"properties":{"event_id":{"type":"string","title":"Event Id"},"lead_minutes":{"items":{"type":"integer"},"type":"array","title":"Lead Minutes"}},"type":"object","required":["event_id","lead_minutes"],"title":"ReminderOut"},"RemindersOut":{"properties":{"reminders":{"items":{"$ref":"#/components/schemas/ReminderOut"},"type":"array","title":"Reminders"}},"type":"object","required":["reminders"],"title":"RemindersOut"},"ReportBlockSpec":{"properties":{"type":{"type":"string","maxLength":64,"minLength":1,"title":"Type"},"config":{"additionalProperties":true,"type":"object","title":"Config"}},"type":"object","required":["type"],"title":"ReportBlockSpec","description":"One typed content block on a report.\n\nPhase 3 of the redesign introduced ``sections`` as the content\nprimitive: each block is ``{type, config}`` where ``type`` is a\nregistered assembler name. Adding a new block type is purely\nadditive; existing rows ignore unknown types."},"ReportPreviewArtifact":{"properties":{"token":{"type":"string","title":"Token"},"url":{"type":"string","title":"Url"},"mime":{"type":"string","title":"Mime"}},"type":"object","required":["token","url","mime"],"title":"ReportPreviewArtifact","description":"One short-lived artifact URL surfaced by the preview endpoint."},"ReportPreviewRequest":{"properties":{"formats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Formats","description":"Formats to render (subset of html|pdf|xlsx|csv). When omitted, falls back to the report's default ``export_formats``."}},"type":"object","title":"ReportPreviewRequest","description":"Optional override for which artifacts to render in this preview."},"ReportPreviewResponse":{"properties":{"profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Id"},"profile_name":{"type":"string","title":"Profile Name"},"kind":{"type":"string","title":"Kind"},"summary_line":{"type":"string","title":"Summary Line"},"html":{"type":"string","title":"Html"},"is_empty":{"type":"boolean","title":"Is Empty","default":false},"artifacts":{"additionalProperties":{"$ref":"#/components/schemas/ReportPreviewArtifact"},"type":"object","title":"Artifacts"},"export_truncated":{"type":"boolean","title":"Export Truncated","default":false},"export_row_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Export Row Limit"}},"type":"object","required":["profile_name","kind","summary_line","html"],"title":"ReportPreviewResponse","description":"Preview payload — print-layout HTML plus signed URLs for binary artifacts."},"ResearchApplicationPayload":{"properties":{"institution":{"type":"string","maxLength":255,"minLength":2,"title":"Institution"},"academic_role":{"type":"string","enum":["faculty","phd","postdoc","research_staff","other"],"title":"Academic Role"},"project_description":{"type":"string","maxLength":5000,"minLength":50,"title":"Project Description"},"orcid":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]$"},{"type":"null"}],"title":"Orcid","description":"ORCID iD in 0000-0000-0000-000X form"}},"type":"object","required":["institution","academic_role","project_description"],"title":"ResearchApplicationPayload","description":"Research Access application details submitted with a research signup (#956)."},"ResearchApproveRequest":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"ResearchApproveRequest"},"ResearchContextRequest":{"properties":{"expected_state_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected State Digest"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Jurisdiction Codes"},"selected_capability_keys":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Selected Capability Keys"}},"additionalProperties":false,"type":"object","required":["expected_state_digest","jurisdiction_codes","selected_capability_keys"],"title":"ResearchContextRequest"},"ResearchDecisionNoteRequest":{"properties":{"note":{"type":"string","maxLength":2000,"minLength":1,"title":"Note"}},"type":"object","required":["note"],"title":"ResearchDecisionNoteRequest"},"ResearchEvidenceReviewRequest":{"properties":{"expected_state_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected State Digest"},"evidence_id":{"type":"string","format":"uuid","title":"Evidence Id"},"expected_fingerprint":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected Fingerprint"},"decision":{"type":"string","enum":["approve","reject","pending"],"title":"Decision"},"supports":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Supports"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Jurisdiction Codes"},"rationale":{"type":"string","maxLength":2000,"minLength":10,"title":"Rationale"}},"additionalProperties":false,"type":"object","required":["expected_state_digest","evidence_id","expected_fingerprint","decision","rationale"],"title":"ResearchEvidenceReviewRequest"},"ResearchReviewRequest":{"properties":{"expected_state_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected State Digest"},"expected_run_id":{"type":"string","format":"uuid","title":"Expected Run Id"},"expected_evidence_signature":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected Evidence Signature"}},"additionalProperties":false,"type":"object","required":["expected_state_digest","expected_run_id","expected_evidence_signature"],"title":"ResearchReviewRequest"},"ResearchRunRequest":{"properties":{"expected_state_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected State Digest"},"expected_budget_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected Budget Digest"},"expected_plan_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected Plan Digest"}},"additionalProperties":false,"type":"object","required":["expected_state_digest","expected_budget_digest","expected_plan_digest"],"title":"ResearchRunRequest"},"ResendVerificationRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["email"],"title":"ResendVerificationRequest","description":"Payload for requesting a fresh email verification link."},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","minLength":8,"title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest","description":"Payload for completing password reset with token and new password."},"SavedSearchCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"kind":{"type":"string","maxLength":20,"minLength":1,"title":"Kind"},"jurisdiction_code":{"type":"string","maxLength":8,"minLength":1,"title":"Jurisdiction Code"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"topic_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Topic Label"},"item_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Item Types"},"cadence":{"type":"string","maxLength":16,"title":"Cadence","default":"digest"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"type":"string","enum":["low","normal","high"],"title":"Priority","default":"normal"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","required":["name","kind","jurisdiction_code"],"title":"SavedSearchCreateRequest","description":"Payload for POST /saved-searches."},"SavedSearchResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind"},"jurisdiction_id":{"type":"string","title":"Jurisdiction Id"},"jurisdiction_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction Code"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"topic_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Label"},"item_types":{"items":{"type":"string"},"type":"array","title":"Item Types"},"enabled":{"type":"boolean","title":"Enabled"},"cadence":{"type":"string","title":"Cadence"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"priority":{"type":"string","enum":["low","normal","high"],"title":"Priority","default":"normal"},"snoozed_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Snoozed Until"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","kind","jurisdiction_id","enabled","cadence","created_at","updated_at"],"title":"SavedSearchResponse","description":"One saved-search row in the API."},"SavedSearchUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"kind":{"anyOf":[{"type":"string","maxLength":20,"minLength":1},{"type":"null"}],"title":"Kind"},"jurisdiction_code":{"anyOf":[{"type":"string","maxLength":8,"minLength":1},{"type":"null"}],"title":"Jurisdiction Code"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"topic_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Topic Label"},"item_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Item Types"},"cadence":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Cadence"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high"]},{"type":"null"}],"title":"Priority"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"snoozed_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Snoozed Until"}},"type":"object","title":"SavedSearchUpdateRequest","description":"Partial PATCH — any field may change, including kind and jurisdiction.\n\nOnly keys present in the payload are touched; the service re-validates the\nmerged result against the kind's shape constraints and the org's\njurisdiction entitlements."},"SavedSearchesResponse":{"properties":{"saved_searches":{"items":{"$ref":"#/components/schemas/SavedSearchResponse"},"type":"array","title":"Saved Searches"}},"type":"object","required":["saved_searches"],"title":"SavedSearchesResponse","description":"List wrapper."},"SearchAlertIn":{"properties":{"q":{"type":"string","maxLength":200,"minLength":2,"title":"Q"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Jurisdiction"}},"type":"object","required":["q"],"title":"SearchAlertIn"},"SearchCompleteResponse":{"properties":{"history":{"items":{"$ref":"#/components/schemas/HistoryEntry"},"type":"array","title":"History"},"completions":{"items":{"$ref":"#/components/schemas/Completion"},"type":"array","title":"Completions"},"entities":{"items":{"$ref":"#/components/schemas/EntityMatch"},"type":"array","title":"Entities"}},"type":"object","required":["history","completions","entities"],"title":"SearchCompleteResponse"},"SearchEvent":{"properties":{"event_type":{"type":"string","const":"search","title":"Event Type"},"query":{"type":"string","maxLength":200,"minLength":2,"title":"Query"},"scope":{"type":"string","enum":["all","legislation","documents","votes","people","committees","organizations","parties","calendar"],"title":"Scope","default":"all"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Jurisdiction"},"term_id":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Term Id"},"result_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Result Count"},"surface":{"type":"string","enum":["search_page","explore","command_palette","discovery","detail"],"title":"Surface","default":"search_page"}},"type":"object","required":["event_type","query"],"title":"SearchEvent"},"SearchResultsResponse":{"properties":{"query":{"type":"string","title":"Query"},"resolved_query":{"type":"string","title":"Resolved Query"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"also_jurisdictions":{"items":{"type":"string"},"type":"array","title":"Also Jurisdictions"},"mentions":{"items":{"type":"string"},"type":"array","title":"Mentions"},"scope":{"type":"string","enum":["all","legislation","documents","votes","people","committees","organizations","parties","calendar"],"title":"Scope"},"results":{"items":{"$ref":"#/components/schemas/SearchSuggestion"},"type":"array","title":"Results"},"pagination":{"additionalProperties":{"type":"integer"},"type":"object","title":"Pagination"},"did_you_mean":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Did You Mean"},"corrected_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corrected Query"},"outside_jurisdictions":{"items":{"type":"string"},"type":"array","title":"Outside Jurisdictions"},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"},"counts_capped":{"type":"boolean","title":"Counts Capped","default":false},"expansions":{"items":{"type":"string"},"type":"array","title":"Expansions"},"languages":{"items":{"type":"string"},"type":"array","title":"Languages"},"interpreted":{"additionalProperties":true,"type":"object","title":"Interpreted"},"mode":{"type":"string","title":"Mode"},"expansion_pending":{"type":"boolean","title":"Expansion Pending","default":false}},"type":"object","required":["query","resolved_query","jurisdictions","scope","results","pagination","mode"],"title":"SearchResultsResponse"},"SearchSuggestResponse":{"properties":{"query":{"type":"string","title":"Query"},"suggestions":{"items":{"$ref":"#/components/schemas/SearchSuggestion"},"type":"array","title":"Suggestions"},"did_you_mean":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Did You Mean"},"corrected_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corrected Query"},"resolved_query":{"type":"string","title":"Resolved Query","default":""},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"also_jurisdictions":{"items":{"type":"string"},"type":"array","title":"Also Jurisdictions"},"mentions":{"items":{"type":"string"},"type":"array","title":"Mentions"},"outside_jurisdictions":{"items":{"type":"string"},"type":"array","title":"Outside Jurisdictions"},"expansions":{"items":{"type":"string"},"type":"array","title":"Expansions"}},"type":"object","required":["query","suggestions"],"title":"SearchSuggestResponse"},"SearchSuggestion":{"properties":{"type":{"type":"string","title":"Type"},"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"sublabel":{"type":"string","title":"Sublabel"},"extra":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra"}},"type":"object","required":["type","id","label","sublabel"],"title":"SearchSuggestion"},"SecondaryAct":{"properties":{"id":{"type":"integer","title":"Id"},"kind":{"type":"string","title":"Kind"},"status":{"type":"string","title":"Status"},"status_raw":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Raw"},"status_source":{"type":"string","title":"Status Source"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"short_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"act_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Act Type"},"c_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C Number"},"celex":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Celex"},"basic_act_celex":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basic Act Celex"},"adoption_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Adoption Date"},"adoption_date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Adoption Date Precision"},"adoption_date_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Adoption Date Source"},"planned_adoption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planned Adoption"},"publication_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Publication Date"},"urgent":{"type":"boolean","title":"Urgent","default":false},"policy_area":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Area"},"feedback_ares":{"items":{"type":"string"},"type":"array","title":"Feedback Ares"},"scrutiny":{"items":{"$ref":"#/components/schemas/SecondaryActScrutiny"},"type":"array","title":"Scrutiny"},"opinion":{"anyOf":[{"$ref":"#/components/schemas/SecondaryActOpinion"},{"type":"null"}]},"objections":{"items":{"$ref":"#/components/schemas/SecondaryActEvent"},"type":"array","title":"Objections"},"events":{"items":{"$ref":"#/components/schemas/SecondaryActEvent"},"type":"array","title":"Events"},"ep_scrutiny":{"anyOf":[{"$ref":"#/components/schemas/SecondaryActScrutinyItem"},{"type":"null"}]},"sources":{"items":{"type":"string"},"type":"array","title":"Sources"},"links":{"$ref":"#/components/schemas/SecondaryActLinks"}},"type":"object","required":["id","kind","status","status_source"],"title":"SecondaryAct","description":"A delegated (DA), implementing (IA) or RPS act (#1200)."},"SecondaryActEvent":{"properties":{"type":{"type":"string","title":"Type"},"event_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Event Date"},"institution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Institution"},"source":{"type":"string","title":"Source"},"raw_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Type"},"detail":{"additionalProperties":true,"type":"object","title":"Detail"}},"type":"object","required":["type","source"],"title":"SecondaryActEvent"},"SecondaryActLinks":{"properties":{"regdel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Regdel"},"eurlex":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eurlex"},"comitology":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comitology"}},"type":"object","title":"SecondaryActLinks"},"SecondaryActOpinion":{"properties":{"opinion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opinion"},"document":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document"},"voting_sheet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voting Sheet"},"vote_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Vote Date"},"committee_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Committee Code"},"procedure":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedure"},"draft_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Status"},"link_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Method"},"link_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Link Confidence"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"SecondaryActOpinion","description":"Comitology committee opinion on the act's draft (voting sheet)."},"SecondaryActScrutiny":{"properties":{"institution":{"type":"string","title":"Institution"},"months":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Months"},"extension_months":{"type":"number","title":"Extension Months","default":0},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"start_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Basis"},"deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Deadline"},"deadline_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deadline Source"},"error_band_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Error Band Days"},"status":{"type":"string","title":"Status"},"outcome_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Outcome Date"}},"type":"object","required":["institution","status"],"title":"SecondaryActScrutiny","description":"Scrutiny period of a delegated act for one institution (#1200).\n\n``deadline_source`` is ``register`` once the register publishes the end of\nscrutiny, otherwise ``estimated`` with ``error_band_days`` (3 with the EP\nprocedure file's start date, 7 otherwise; 60 without deadline rows)."},"SecondaryActScrutinyItem":{"properties":{"procedure":{"type":"string","title":"Procedure"},"reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"link_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Method"},"link_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Link Confidence"}},"type":"object","required":["procedure"],"title":"SecondaryActScrutinyItem","description":"The EP DEA/RPS procedure scrutinising the act."},"SecondaryBasicAct":{"properties":{"celex":{"type":"string","title":"Celex"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"act_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Act Type"},"procedure_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedure Reference"},"default_scrutiny_months":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Scrutiny Months"},"empowerment_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Empowerment Period"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["celex"],"title":"SecondaryBasicAct"},"SecondaryLegislationCounts":{"properties":{"by_kind":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Kind"},"by_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Status"}},"type":"object","title":"SecondaryLegislationCounts"},"SecondaryOtherAct":{"properties":{"celex":{"type":"string","title":"Celex"},"doc_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type"},"doc_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Doc Date"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["celex"],"title":"SecondaryOtherAct","description":"A Cellar act based on the basic act that no register lists."},"SessionMfaRequest":{"properties":{"method":{"type":"string","enum":["totp","recovery_code","passkey"],"title":"Method","default":"totp"},"code":{"anyOf":[{"type":"string","maxLength":32,"minLength":1},{"type":"null"}],"title":"Code"},"challenge":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Challenge"},"credential":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Credential"}},"additionalProperties":false,"type":"object","title":"SessionMfaRequest","description":"``{method, code}``, or ``{method: \"passkey\", challenge, credential}``."},"SignupRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","minLength":8,"title":"Password"},"first_name":{"type":"string","minLength":1,"title":"First Name"},"last_name":{"type":"string","minLength":1,"title":"Last Name"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"invite_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invite Token"},"selected_plan":{"anyOf":[{"type":"string","enum":["explorer","team","pro","business","research"]},{"type":"string","const":"enterprise"},{"type":"null"}],"title":"Selected Plan"},"access_invite":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Access Invite"},"research":{"anyOf":[{"$ref":"#/components/schemas/ResearchApplicationPayload"},{"type":"null"}]},"billing_currency":{"anyOf":[{"type":"string","enum":["eur","usd"]},{"type":"null"}],"title":"Billing Currency"},"default_jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Jurisdiction","default":"US"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","default":"UTC"},"terms_accepted":{"type":"boolean","title":"Terms Accepted","default":false},"privacy_accepted":{"type":"boolean","title":"Privacy Accepted","default":false},"consent_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consent Version"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["email","password","first_name","last_name"],"title":"SignupRequest","description":"Payload for user signup, org creation, or invite-based onboarding."},"SocialProposalRequest":{"properties":{"proposal_id":{"type":"string","format":"uuid","title":"Proposal Id"},"variant_id":{"type":"string","format":"uuid","title":"Variant Id"},"story_id":{"type":"string","format":"uuid","title":"Story Id"},"locale":{"type":"string","enum":["en","pl","nl"],"title":"Locale"},"platform":{"type":"string","enum":["linkedin","x","instagram"],"title":"Platform"},"format":{"type":"string","enum":["text","image","image_carousel","document","thread"],"title":"Format"},"base_version_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Base Version Id"},"base_content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Base Content Hash"},"input_fingerprint":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Input Fingerprint"},"source_kind":{"type":"string","enum":["product","research"],"title":"Source Kind"},"product_context":{"anyOf":[{"$ref":"#/components/schemas/ProductStoryContext"},{"type":"null"}]},"python_piece_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Python Piece Id"},"source_packet_digest":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Source Packet Digest"},"selected_fields":{"items":{"type":"string","enum":["caption","thread","cta"]},"type":"array","maxItems":3,"minItems":1,"title":"Selected Fields"},"current_content":{"additionalProperties":true,"type":"object","title":"Current Content"},"article_dependency":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Article Dependency"},"instruction":{"type":"string","maxLength":1000,"title":"Instruction","default":""}},"additionalProperties":false,"type":"object","required":["proposal_id","variant_id","story_id","locale","platform","format","base_version_id","base_content_hash","input_fingerprint","source_kind","source_packet_digest","selected_fields","current_content"],"title":"SocialProposalRequest"},"StagedPreviewGrantRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"StagedPreviewGrantRequest","description":"Why the organization gets the preview (kept in the audit log)."},"StudioResearchPieceRequest":{"properties":{"studio_story_id":{"type":"string","format":"uuid","title":"Studio Story Id"},"template_id":{"type":"string","maxLength":80,"minLength":3,"title":"Template Id"},"canonical_locale":{"type":"string","title":"Canonical Locale"},"title":{"type":"string","maxLength":240,"minLength":3,"title":"Title"},"brief":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":20,"title":"Brief"},"original_contribution":{"type":"string","maxLength":8000,"minLength":10,"title":"Original Contribution"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Jurisdiction Codes"},"selected_capability_keys":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Selected Capability Keys"}},"additionalProperties":false,"type":"object","required":["studio_story_id","template_id","canonical_locale","title","original_contribution"],"title":"StudioResearchPieceRequest"},"SubscriptionsResponse":{"properties":{"subscriptions":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Subscriptions"}},"type":"object","required":["subscriptions"],"title":"SubscriptionsResponse"},"TeamMemberResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"role":{"type":"string","enum":["admin","member"],"title":"Role"},"is_owner":{"type":"boolean","title":"Is Owner","default":false},"email_verified":{"type":"boolean","title":"Email Verified"},"is_locked":{"type":"boolean","title":"Is Locked"},"avatar_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Color"},"has_avatar":{"type":"boolean","title":"Has Avatar","default":false},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"created_at":{"type":"string","title":"Created At"},"last_login_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Login At"}},"type":"object","required":["id","email","role","email_verified","is_locked","created_at"],"title":"TeamMemberResponse"},"TeamMembersListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TeamMemberResponse"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"TeamMembersListResponse"},"TelemetryBatch":{"properties":{"events":{"items":{"$ref":"#/components/schemas/TelemetryEvent"},"type":"array","maxItems":25,"title":"Events"}},"type":"object","required":["events"],"title":"TelemetryBatch"},"TelemetryEvent":{"properties":{"event":{"type":"string","maxLength":64,"title":"Event"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["event","timestamp"],"title":"TelemetryEvent"},"TestSlackRequest":{"properties":{"channel":{"type":"string","title":"Channel"}},"type":"object","required":["channel"],"title":"TestSlackRequest"},"TopicLabel":{"properties":{"label":{"type":"string","title":"Label"},"confidence":{"type":"number","title":"Confidence"},"source":{"type":"string","title":"Source"},"model":{"type":"string","title":"Model"},"prompt_version":{"type":"string","title":"Prompt Version"}},"type":"object","required":["label","confidence","source","model","prompt_version"],"title":"TopicLabel","description":"One policy-area label assigned to a bill by the classify pipeline.\n\nMirrors the ``legislative_items.topics`` JSONB array shape produced\nby ``services.llm.tasks.classify_topic.store_classify_result``. The\nfrontend renders the ``label`` as a chip (via a display-name\nlookup in the topics registry) and uses ``confidence`` for\nstyling / ordering. ``source`` distinguishes Congress.gov\nauthoritative rows from LLM-classified ones."},"TopicLabelV1":{"properties":{"label":{"type":"string","title":"Label"},"confidence":{"type":"number","title":"Confidence"}},"additionalProperties":false,"type":"object","required":["label","confidence"],"title":"TopicLabelV1","description":"A single topic label on a legislative item.\n\nExposes only the canonical ``label`` and ``confidence`` score from\nthe LLM classifier. The internal ``model`` name, ``source`` flag,\nand ``prompt_version`` are deliberately stripped — those are\nPoliData's internals and would constrain how we change classifiers\nwithout coordinating with every consumer."},"TopicStatOut":{"properties":{"label":{"type":"string","title":"Label"},"count":{"type":"integer","title":"Count"},"percentage":{"type":"number","title":"Percentage"}},"type":"object","required":["label","count","percentage"],"title":"TopicStatOut"},"TopicStatsOut":{"properties":{"topics":{"items":{"$ref":"#/components/schemas/TopicStatOut"},"type":"array","title":"Topics"},"total_bills":{"type":"integer","title":"Total Bills"},"bills_with_topics":{"type":"integer","title":"Bills With Topics"}},"type":"object","required":["topics","total_bills","bills_with_topics"],"title":"TopicStatsOut"},"TotpConfirmRequest":{"properties":{"code":{"type":"string","maxLength":32,"minLength":1,"title":"Code"}},"additionalProperties":false,"type":"object","required":["code"],"title":"TotpConfirmRequest"},"TransferOwnershipRequest":{"properties":{"new_owner_user_id":{"type":"string","title":"New Owner User Id"},"keep_previous_owner_as_admin":{"type":"boolean","title":"Keep Previous Owner As Admin","default":true}},"type":"object","required":["new_owner_user_id"],"title":"TransferOwnershipRequest"},"TrialOfferResponse":{"properties":{"no_card_trial_days":{"type":"integer","title":"No Card Trial Days"},"card_trial_days":{"type":"integer","title":"Card Trial Days"}},"type":"object","required":["no_card_trial_days","card_trial_days"],"title":"TrialOfferResponse"},"UpcomingEvent":{"properties":{"event_id":{"type":"string","title":"Event Id"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"starts_at":{"type":"string","title":"Starts At"},"all_day":{"type":"boolean","title":"All Day","default":false},"starts_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Starts On"},"kind_key":{"type":"string","title":"Kind Key"},"jurisdiction":{"type":"string","title":"Jurisdiction"}},"type":"object","required":["event_id","starts_at","kind_key","jurisdiction"],"title":"UpcomingEvent","description":"One row on the Next-7-days card (#493)."},"UpdateMemberRoleRequest":{"properties":{"role":{"type":"string","enum":["admin","member"],"title":"Role"}},"type":"object","required":["role"],"title":"UpdateMemberRoleRequest"},"UpdateSilenceRequest":{"properties":{"duration_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Minutes"},"severities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severities"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"starts_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Starts At"},"ends_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ends At"}},"type":"object","title":"UpdateSilenceRequest"},"UpgradeStatusResponse":{"properties":{"tier_upgraded":{"type":"boolean","title":"Tier Upgraded"},"previous_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Tier"},"current_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Tier"},"new_api_jurisdictions":{"items":{"type":"string"},"type":"array","title":"New Api Jurisdictions"},"should_show_modal":{"type":"boolean","title":"Should Show Modal"}},"type":"object","required":["tier_upgraded","previous_tier","current_tier","new_api_jurisdictions","should_show_modal"],"title":"UpgradeStatusResponse","description":"What unlocked since the user last dismissed the upgrade modal."},"UserAnnouncement":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"kind":{"type":"string","enum":["general","jurisdiction_launch"],"title":"Kind"},"jurisdiction_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction Code"},"locale":{"type":"string","enum":["en","pl","nl"],"title":"Locale"},"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body"},"cta":{"anyOf":[{"$ref":"#/components/schemas/AnnouncementCta"},{"type":"null"}]},"priority":{"type":"integer","title":"Priority"},"starts_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Starts At"},"org_context":{"anyOf":[{"$ref":"#/components/schemas/AnnouncementOrgContext"},{"type":"null"}]}},"type":"object","required":["id","kind","jurisdiction_code","locale","title","body","cta","priority","starts_at","org_context"],"title":"UserAnnouncement"},"UserAnnouncementsResponse":{"properties":{"locale":{"type":"string","enum":["en","pl","nl"],"title":"Locale"},"items":{"items":{"$ref":"#/components/schemas/UserAnnouncement"},"type":"array","title":"Items"}},"type":"object","required":["locale","items"],"title":"UserAnnouncementsResponse"},"UserPreferencesUpdateRequest":{"properties":{"language":{"anyOf":[{"type":"string","enum":["en","pl","nl","de"]},{"type":"null"}],"title":"Language"},"theme":{"anyOf":[{"type":"string","enum":["light","night","system"]},{"type":"null"}],"title":"Theme"},"start_page":{"anyOf":[{"type":"string","enum":["dailyBrief","explore","legislation","watchlists","alerts"]},{"type":"null"}],"title":"Start Page"},"nav_order":{"anyOf":[{"items":{"type":"string","pattern":"^[A-Za-z]{1,40}$"},"type":"array","maxItems":30},{"type":"null"}],"title":"Nav Order"},"nav_hidden":{"anyOf":[{"patternProperties":{"^[A-Za-z]{1,40}$":{"type":"boolean"}},"type":"object"},{"type":"null"}],"title":"Nav Hidden"}},"additionalProperties":false,"type":"object","title":"UserPreferencesUpdateRequest","description":"Partial update of the caller's interface preferences.\n\nOmitted fields are unchanged. ``language`` and ``nav_order`` accept an\nexplicit ``null`` to return to the default (locale route / built-in\nnavigation order). Whether hiding leaves enough navigation visible is a\nfrontend rule; the API only validates shape."},"UserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"default_jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Jurisdiction"},"timezone":{"type":"string","title":"Timezone"},"email_verified":{"type":"boolean","title":"Email Verified"},"organization_id":{"type":"string","title":"Organization Id"},"role":{"type":"string","title":"Role"},"has_avatar":{"type":"boolean","title":"Has Avatar","default":false},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","required":["id","email","first_name","last_name","default_jurisdiction","timezone","email_verified","organization_id","role"],"title":"UserResponse","description":"Public user profile payload returned by auth endpoints."},"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"},"VerifyEmailRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"VerifyEmailRequest","description":"Payload containing email verification token."},"VocabularyOption":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"deprecated":{"type":"boolean","title":"Deprecated","default":false}},"type":"object","required":["id","label","description"],"title":"VocabularyOption","description":"One member of an alert filter vocabulary."},"VolumeBucket":{"properties":{"date":{"type":"string","title":"Date"},"total":{"type":"integer","title":"Total"},"new_bill":{"type":"integer","title":"New Bill"},"status_change":{"type":"integer","title":"Status Change"},"vote":{"type":"integer","title":"Vote"},"committee_event":{"type":"integer","title":"Committee Event"}},"type":"object","required":["date","total","new_bill","status_change","vote","committee_event"],"title":"VolumeBucket"},"VoteEventBrowseEntry":{"properties":{"vote_event":{"$ref":"#/components/schemas/VoteEventSummary"},"bill":{"anyOf":[{"$ref":"#/components/schemas/VoteLinkedBillSummary"},{"type":"null"}]},"group_records":{"items":{"$ref":"#/components/schemas/GroupVoteRecord"},"type":"array","title":"Group Records"}},"type":"object","required":["vote_event"],"title":"VoteEventBrowseEntry","description":"A vote event in the browse listing with linked bill info."},"VoteEventRecordsResponse":{"properties":{"vote_event":{"$ref":"#/components/schemas/VoteEventSummary"},"records":{"items":{"anyOf":[{"$ref":"#/components/schemas/PersonVoteRecord"},{"$ref":"#/components/schemas/GroupVoteRecord"}]},"type":"array","title":"Records"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"}},"type":"object","required":["vote_event","pagination","coverage"],"title":"VoteEventRecordsResponse","description":"Paginated mixed rows for one vote event."},"VoteEventSummary":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"comparability_tiers":{"$ref":"#/components/schemas/ComparabilityTiers"},"jurisdiction_extensions":{"$ref":"#/components/schemas/JurisdictionExtensions"},"source_system":{"type":"string","title":"Source System"},"source_vote_id":{"type":"string","title":"Source Vote Id"},"vote_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Vote Date"},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chamber"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"},"result_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Text"},"yes_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Yes Count"},"no_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"No Count"},"abstain_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Abstain Count"},"absent_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Absent Count"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"link_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Method"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"related_amendment":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Related Amendment"},"binary_comparable":{"type":"boolean","title":"Binary Comparable","default":true},"choice_semantics":{"type":"string","title":"Choice Semantics","default":"binary_roll_call"},"source_choice_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Source Choice Counts"},"unknown_choice_count":{"type":"integer","title":"Unknown Choice Count","default":0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","jurisdiction","source_system","source_vote_id"],"title":"VoteEventSummary","description":"Canonical vote-event summary used across vote APIs."},"VoteEventsBrowseResponse":{"properties":{"vote_events":{"items":{"$ref":"#/components/schemas/VoteEventBrowseEntry"},"type":"array","title":"Vote Events"},"pagination":{"$ref":"#/components/schemas/LegislativeItemsPagination"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"}},"type":"object","required":["pagination","coverage"],"title":"VoteEventsBrowseResponse","description":"Paginated vote event browse response."},"VoteLinkedBillSummary":{"properties":{"id":{"type":"string","title":"Id"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"comparability_tiers":{"$ref":"#/components/schemas/ComparabilityTiers"},"jurisdiction_extensions":{"$ref":"#/components/schemas/JurisdictionExtensions"},"source_system":{"type":"string","title":"Source System"},"source_bill_id":{"type":"string","title":"Source Bill Id"},"display_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Identifier"},"item_type":{"type":"string","title":"Item Type"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"introduced_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Introduced Date"},"latest_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Action Date"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"coverage":{"$ref":"#/components/schemas/CoverageDimensions"}},"type":"object","required":["id","jurisdiction","source_system","source_bill_id","item_type","title"],"title":"VoteLinkedBillSummary","description":"Bill summary attached to vote-history entries."},"VotesYesterday":{"properties":{"date":{"type":"string","title":"Date"},"passed":{"type":"integer","title":"Passed"},"failed":{"type":"integer","title":"Failed"},"scheduled_this_week":{"type":"integer","title":"Scheduled This Week"},"closest":{"anyOf":[{"$ref":"#/components/schemas/ClosestVote"},{"type":"null"}]}},"type":"object","required":["date","passed","failed","scheduled_this_week"],"title":"VotesYesterday","description":"The Votes-yesterday card block (#494)."},"WatchBundleCreateRequest":{"properties":{"subject_type":{"type":"string","maxLength":20,"minLength":1,"title":"Subject Type"},"subject_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Subject Id"},"subject_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","minItems":1},{"type":"null"}],"title":"Subject Ids"},"name_override":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name Override"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"reminder_lead_minutes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Reminder Lead Minutes"},"delivery_mode":{"type":"string","maxLength":32,"title":"Delivery Mode","default":"digest"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"type":"string","enum":["low","normal","high"],"title":"Priority","default":"normal"}},"type":"object","required":["subject_type"],"title":"WatchBundleCreateRequest","description":"Payload for creating a \"Watch one or more subjects\" bundle.\n\nA bundle = one auto-tagged watchlist + N category trackers, where\nevery tracker fans out to all chosen subjects via the watchlist.\nSubject type determines the default tracker set (bills →\nstatus/amendment/vote, persons → actor/vote, committees →\ncommittee). The caller can override with ``categories`` to\nsubscribe to a subset.\n\nEither ``subject_ids`` (preferred) or the legacy single\n``subject_id`` must be provided. Mixing the two is rejected."},"WatchBundleResponse":{"properties":{"watchlist_id":{"type":"string","title":"Watchlist Id"},"watchlist_name":{"type":"string","title":"Watchlist Name"},"subject_type":{"type":"string","title":"Subject Type"},"subject_ids":{"items":{"type":"string"},"type":"array","title":"Subject Ids"},"alerts":{"items":{"$ref":"#/components/schemas/AlertItem"},"type":"array","title":"Alerts"}},"type":"object","required":["watchlist_id","watchlist_name","subject_type","subject_ids","alerts"],"title":"WatchBundleResponse","description":"Result of creating a watch bundle: the watchlist id + every alert\nthat was created for it."},"WatchlistCreateRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"color":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Color"},"icon":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Icon"},"is_shared":{"type":"boolean","title":"Is Shared","default":false},"item_ids":{"items":{"type":"string"},"type":"array","title":"Item Ids"}},"type":"object","required":["name"],"title":"WatchlistCreateRequest","description":"Payload for creating a watchlist."},"WatchlistEventActor":{"properties":{"id":{"type":"string","title":"Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"avatar_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Color"}},"type":"object","required":["id"],"title":"WatchlistEventActor","description":"The user who triggered an audit-log event."},"WatchlistEventResponse":{"properties":{"id":{"type":"string","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"severity":{"type":"string","title":"Severity"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"actor":{"anyOf":[{"$ref":"#/components/schemas/WatchlistEventActor"},{"type":"null"}]},"source_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Source Event At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","event_type","title","severity","created_at"],"title":"WatchlistEventResponse","description":"One watchlist event row."},"WatchlistItemCreateRequest":{"properties":{"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"subject_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Type"},"subject_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Id"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","title":"WatchlistItemCreateRequest","description":"Payload for adding one subject to a watchlist.\n\nThe legacy bills-only path used ``item_id`` alone. The polymorphic path\naccepts ``subject_type`` + ``subject_id``. We keep both shapes so old\nclients keep working: when only ``item_id`` is sent, we treat it as\n``subject_type='bill', subject_id=item_id``."},"WatchlistItemPositionRequest":{"properties":{"position":{"anyOf":[{"type":"string","enum":["support","oppose"]},{"type":"null"}],"title":"Position"}},"type":"object","title":"WatchlistItemPositionRequest","description":"Set or clear a watchlist's position on a bill (null clears it)."},"WatchlistItemResponse":{"properties":{"subject_type":{"type":"string","title":"Subject Type","default":"bill"},"subject_id":{"type":"string","title":"Subject Id"},"item_id":{"type":"string","title":"Item Id"},"title":{"type":"string","title":"Title"},"title_native":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Native"},"native_language":{"type":"string","title":"Native Language","default":"en"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En Source"},"item_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Type"},"item_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Reference"},"latest_action_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Action Date"},"detail_href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail Href"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"position":{"anyOf":[{"type":"string","enum":["support","oppose"]},{"type":"null"}],"title":"Position"},"added_at":{"type":"string","format":"date-time","title":"Added At"}},"type":"object","required":["subject_id","item_id","title","added_at"],"title":"WatchlistItemResponse","description":"One watchlist item row, polymorphic across bills / persons / committees.\n\n``subject_type`` + ``subject_id`` are the canonical identifiers; ``item_id``\nduplicates ``subject_id`` for back-compat with code written against the\nbills-only schema. ``detail_href`` is built backend-side so the frontend\ndoesn't need to know the routing rules per subject type."},"WatchlistNotificationSetting":{"properties":{"signal_id":{"type":"string","title":"Signal Id"},"enabled":{"type":"boolean","title":"Enabled"},"cadence":{"type":"string","title":"Cadence"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"priority":{"type":"string","enum":["low","normal","high"],"title":"Priority","default":"normal"},"reminder_lead_minutes":{"items":{"type":"integer"},"type":"array","title":"Reminder Lead Minutes"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["signal_id","enabled","cadence","channels"],"title":"WatchlistNotificationSetting","description":"One row of the per-signal notification config for a watchlist.\n\nMirrors a row of `watchlist_notification_settings`. Signals not yet\nstored come back with default-disabled values so the frontend can\nrender every signal in the Notifications tab uniformly."},"WatchlistNotificationSettingUpdate":{"properties":{"signal_id":{"type":"string","maxLength":20,"minLength":1,"title":"Signal Id"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"cadence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cadence"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels"},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high"]},{"type":"null"}],"title":"Priority"},"reminder_lead_minutes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Reminder Lead Minutes"}},"type":"object","required":["signal_id"],"title":"WatchlistNotificationSettingUpdate","description":"Partial update for one signal — fields not passed are left alone."},"WatchlistNotificationSettingsResponse":{"properties":{"settings":{"items":{"$ref":"#/components/schemas/WatchlistNotificationSetting"},"type":"array","title":"Settings"}},"type":"object","required":["settings"],"title":"WatchlistNotificationSettingsResponse","description":"List wrapper for the watchlist Notifications tab payload."},"WatchlistNotificationSettingsUpdateRequest":{"properties":{"updates":{"items":{"$ref":"#/components/schemas/WatchlistNotificationSettingUpdate"},"type":"array","title":"Updates"}},"type":"object","required":["updates"],"title":"WatchlistNotificationSettingsUpdateRequest","description":"Bulk PATCH payload — one or more signal updates in a single call."},"WatchlistNotificationsPage":{"properties":{"unread_count":{"type":"integer","title":"Unread Count"},"items":{"items":{"$ref":"#/components/schemas/InboxItem"},"type":"array","title":"Items"},"pagination":{"additionalProperties":{"type":"integer"},"type":"object","title":"Pagination"}},"type":"object","required":["unread_count","items","pagination"],"title":"WatchlistNotificationsPage","description":"One page of a watchlist's notification feed (standard envelope)."},"WatchlistResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"is_shared":{"type":"boolean","title":"Is Shared"},"enabled":{"type":"boolean","title":"Enabled"},"item_count":{"type":"integer","title":"Item Count","default":0},"share_count":{"type":"integer","title":"Share Count","default":0},"event_count":{"type":"integer","title":"Event Count","default":0},"subject_counts":{"$ref":"#/components/schemas/WatchlistSubjectCounts"},"latest_signal_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Signal At"},"snoozed_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Snoozed Until"},"shared_with":{"items":{"$ref":"#/components/schemas/WatchlistTeammate"},"type":"array","title":"Shared With"},"auto_created":{"type":"boolean","title":"Auto Created","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"items":{"items":{"$ref":"#/components/schemas/WatchlistItemResponse"},"type":"array","title":"Items"},"shares":{"items":{"$ref":"#/components/schemas/WatchlistShareResponse"},"type":"array","title":"Shares"}},"type":"object","required":["id","name","is_shared","enabled","created_at","updated_at"],"title":"WatchlistResponse","description":"Watchlist summary/detail payload."},"WatchlistRollup":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"item_count":{"type":"integer","title":"Item Count"},"unread_notifications":{"type":"integer","title":"Unread Notifications"}},"type":"object","required":["id","name","item_count","unread_notifications"],"title":"WatchlistRollup","description":"One row on the Watchlists card (#495)."},"WatchlistShareCreateRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"role":{"type":"string","maxLength":32,"title":"Role","default":"viewer"}},"type":"object","required":["user_id"],"title":"WatchlistShareCreateRequest","description":"Payload for granting access to another workspace user."},"WatchlistShareResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"role":{"type":"string","title":"Role"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","user_id","role","created_at"],"title":"WatchlistShareResponse","description":"One shared access grant."},"WatchlistShareUpdateRequest":{"properties":{"role":{"type":"string","maxLength":32,"title":"Role"}},"type":"object","required":["role"],"title":"WatchlistShareUpdateRequest","description":"Patch payload for a share role."},"WatchlistSnoozeRequest":{"properties":{"until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Until"}},"type":"object","title":"WatchlistSnoozeRequest","description":"Set or clear the current user's watchlist mute window."},"WatchlistSnoozeResponse":{"properties":{"snoozed":{"type":"integer","title":"Snoozed"},"snoozed_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Snoozed Until"}},"type":"object","required":["snoozed"],"title":"WatchlistSnoozeResponse","description":"Result of a watchlist mute operation."},"WatchlistSubjectCounts":{"properties":{"bill":{"type":"integer","title":"Bill","default":0},"person":{"type":"integer","title":"Person","default":0},"committee":{"type":"integer","title":"Committee","default":0}},"type":"object","title":"WatchlistSubjectCounts","description":"Per-type counts of subjects in a watchlist."},"WatchlistTeammate":{"properties":{"id":{"type":"string","title":"Id"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"is_owner":{"type":"boolean","title":"Is Owner","default":false},"avatar_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Color"}},"type":"object","required":["id"],"title":"WatchlistTeammate","description":"Compact teammate row used in the avatar stack on watchlist cards."},"WatchlistUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"color":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Color"},"icon":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Icon"},"is_shared":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Shared"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"}},"type":"object","title":"WatchlistUpdateRequest","description":"Patch payload for watchlist metadata."},"WatchlistsResponse":{"properties":{"watchlists":{"items":{"$ref":"#/components/schemas/WatchlistResponse"},"type":"array","title":"Watchlists"}},"type":"object","required":["watchlists"],"title":"WatchlistsResponse","description":"List wrapper for watchlists."},"WebhookDeliveryEntry":{"properties":{"id":{"type":"string","title":"Id"},"outbox_event_id":{"type":"string","title":"Outbox Event Id"},"endpoint_id":{"type":"string","title":"Endpoint Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"attempt_count":{"type":"integer","title":"Attempt Count"},"last_attempted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Attempted At"},"next_retry_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Retry At"},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At"},"last_response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Response Status"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"last_error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Message"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","outbox_event_id","endpoint_id","event_type","status","attempt_count","created_at"],"title":"WebhookDeliveryEntry","description":"One row from ``webhook_deliveries`` — the per-(event, endpoint) audit record.\n\nReturned by ``GET /webhooks/{id}/deliveries`` for consumers to debug why\na specific event did or didn't reach them. ``error_message`` is truncated\nby the dispatcher to 2000 chars (per ``webhooks.py:mark_failure``)."},"WebhookDeliveryListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WebhookDeliveryEntry"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["items"],"title":"WebhookDeliveryListResponse","description":"Cursor-paginated delivery history. Reuses the public-v1 cursor shape\nso consumers can use the same paging helper they already use for the\nother ``/api/public/v1/*`` collection endpoints."},"WebhookEndpointListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WebhookEndpointSummary"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"WebhookEndpointListResponse"},"WebhookEndpointMintRequest":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1,"title":"Url"},"label":{"type":"string","maxLength":120,"minLength":1,"title":"Label"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","title":"Jurisdiction Codes"},"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","description":"Event types to receive; empty receives all, including types added later. See GET /api/public/v1/webhooks/event-types."}},"type":"object","required":["url","label"],"title":"WebhookEndpointMintRequest","description":"Payload for POST webhooks (both /me/webhooks and /api/public/v1/webhooks)."},"WebhookEndpointMintResponse":{"properties":{"endpoint":{"$ref":"#/components/schemas/WebhookEndpointSummary"},"plain_secret":{"type":"string","title":"Plain Secret"}},"type":"object","required":["endpoint","plain_secret"],"title":"WebhookEndpointMintResponse","description":"The plain secret appears ONCE here.\n\nThe consumer uses the plain secret on their end to verify\n``webhook-signature`` headers (Standard Webhooks). We never expose it again — they must\nstore it now."},"WebhookEndpointSummary":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"label":{"type":"string","title":"Label"},"secret_prefix":{"type":"string","title":"Secret Prefix"},"jurisdiction_codes":{"items":{"type":"string"},"type":"array","title":"Jurisdiction Codes"},"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types"},"enabled":{"type":"boolean","title":"Enabled"},"created_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"last_delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Delivered At"}},"type":"object","required":["id","url","label","secret_prefix","jurisdiction_codes","event_types","enabled","created_at","updated_at"],"title":"WebhookEndpointSummary","description":"Public-safe metadata for one webhook endpoint. Never includes plain secret."},"WebhookEndpointUpdateRequest":{"properties":{"url":{"anyOf":[{"type":"string","maxLength":2048,"minLength":1},{"type":"null"}],"title":"Url"},"label":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Label"},"jurisdiction_codes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Jurisdiction Codes"},"event_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Event Types"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"}},"type":"object","title":"WebhookEndpointUpdateRequest"},"WebhookEventType":{"properties":{"event_type":{"type":"string","title":"Event Type"},"aggregate_type":{"type":"string","title":"Aggregate Type"},"action":{"type":"string","title":"Action"},"kind":{"type":"string","enum":["lifecycle","entity"],"title":"Kind","description":"lifecycle: bill.introduced, bill.updated, vote.recorded, committee.scheduled; entity: <type>.created / <type>.updated."},"description":{"type":"string","title":"Description","description":"What triggers the event (English)."}},"type":"object","required":["event_type","aggregate_type","action","kind","description"],"title":"WebhookEventType","description":"One event type the dispatcher emits (``app/services/webhooks.py``)."},"WebhookEventTypesResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WebhookEventType"},"type":"array","title":"Items"},"test_event_type":{"type":"string","title":"Test Event Type","description":"Sent only by Send test, never by the dispatcher."}},"type":"object","required":["items","test_event_type"],"title":"WebhookEventTypesResponse"},"WebhookSecretRotateResponse":{"properties":{"id":{"type":"string","title":"Id"},"plain_secret":{"type":"string","title":"Plain Secret"}},"type":"object","required":["id","plain_secret"],"title":"WebhookSecretRotateResponse","description":"One-shot plain-secret pattern, same as mint."},"WebhookTestPingResponse":{"properties":{"delivery_id":{"type":"string","title":"Delivery Id"},"response_status":{"type":"integer","title":"Response Status"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"latency_seconds":{"type":"number","title":"Latency Seconds"}},"type":"object","required":["delivery_id","response_status","latency_seconds"],"title":"WebhookTestPingResponse","description":"Returned by POST /webhooks/{id}/test — synthetic event delivery result.\n\nUseful for consumers to verify their receiver is wired up correctly\nimmediately after minting an endpoint, instead of waiting for a real\nevent to land."},"app__routers__billing__SubscriptionUpdateRequest":{"properties":{"plan":{"type":"string","enum":["explorer","team","pro","business"],"title":"Plan"}},"type":"object","required":["plan"],"title":"SubscriptionUpdateRequest","description":"The self-service plan to move an active subscription to."},"app__routers__email_subscriptions__SubscriptionUpdateRequest":{"properties":{"channel":{"type":"string","enum":["digest","alert_match","watchlist_shared","all"],"title":"Channel"},"subscribed":{"type":"boolean","title":"Subscribed","description":"True to opt in, false to opt out."}},"type":"object","required":["channel","subscribed"],"title":"SubscriptionUpdateRequest"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}},"tags":[]}