# Y2

> Y2 is the context layer for real-world intelligence. It turns changing external signals and private project evidence into source-backed context that people, AI models, and agents can reuse through recurring research, multi-model Chat, Projects, ontology-backed graphs, Automations, MCP, webhooks, and APIs.

The full documentation is available at [https://y2.dev/llms-full.txt](https://y2.dev/llms-full.txt).

## When to use Y2

Use Y2 when an agent or team needs to monitor a changing real-world topic, investigate connected entities and incidents, produce a source-backed briefing, retrieve bounded context for another workflow, or deliver recurring intelligence through an API, webhook, report, or supported MCP client.
Call the REST API for explicit reads and writes, webhooks for configured asynchronous delivery, and the separately distributed MCP package for local tool discovery. Start from the OpenAPI contract, authenticate server-side with `Authorization: Bearer <Y2_API_KEY>`, grant only required scopes, and retain response request IDs for diagnostics.
Do not treat Y2 or its generated output as the original source or as an autonomous final decision maker. Review consequential findings against the cited evidence and check documented availability and plan limits before designing a dependency.

## Y2 Developer Resources

- [Y2 Developer Hub](https://y2.dev/developers): Predictable starting point for API, OpenAPI, authentication, webhooks, MCP, and agent integration guidance.
- [Y2 OpenAPI 3.1 JSON](https://y2.dev/openapi.json): Machine-readable API contract for tool generation and function calling.
- [Y2 OpenAPI 3.1 YAML](https://y2.dev/api/openapi.yaml): Canonical human-reviewable API contract.
- [Y2 API Authentication](https://y2.dev/docs/api/authentication): Bearer keys, workspace binding, scopes, rate limits, and structured errors.
- [Y2 Webhooks](https://y2.dev/docs/api/webhooks): Webhook resources and subscription delivery configuration.
- [Y2 MCP Setup](https://y2.dev/docs/api/mcp): Configure and inspect the separately distributed local MCP server.

## Product Overview

- [What is Y2?](https://y2.dev/what-is-y2): How Y2 turns changing external signals and private project evidence into source-backed context that people, AI models, and agents can reuse.
- [Situation Room](https://y2.dev/docs/osint): Open-source event, market, prediction, cyber, and country context with source-specific update frequencies.
- [Best OSINT Platforms for Real-Time Global Intelligence](https://y2.dev/blog/best-osint-platforms-real-time-global-intelligence): A sourced comparison of Y2, Maltego, Flashpoint, Recorded Future, Palantir, and MISP by monitoring, graph, threat-intelligence, and cost requirements.
- [Graph Intelligence](https://y2.dev/docs/api/intel): Entity and incident graph APIs that connect people, organizations, countries, CVEs, markets, signals, and supporting observations.
- [Custom Topic Monitoring](https://y2.dev/docs/profiles): Persistent profiles for topics, regions, suppliers, markets, risks, and organizations with scheduled intelligence reports.
- [Multi-model AI Chat](https://y2.dev/docs/chat): Change the eligible model while keeping the conversation and its Y2 tool context together, with provider-side ZDR routing by default.
- [Projects and Automations](https://y2.dev/docs/projects): Organize private evidence around one objective and run eligible scheduled follow-up without publishing Project content to Global Knowledge.

## API and Client Guides

- [API Reference](https://y2.dev/docs/api): REST API overview with base URLs, scopes, generated endpoint docs, OpenAPI, and x402 pay-per-request notes.
- [TypeScript](https://y2.dev/docs/sdks/typescript): Generate types from OpenAPI and call Y2 from a server-side TypeScript transport.
- [Python](https://y2.dev/docs/sdks/python): Build a small standard-library client around the current Y2 HTTP contract.
- [Command Line](https://y2.dev/docs/sdks/cli): Use curl and jq for authenticated requests, pagination, exports, and diagnostics.

## Plans and Availability

- [Plans and Limits](https://y2.dev/docs/plans): Current pricing, workspace access, profile and delivery limits, Chat credits, API-key eligibility, Projects, Automations, and organization features.
- [Global Knowledge](https://y2.dev/docs/api/global-knowledge): Private-beta availability and authorization boundaries for bounded retrieval.
- [Context as a Service for Industrial AI Agents](https://y2.dev/blog/owned-context-compounds-rented-context-decays): A sourced industrial example with explicit product and availability boundaries.

## Overview

- [Getting Started](https://y2.dev/docs): Create your Y2 workspace and set up your first intelligence profile or subscription.

## Plans and Limits

- [Plans and Limits](https://y2.dev/docs/plans): Reference for Y2 workspace plans, feature availability, and enforced limits.

## Situation Room (OSINT)

- [Country Intelligence Cards](https://y2.dev/docs/osint/country-cards): Open and interpret the country-level dossier in the Situation Room
- [Data Infrastructure](https://y2.dev/docs/osint/data-infrastructure): How Y2 ingests, normalizes, resolves, retains, and serves intelligence data
- [Situation Room](https://y2.dev/docs/osint): Monitor geospatial events, infrastructure, network threats, tracking data, and financial signals
- [Intelligence Sources](https://y2.dev/docs/osint/sources): Identify scheduled feeds, internal observations, reference overlays, and source-health signals

## Y2 News Terminal

- [News Signal Feed](https://y2.dev/docs/news): Monitor direct-source news signals and 12-hour topic recaps
- [AI News Recaps](https://y2.dev/docs/news/recaps): Read and retrieve cached 12-hour summaries for selected News feeds
- [Topics and Feeds](https://y2.dev/docs/news/topics): Reference for the News Signal Feed topic catalog and identifiers

## Projects

- [Create Your First Project](https://y2.dev/docs/projects/getting-started): Tutorial for creating a Project, attaching intelligence, and starting a Project-scoped chat.
- [Projects](https://y2.dev/docs/projects): Understand how Projects keep chats, evidence, documents, graphs, and intelligence outputs inside one workspace-bound objective.
- [Organize Intelligence in a Project](https://y2.dev/docs/projects/organizing-intelligence): How-to guide for connecting resources, evidence, private knowledge, graphs, and chats to one Project.
- [Projects Reference](https://y2.dev/docs/projects/reference): Reference for Project availability, ownership, views, resources, limits, and lifecycle behavior.

## Automations

- [Create an Automation](https://y2.dev/docs/automations/creating): Tutorial for configuring and verifying a scheduled or report-triggered Agent Y2 Automation.
- [Automations](https://y2.dev/docs/automations): Understand Pro and Elite Automations that run Agent Y2 on a schedule or after a profile report completes.
- [Automations Reference](https://y2.dev/docs/automations/reference): Reference for Automation availability, quotas, triggers, statuses, notifications, billing, and workspace checks.

## Report Workflow

- [InfoOps Report Workflow](https://y2.dev/docs/workflows): Understand the durable research, synthesis, enrichment, and delivery pipeline behind profiles

## Information Operations

- [Branding Templates](https://y2.dev/docs/profiles/branding): Create reusable branding for reports, email, SMS, and audio delivery
- [Create a Profile](https://y2.dev/docs/profiles/creating): Create an Information Operations profile with the current three-step Y2 editor.
- [Information Operations](https://y2.dev/docs/profiles): Understand how Y2 profiles turn recurring questions into research and report workflows.
- [Schedule Profile Reports](https://y2.dev/docs/profiles/scheduling): Configure and change the UTC schedule used by an Information Operations profile.
- [Share a Profile](https://y2.dev/docs/profiles/sharing): Publish a workspace-owned profile for community discovery and understand subscriber behavior.

## Audio Reports

- [Audio Reports](https://y2.dev/docs/audio): Configure, generate, play, and retrieve narrated intelligence reports

## Delivery

- [Email Delivery](https://y2.dev/docs/delivery/email): Send each profile's intelligence reports to an account or Elite workspace audience
- [SMS Delivery](https://y2.dev/docs/delivery/sms): Send concise report summaries to a verified account phone
- [Webhook Delivery](https://y2.dev/docs/delivery/webhooks): Deliver compact CloudEvents when intelligence reports are published

## API Reference

- [Agent Y2 API](https://y2.dev/docs/api/agent-y2): Stream Y2's preconfigured workspace-aware agent through native or OpenAI-compatible requests
- [AI Quickstart](https://y2.dev/docs/api/agentic-dx): Ground an AI coding agent in Y2's generated docs, API contract, tenant model, and verification loop
- [Authentication](https://y2.dev/docs/api/authentication): Create, scope, send, rotate, and troubleshoot workspace-bound Y2 API keys
- [Automations API](https://y2.dev/docs/api/automations): Manage durable Agent Y2 Automation definitions and run history through the Y2 API.
- [Y2 Global Knowledge](https://y2.dev/docs/api/global-knowledge): Retrieve bounded, authorized evidence across Y2 reports and signal assessments
- [API Overview](https://y2.dev/docs/api): Choose the correct Y2 API surface, authentication path, version root, and generated contract
- [Integration Recipes](https://y2.dev/docs/api/integration-recipes): Build grounded agents, GIS imports, warehouse syncs, and durable intelligence pipelines
- [Query the Intel API (v2)](https://y2.dev/docs/api/intel): Find ontology incidents, entities, signals, markets, financial indicators, and cyber graphs
- [Connect Y2 through MCP](https://y2.dev/docs/api/mcp): Install @y2-intel/mcp 0.2.0 and give agents scoped access to Y2
- [Migrate to Canonical API Responses](https://y2.dev/docs/api/migration-v1-1): Adopt public IDs, pagination, representations, mutation preconditions, and CloudEvents
- [Build with the News API](https://y2.dev/docs/api/news): Discover feeds, page direct-source news items, and retrieve AI-generated topic recaps
- [Use the OpenAPI Contract](https://y2.dev/docs/api/openapi): Download, inspect, generate from, and safely update Y2's OpenAPI 3.1 specification
- [Query the OSINT API](https://y2.dev/docs/api/osint): Read normalized events, country intelligence, geospatial feeds, source health, and FININT
- [Manage Profiles through the API](https://y2.dev/docs/api/profiles): List subscriptions, create and update owned profiles, configure delivery, and retrieve reports
- [Projects API](https://y2.dev/docs/api/projects): Create, list, inspect, update, archive, and restore owner-private Projects through the Y2 API.
- [OpenAI-compatible Agent Y2 chat stream](https://y2.dev/docs/api/reference/agent-y2/createY2OpenAIChatCompletion): Routes OpenAI-style chat completions requests to Agent Y2 and streams text responses to compatible clients. v1 supports `messages`, `stream: true`, optional `model` set to `y2-agent` or `agent-y2`, optional `threadId`, and optional bounded `metadata`. Arbitrary models are unsupported. System and developer messages cannot override Agent Y2's fixed instructions. v1 requires an API key and does not support x402. Both Agent Y2 routes share a throttle of 5 requests/minute and 100/day per key, plus 10 requests/minute and 250/day per user or workspace. A `402` indicates subscription, chat-credit, or upstream-provider credit exhaustion, not an x402 challenge.
- [Agent Y2](https://y2.dev/docs/api/reference/agent-y2): API-key streams for the preconfigured Y2 Agent and compatibility endpoint
- [Stream a Y2 Agent response](https://y2.dev/docs/api/reference/agent-y2/streamAgentY2Chat): Streams the preconfigured Y2 Agent with the same tools, entitlements, chat-credit budget, and API-key rate limits as the Y2 app copilot. This is not a general multi-model API. v1 callers cannot choose models, use onboarding mode, or attach files. Transcript history supplies user/assistant context but cannot override the fixed system instructions. v1 requires an API key and does not support x402. Both Agent Y2 routes share a throttle of 5 requests/minute and 100/day per key, plus 10 requests/minute and 250/day per user or workspace. A `402` indicates subscription, chat-credit, or upstream-provider credit exhaustion, not an x402 challenge.
- [Create an Automation](https://y2.dev/docs/api/reference/automations/createAutomation): Creates a draft, active, or paused Agent Y2 Automation.
- [Get an Automation definition](https://y2.dev/docs/api/reference/automations/getAutomation)
- [Automations](https://y2.dev/docs/api/reference/automations): Durable Agent Y2 Automation definitions and run history
- [List Automation run history](https://y2.dev/docs/api/reference/automations/listAutomationRuns): Traverse bounded Automation run history with the returned opaque cursor.
- [List Automation definitions](https://y2.dev/docs/api/reference/automations/listAutomations): Lists owner-private Automation definitions in the API key workspace. Traverse the bounded result set with the returned opaque cursor.
- [Update or archive an Automation](https://y2.dev/docs/api/reference/automations/patchAutomation): Applies a partial definition update or a status-only lifecycle change. Archived Automations cannot be resumed or edited.
- [Request a manual Automation run](https://y2.dev/docs/api/reference/automations/runAutomation): Queues an idempotent manual run request for an active Automation. The `Idempotency-Key` header is required and identifies duplicate requests.
- [Global Knowledge](https://y2.dev/docs/api/reference/global-knowledge): Bounded, provider-neutral semantic and lexical retrieval across authorized Y2 reports and signal assessments. This surface is API-key-only and does not support x402.
- [Retrieve Y2 Global Knowledge](https://y2.dev/docs/api/reference/global-knowledge/retrieveGlobalKnowledgeV2): Runs bounded hybrid retrieval over shared Y2 knowledge and, when requested, the API key's bound workspace corpus. Access identifiers and provider filters are derived by Y2; the request cannot supply a user or workspace ID. Results are discovery evidence, include source IDs and citations, and omit provider and access-control attributes. This operation requires a workspace-bound API key with `intel:knowledge`. It does not support x402. Agent Y2 keys continue to use `agent:y2`; the agent may invoke this retrieval tool internally when the workspace is entitled to Chat.
- [Endpoint Reference](https://y2.dev/docs/api/reference): Y2 endpoints generated from the OpenAPI contract.
- [Cyber entity graph](https://y2.dev/docs/api/reference/intel/getCyberGraphV2): Returns a graph rooted at a CVE, threat actor, or malware family. Requires `rootCveId`, `rootActorId`, or `rootMalwareFamilyId`. Breadth-first search depth is capped at 2.
- [Traverse an entity relationship graph](https://y2.dev/docs/api/reference/intel/getEntityGraphV2): Traverses the ontology graph from `entityId` with breadth-first search. Returns nodes and edges to the requested depth, capped at 200 nodes. `relationKinds` limits traversed edge kinds.
- [Get an intel entity](https://y2.dev/docs/api/reference/intel/getEntityV2): Returns an entity with inbound and outbound relations, related entities, participating incidents, subject markets, and recent observations.
- [Get an intel incident](https://y2.dev/docs/api/reference/intel/getIncidentV2): Returns an incident with supporting observations, linked markets and entities, primary place, and related incidents. The server resolves the category before checking scope: `intel:cyber` for cyber, `intel:finint` for other categories, or `intel:explorer` for any.
- [Intel](https://y2.dev/docs/api/reference/intel): Ontology-backed v2 incidents, entities, markets, financial indicators, emergent signals, and cyber graphs. Served from `https://api.y2.dev/api/v2/*`. Operations accept Bearer API keys or x402 pay-per-request. Required scopes vary by resource: `intel:finint`, `intel:cyber`, or `intel:explorer`. The in-app Cyber dashboard is available on all plans. New API-key access to FININT, Cyber, and Explorer requires Pro or Elite; existing Lite API keys are grandfathered.
- [List CVE entities](https://y2.dev/docs/api/reference/intel/listCVEsV2): Lists `kind=cve` ontology entities. `q` searches CVE identifiers. Equivalent to `GET /api/v2/entities?kind=cve&q=...`.
- [Read the public intelligence change feed](https://y2.dev/docs/api/reference/intel/listChangesV2): Returns immutable public-resource lifecycle events in global order. An authenticated API key receives globally visible intelligence changes plus changes owned by its user or workspace tenant. Anonymous x402 requests receive globally visible intelligence changes only; tenant records are never exposed across scopes. The `watermark` is an opaque exclusive checkpoint: persist the returned value and send it on the next request. Replaying a checkpoint never skips later events and may safely be retried after a consumer failure. Deleted resources are represented as tombstones. Events are append-only in schema version `1.0`; no retention expiry is currently applied.
- [List intel entities](https://y2.dev/docs/api/reference/intel/listEntitiesV2): Lists ontology entities, including people, organizations, countries, CVEs, threat actors, vessels, aircraft, facilities, vendors, software, and protocols. `q` searches `canonicalName`; `kind` filters by exact kind.
- [List FININT indicators](https://y2.dev/docs/api/reference/intel/listFinintIntelV2): Lists dimension-filtered FININT indicators from the same data as `GET /api/v1/osint/finint`, using the `intel:finint` scope and ontology-aware filters.
- [List intel incidents](https://y2.dev/docs/api/reference/intel/listIncidentsV2): Lists deduplicated, scored ontology incidents linked from the OSINT cache. Filters by category, severity, status, or last-observed lower bound. Required scopes vary by `category` filter: - `category=cyber` → `intel:cyber` or `intel:explorer` - any other category → `intel:finint` or `intel:explorer` - no `category` filter → `intel:explorer` Supports x402 pay-per-request. Requests without `Authorization` return `402 Payment Required` with payment requirements; retry with a signed `PAYMENT-SIGNATURE` header.
- [List intel markets](https://y2.dev/docs/api/reference/intel/listMarketsV2): Lists Y2-derived, Polymarket, Kalshi, and Manifold ontology markets keyed by `marketKey`. Filters by source and lifecycle status. Each market links to subject entities and may link to an underlying incident.
- [List tagged emergent signals](https://y2.dev/docs/api/reference/intel/listSignalsV2): Lists cached Y2 emergent SIGINT signals with ontology-aligned subjects, normalized subject keys, tags, source-report metadata, timestamps, and available geographic, observation, or entity links. Required scopes vary by `domain` filter: - `domain=cyber` or `domain=technology` -> `intel:cyber` or `intel:explorer` - `domain=markets` or `domain=supply_chain` -> `intel:finint` or `intel:explorer` - other domain filters -> `intel:explorer` - no `domain` filter -> any of `intel:cyber`, `intel:finint`, or `intel:explorer` Public x402 callers receive global and community signals. Authenticated API-key callers also receive authorized workspace and private rows.
- [List threat actor entities](https://y2.dev/docs/api/reference/intel/listThreatActorsV2): Lists `kind=threat_actor` ontology entities. Equivalent to `GET /api/v2/entities?kind=threat_actor&q=...`.
- [News](https://y2.dev/docs/api/reference/news): News Terminal items, feeds, and AI recaps
- [List available news feeds](https://y2.dev/docs/api/reference/news/listFeeds): Lists news feed topics and descriptions. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [List news items](https://y2.dev/docs/api/reference/news/listNews): Lists cached Y2 News Terminal items with topic filters and pagination. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [List AI-generated recaps](https://y2.dev/docs/api/reference/news/listRecaps): Lists AI-generated recaps for selected topics and timeframe. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [AI-generated intelligence brief](https://y2.dev/docs/api/reference/osint/getCountryBrief): Returns a periodically generated, cached intelligence brief for a country. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Country instability index](https://y2.dev/docs/api/reference/osint/getCountryCII): Returns a country's Conflict Indicators Index (CII) score, baseline, delta, and components. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Country-specific news](https://y2.dev/docs/api/reference/osint/getCountryNews): Returns recent country news from the OSINT event pipeline. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Prediction markets](https://y2.dev/docs/api/reference/osint/getCountryPredictions): Returns prediction-market probabilities and trading volumes for a country. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Stock market index](https://y2.dev/docs/api/reference/osint/getCountryStockIndex): Returns a country's primary stock index, weekly change, and currency. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [OSINT](https://y2.dev/docs/api/reference/osint): Situation Room events, feeds, country data, and source health
- [Tracked military aircraft](https://y2.dev/docs/api/reference/osint/listAircraft): Lists Wingbits ADS-B military aircraft positions, classified by type such as tanker, AWACS, or fighter. > **Status:** Aircraft ingestion has been disabled since May 8, 2026, to > reserve the shared Wingbits quota for GPS interference detection. This > endpoint may return empty or stale results. `/osint/gps-jamming` is unaffected. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Conflict Indicators Index](https://y2.dev/docs/api/reference/osint/listCII): Lists Conflict Indicators Index (CII) values with 0–100 scores and recent-change deltas. Supports region and category filters. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [List cyber threat indicators](https://y2.dev/docs/api/reference/osint/listCyberThreats): Lists URLhaus malware URLs, Feodo Tracker C2 servers, and RSS cyber-feed indicators with malware family, tags, and host metadata. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Financial intelligence indicators](https://y2.dev/docs/api/reference/osint/listFinintIndicators): Lists financial intelligence (FININT) indicators from FRED macroeconomic series, Yahoo Finance markets, and EIA energy data. Each includes current and previous values, percentage change, sparkline data, and active alerts. ### Aggregate and dimension rows Most indicators are US aggregates: one row per `indicatorId` (for example, `EIA:WTI`, `FRED:DGS10`). EIA also publishes per-dimension rows tagged with `dimension`, `dimensionType`, `lat`, and `lon`: - `dimensionType=facility`: reactor outages, such as `EIA:NUKE_OUTAGE:vogtle` - `dimensionType=rto`: hourly US balancing-authority demand, such as `EIA:RTO_LOAD:PJM` - `dimensionType=port`: monthly port-level crude imports, such as `EIA:CRUDE_IMPORT:houston` Filter by `dimensionType` for dimension rows only. Aggregate rows set `dimension`, `dimensionType`, `lat`, and `lon` to null. Nuclear-outage rows with `outagePct > 0` publish `economic` map events to the OSINT cache. RTO and crude-import rows do not publish map events. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [GPS interference zones](https://y2.dev/docs/api/reference/osint/listGPSJamming): Lists GPS interference zones inferred from ADS-B navigation-accuracy degradation and aggregated into H3 cells. Coverage spans 22 theaters on a tiered cadence within the shared Wingbits quota: | Tier | Cadence | Theaters | | --------- | --------- | ------------------------------------------------------------------------------------------------- | | Hot | Hourly | iran, blacksea, israelgaza, redsea, taiwan, scs | | Watch | Every 3h | emed, korea, caucasus, kaliningrad-tight, finland-russia, us-south, bashi-luzon, east-china-sea | | Perimeter | Every 6h | us-pacom-west, us-northeast, aleutian-bering, baltic-south, giuk-greenland | | Daily | Every 24h | baltic-north, us-north, arctic-greenland-pass | Records expire 30 minutes after fetch. Align polling with the theater's tier. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Military posture by theater](https://y2.dev/docs/api/reference/osint/listMilitaryPosture): Lists theater posture assessments based on Wingbits ADS-B military aircraft activity. Each includes a `normal`, `elevated`, or `critical` posture and aircraft counts by type. > **Status:** Aircraft ingestion has been disabled since May 8, 2026, to > reserve the shared Wingbits quota for GPS interference detection. This > endpoint may return empty or stale results. `/osint/gps-jamming` is unaffected. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [List threat events](https://y2.dev/docs/api/reference/osint/listOsintEvents): Lists Situation Room threat events. Supports category and severity filters. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [List map events with coordinates](https://y2.dev/docs/api/reference/osint/listOsintMapEvents): Lists geolocated OSINT events for map display. Excludes events without coordinates. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Search regional OSINT events](https://y2.dev/docs/api/reference/osint/listOsintRegionalEvents): Searches OSINT events across RSS, USGS, GDACS, ACLED, direct News Terminal items, other threat feeds, and Y2 report extractions. Filters by region, country code, bounding box, radius, source, category, severity, time window, or title text. Text search falls back to description substrings. All filters compose with AND, including coordinate and region filters. Events without coordinates remain unless `requireCoordinates=true` or a bounding-box or radius filter is supplied. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [List prediction markets](https://y2.dev/docs/api/reference/osint/listPredictionMarkets): Lists Polymarket and Kalshi markets by descending volume with probabilities, volume, and outcomes. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Data source health](https://y2.dev/docs/api/reference/osint/listSourceStatus): Lists OSINT source health, circuit-breaker state, and failure counts. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Naval vessel positions](https://y2.dev/docs/api/reference/osint/listVessels): Lists USNI fleet-tracker positions for carrier strike groups and warships. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Y2 report-extracted events](https://y2.dev/docs/api/reference/osint/listY2Events): Lists Y2SOURCE events extracted from intelligence reports with classification, confidence, entities, and originating-report provenance. Returns only `sourceType: "y2_report"` events. Supports category, severity, and country-code filters. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [x402 receipt lookup](https://y2.dev/docs/api/reference/payments/getX402Receipt): Returns sanitized x402 payment status by nonce. Public: anyone with the nonce can read the receipt status.
- [Payments](https://y2.dev/docs/api/reference/payments): x402 receipt lookup
- [Create an intelligence profile](https://y2.dev/docs/api/reference/profiles/createProfile): Creates an `active` intelligence profile owned by the authenticated user with the supplied configuration.
- [Delete a profile](https://y2.dev/docs/api/reference/profiles/deleteProfile): Permanently deletes a profile owned by the authenticated user and all its subscriptions. This action cannot be undone.
- [Profiles](https://y2.dev/docs/api/reference/profiles): Profile subscriptions, ownership, and configuration
- [List subscribed profiles](https://y2.dev/docs/api/reference/profiles/listProfiles): Lists the user's subscribed profiles with subscription status and delivery preferences.
- [Update a profile (partial)](https://y2.dev/docs/api/reference/profiles/patchProfile): Updates supplied mutable fields on a profile owned by the authenticated user. Omitted fields remain unchanged.
- [Update a profile (full replacement)](https://y2.dev/docs/api/reference/profiles/updateProfile): Replaces every mutable field on a profile owned by the authenticated user.
- [Create a Project](https://y2.dev/docs/api/reference/projects/createProject): Creates an active owner-private Project in the API key workspace.
- [Get a Project](https://y2.dev/docs/api/reference/projects/getProject)
- [Projects](https://y2.dev/docs/api/reference/projects): Owner-private intelligence workspaces in the API key workspace
- [List owned Projects](https://y2.dev/docs/api/reference/projects/listProjects): Lists owner-private Projects in the API key workspace. Results are bounded, ordered by recent activity, and traversable with an opaque cursor.
- [Update, archive, or restore a Project](https://y2.dev/docs/api/reference/projects/patchProject): Applies a partial Project update. Set `status` to `archived` or `active` for the reversible lifecycle transition. Archiving pauses active bound Automations.
- [Get a report](https://y2.dev/docs/api/reference/reports/getReport): Returns a compact report by default. Use bounded `include` values or `view=agent`; request `text/markdown` for the canonical Markdown representation. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Get report audio](https://y2.dev/docs/api/reference/reports/getReportAudio): Returns audio file metadata or redirects to the CDN URL. Requires the `reports:audio` scope. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Get TTS-preprocessed report text](https://y2.dev/docs/api/reference/reports/getReportAudioText): Returns the report content preprocessed for text-to-speech synthesis. Applies pronunciation normalization for acronyms, currency, and percentages; strips HTML and Markdown; and adds branding intro/outro text. Cartesia TTS generation uses this pipeline. Requires the `reports:read` scope. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Get report ontology graph](https://y2.dev/docs/api/reference/reports/getReportGraph): Returns the report's bounded ontology graph: report-local nodes, edges, incident anchors, citations, and counts. Reports created before graph extraction return `graph: null` with zero counts. Requires the `reports:read` scope. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Get report emergent signals](https://y2.dev/docs/api/reference/reports/getReportSignals): Returns structured emergent SIGINT signals inferred from a report. Reports created before signal extraction return an empty `signals` array. Requires the `reports:read` scope. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Get report as plain text](https://y2.dev/docs/api/reference/reports/getReportText): Returns the report content stripped of all HTML tags as plain text, along with word count and estimated reading time. Requires the `reports:read` scope. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Reports](https://y2.dev/docs/api/reference/reports): Report retrieval, text, audio, signals, and ontology graphs
- [List intelligence reports](https://y2.dev/docs/api/reference/reports/listReports): Lists reports for the user's subscribed profiles by generation date, newest first. Supports x402 pay-per-request. Requests with a valid Bearer token use API-key authentication. Without a Bearer API key, start the x402 flow from the `402 Payment Required` response and `PAYMENT-REQUIRED` header; retry with `PAYMENT-SIGNATURE`.
- [Subscriptions](https://y2.dev/docs/api/reference/subscriptions): Subscription delivery management
- [Update subscription delivery method](https://y2.dev/docs/api/reference/subscriptions/updateDelivery): Changes a subscription's delivery method. Setting `webhook` requires an active `webhookConfigId`. On plans with member seats, set `emailAudience` to `workspace` to email active workspace members.
- [Create a webhook configuration](https://y2.dev/docs/api/reference/webhooks/createWebhook): Creates a webhook configuration. Requires a paid workspace plan with webhook access. The URL must use HTTPS and pass SSRF validation.
- [Delete a webhook configuration](https://y2.dev/docs/api/reference/webhooks/deleteWebhook): Deletes a webhook configuration. Returns `409` if any subscription uses it.
- [Webhooks](https://y2.dev/docs/api/reference/webhooks): Webhook configuration for paid workspaces
- [List webhook configurations](https://y2.dev/docs/api/reference/webhooks/listWebhooks): Lists the authenticated user's webhook configurations. Masks secrets.
- [Test a webhook endpoint](https://y2.dev/docs/api/reference/webhooks/testWebhook): Sends a test payload to the webhook URL. Returns `422` if the endpoint responds with an error.
- [Update a webhook configuration](https://y2.dev/docs/api/reference/webhooks/updateWebhook): Replaces every mutable webhook configuration field. `name` and `url` are required; omitted optional fields are reset to their defaults.
- [Retrieve Reports through the API](https://y2.dev/docs/api/reports): List published reports and choose compact JSON, Markdown, text, signals, graph, or audio
- [Configure Report Webhooks](https://y2.dev/docs/api/webhooks): Create a signed webhook, attach it to a subscription, and process CloudEvents safely
- [Explore the API with Workbench](https://y2.dev/docs/api/workbench): Run live read requests and generate secret-safe curl, TypeScript, and Python examples
- [Pay per Request with x402](https://y2.dev/docs/api/x402): Call supported read endpoints without an API key by settling USDC on Base

## Client Guides & Tools

- [Use Y2 from the Command Line](https://y2.dev/docs/sdks/cli): Test, inspect, paginate, and export Y2 API resources with curl and jq
- [Client Libraries and Tools](https://y2.dev/docs/sdks): Choose a typed client, direct HTTP integration, or command-line workflow for the Y2 API
- [Build a Python Client](https://y2.dev/docs/sdks/python): Create a small Python client for Y2 JSON reads, writes, errors, and pagination
- [Build a TypeScript Client](https://y2.dev/docs/sdks/typescript): Generate Y2 API types and add a small server-side fetch transport

## Workspaces

- [Workspaces](https://y2.dev/docs/workspaces): Switch tenant context, create an organization, invite teammates, and govern shared usage

## Community

- [Contribute to Y2](https://y2.dev/docs/community/contributing): Share useful briefings, report problems, propose documentation fixes, and build integrations safely
- [Community](https://y2.dev/docs/community): Discover, follow, and publish public InfoOps briefing profiles
- [Browse Public Briefings](https://y2.dev/docs/community/signals): Find, inspect, follow, and manage community and Agent Y2 briefing profiles

## affiliate-program

- [Join and Manage the Affiliate Program](https://y2.dev/docs/affiliate-program): Enroll from Settings, share your referral link, read your dashboard, and maintain payout eligibility

## Changelog

- [March 2026 Release Archive](https://y2.dev/docs/changelog/2026-03): Historical Y2 Intelligence Platform release notes from March 2026.
- [June 2026 Release Archive](https://y2.dev/docs/changelog/2026-06): Historical Y2 Intelligence Platform release notes from June 2026.
- [July 2026 Release Archive](https://y2.dev/docs/changelog/2026-07): Historical Y2 Intelligence Platform release notes from July 2026.
- [August 2026 Release Archive](https://y2.dev/docs/changelog/2026-08): Historical Y2 Intelligence Platform release notes from August 2026.
- [Platform Changelog](https://y2.dev/docs/changelog): Current Y2 Intelligence Platform release notes and dated monthly archives.

## Chat

- [Intelligence Chat](https://y2.dev/docs/chat): Use ZDR-routed models, Y2 tools, and plan-based chat credits

## LLM-friendly Documentation

- [LLM-friendly Documentation](https://y2.dev/docs/llms): Reference for Y2 documentation artifacts used by coding agents, retrieval systems, and MCP clients.

## Mission

- [Mission](https://y2.dev/docs/mission): Why Y2 makes continuous, source-aware intelligence accessible to more decision-makers.

## Vision

- [Vision](https://y2.dev/docs/vision): The long-term direction for connected, user-controlled intelligence workflows.