# Evolv AI

> Evolv AI (formerly Sentient Ascend) is an experience optimization and autonomous experimentation platform. Its Participant API and official client SDKs allocate visitors to experiment variants, deliver optimized configurations, and ingest behavioral events so machine learning can continuously test and personalize web and app experiences.

Generated by the API Evangelist enrichment pipeline (2026-08-13) from the Evolv APIs.json profile and repository artifacts. Evolv publishes no OpenAPI; the machine-readable contract it does publish is a Postman Collection v2, saved verbatim in this repo. Evolv's own /llms.txt does not exist — probed on evolv.ai (401), www.evolv.ai (301->401), developers.evolv.ai (404) and participants.evolv.ai (403).

## API
- [Evolv Participant API](https://developers.evolv.ai/): Runtime edge API — base https://participants.evolv.ai/v1, versioned in the path. Seven operations: GET configuration, GET/POST allocations, GET/POST/PATCH events, GET preallocations. Keyed by a public environment id in the path plus a participant uid.

## Contract
- [Postman Collection v2 (Evolv-published, verbatim)](postman/evolv-participant-api.postman_collection.json)
- [Response examples from that collection](examples/)

## Docs
- [Developer portal / API reference (Postman documenter)](https://developers.evolv.ai/)
- [JavaScript SDK reference](https://media.evolv.ai/javascript-sdk/releases/latest/docs/EvolvClient.html)
- [GitHub organization](https://github.com/evolv-ai)
- [Evolv Manager console (login)](https://app.evolv.ai)

## SDKs
- [JavaScript @evolv/client](https://www.npmjs.com/package/@evolv/client) — stable 2.11.1 (2024-08-26); newer work ships only on the `next` alpha tag
- [React @evolv/react](https://www.npmjs.com/package/@evolv/react) — 1.2.0 (2023-10-19)
- [iOS EvolvKit](https://github.com/evolv-ai/ios-sdk) — tag 1.2.1 (2025-08-02)
- [Android ai.evolv](https://github.com/evolv-ai/android-sdk) — no tags, no registry artifact
- [PHP evolv/php-sdk](https://packagist.org/packages/evolv/php-sdk) — 1.0.5 (2022-12-13)
- [Experiment Management CLI (Python)](https://github.com/evolv-ai/experiment-management-cli) — 1.0.3 (2019-09-13), source install only

## Agent skills
- [Allocate a participant](skills/evolv-allocate-participant.md)
- [Record events](skills/evolv-record-events.md)
- [Offline preallocations](skills/evolv-offline-preallocations.md)

## Artifacts
- [Packages](packages/evolv-packages.yml)
- [Authentication](authentication/evolv-authentication.yml)
- [Conventions](conventions/evolv-conventions.yml)
- [Errors](errors/evolv-problem-types.yml)
- [Data model](data-model/evolv-data-model.yml)
- [Rate limits](rate-limits/evolv-rate-limits.yml) — none published
- [Plans / pricing](plans/evolv-plans-pricing.yml) — none published, enterprise contact-sales
- [Sandbox](sandbox/evolv-sandbox.yml)
- [Lifecycle](lifecycle/evolv-lifecycle.yml)
- [Changelog](changelog/evolv-changelog.yml)
- [CLI](cli/evolv-cli.yml)
- [MCP (candidate — no server exists)](mcp/evolv-mcp.yml)
- [Conformance](conformance/evolv-conformance.yml)
- [Well-known probe](well-known/evolv-well-known.yml) — no documents served
- [Domain security](security/evolv-domain-security.yml)

## Notes for agents
- No idempotency key and no de-duplication on any write. Retrying an event double-counts a conversion.
- No rate-limit headers of any family; no Retry-After. There is no budget signal to read.
- Errors are `{"msg":"..."}` JSON with no code — except the configuration route, which returns S3 XML on 403.
- Event writes return 202 with an empty body: accepted, not confirmed. There is no event id and no read-back.
- Batch event ingestion is PATCH, not POST.
- The evolv.ai marketing site currently returns HTTP 401 (Squarespace "Private Site") on every path, so pricing, terms, privacy and support pages are unreachable anonymously. The API, docs and console are all live.