# Venn

> Venn is a multifamily resident-experience operating system for owner-operators:
> a resident mobile app, an operator dashboard, and a single data layer over leasing,
> onboarding, living, renewals and an AI concierge, synced with the property
> management systems of record (Yardi, RealPage, Entrata, AppFolio). Founded 2016,
> co-headquartered in New York and Tel Aviv.

This file was GENERATED by API Evangelist from public sources. Venn does not
publish an llms.txt — https://venn.city/llms.txt returns 404, and docs.venn.city
answers 200 with an HTML shell for every path including one that cannot exist.

## What Venn actually exposes

- Venn has a real, unversioned GraphQL API at https://api.venn.city/production/graphql
  (Apollo Federation gateway, AWS API Gateway edge).
- **Anonymous introspection is enabled** on that endpoint: 1,983 types, 320 query
  fields, 357 mutation fields, no subscriptions. The contract is readable.
- **Data is not.** An unauthenticated read returns `VennUnknownError` from the
  `persistency` subgraph. Auth is a bearer JWT from Venn's AWS Cognito user pool.
- There is **no developer portal, no API reference, no OpenAPI, no AsyncAPI, no
  webhook catalog, no MCP server, no agent card, no sandbox, no published rate
  limits and no published pricing.** Every one of those was probed in this pass.

## Contract

- GraphQL SDL (1,983 types, printed from live introspection): graphql/venn-tenant.graphql
- Data model / entity graph (139 entities, 10 domains): data-model/venn-data-model.yml
- API conventions — pagination, filtering, tracing, reversibility: conventions/venn-conventions.yml
- Error codes observed on the wire: errors/venn-error-codes.yml
- Authentication (Cognito bearer JWT, per-user API keys): authentication/venn-authentication.yml
- OIDC scopes: scopes/venn-scopes.yml
- Standards conformance: conformance/venn-conformance.yml
- Lifecycle and versioning: lifecycle/venn-lifecycle.yml
- Rate limits (none published, none signalled): rate-limits/venn-rate-limits.yml
- Plans and pricing (none published): plans/venn-plans-pricing.yml
- .well-known probe (no document served from any Venn host): well-known/venn-well-known.yml
- Candidate MCP tool surface (derived, no server exists): mcp/venn-mcp.yml

## Agent skills (generated, grounded in verified operations)

- List residents in a building or community: skills/venn-list-residents.md
- Book and cancel a shared space: skills/venn-book-shared-space.md
- Broadcast to a community: skills/venn-broadcast-to-community.md
- Index: skills/_index.yml

## Packages

- npm scope `@venncity` — 20 first-party packages: packages/venn-packages.yml
- `@venncity/extension-sdk` 0.1.1 (2026-08-25) — the Venn Extensions host/guest
  bridge, the only integration-facing SDK Venn ships: components/venn-components.yml
- `@venncity/bi-events` 0.13.9 (2026-07-26) — typed BI event catalog

## Release notes

- https://docs.venn.city/ — 65 dated releases, 2026-05-15 to 2026-09-01, roughly
  4-5 per week, backend and frontend versioned separately (latest v2.4.58 / v3.25.59).
  The site is a client-rendered SPA with no feed; structured here:
  changelog/venn-changelog.yml

## Company

- Site: https://venn.city/
- About: https://venn.city/about
- Solutions: Venn Leasing, Venn Onboarding, Venn Living, Venn Concierge, Venn Renew, Venn RMS
- Operator login: https://dashboard.venn.city/
- Terms: https://venn.city/terms
- Privacy: https://venn.city/privacy
- GitHub: https://github.com/venn-city
- Careers: https://job-boards.greenhouse.io/venncity
- Talk to sales: https://venn.city/book-a-demo

## Notes for agents

- Every GraphQL error returns HTTP 200. Branch on `errors[].extensions.code`,
  never on the status line.
- `first` or `last` is mandatory on every list field, or the gateway rejects the
  query with `pagination_enforce_error`.
- Idempotency exists on exactly one entity (`Notification.idempotencyKey`). Every
  other write — payments, bookings, broadcasts, contracts — is unprotected against
  retry. Query before you retry.
- Deletes are soft (`deleted` / `deletedAt`). No restore mutation and no retention
  window is published.
- Reversal operations exist (`cancelBooking`, `cancelSubscriptionContract`,
  `requestCancelationServiceProductOrder`) but no window is documented for any of
  them. Do not assume one.

Profile maintained by API Evangelist. This is not Venn's own file.
Corrections: https://github.com/api-evangelist/venn/issues