auth.md - a machine-readable contract of how to authenticate and which endpoints exist - and Cascade builds against it.
Prerequisites
1
Get an API key
Create one in the dashboard or read Authentication. Keys start with
enc_.2
Install Windsurf
Download it from windsurf.com and open your project.
Set up
1
Give Cascade the API contract
Add
https://developer.encrata.com/auth.md to Cascade’s context - paste the
URL into a conversation, or add it as a project rule under .windsurf/rules.
It tells Cascade how to authenticate and lists every endpoint with its
request and response shape.2
Store your key as an environment variable
Never hard-code the key. Keep it in your environment so Cascade’s generated
code reads it from there.
3
Ask Cascade to build against the API
Describe the integration you want. Cascade uses
auth.md to get the endpoint,
request body, and auth header right.Prompt for Cascade
The generated request should hit
https://developer.encrata.com/api/lookup/email/validity
with an Authorization: Bearer enc_... header. If Cascade invents a different
path, re-share auth.md so it works from the contract, not memory.Next steps
auth.md for developers
The full pattern for pointing an agent at Encrata.
Examples
Copy-paste recipes for every lookup.
Authentication
Create and manage your API keys.
API reference
Every endpoint’s request and response schema.