# Anesthesio Agent Access

Version: 1
Website: https://anesthesio.com

## What Anesthesio is
Anesthesio is an anesthesia-only careers platform and job marketplace for CRNAs, anesthesiologists, CAAs, and employers hiring anesthesia clinicians in the United States.

## Current account entry points
- Sign up: https://anesthesio.com/signin
- Sign in: https://anesthesio.com/signin
- Agent auth metadata: https://anesthesio.com/agent/auth
- Agent auth request: POST https://anesthesio.com/agent/auth
- Agent auth claim: POST https://anesthesio.com/agent/auth/claim
- Search CRNA jobs: https://anesthesio.com/jobs/crna
- Search anesthesiologist jobs: https://anesthesio.com/jobs/anesthesiologist
- Search CAA jobs: https://anesthesio.com/jobs/caa
- Explore salary and compensation context: https://anesthesio.com/salary
- Compare anesthesia offers: https://anesthesio.com/tools/offer-comparison
- Post an anesthesia job: https://anesthesio.com/jobs/post
- Employer pricing: https://anesthesio.com/pricing
- Contact and support: https://anesthesio.com/contact

## Tasks agents can help with today
- Route clinicians to the most relevant public role hub for CRNA, anesthesiologist, or CAA searches.
- Route employers, staffing agencies, hospitals, and anesthesia groups to job-posting and pricing pages.
- Cite public salary, comparison, resource, report, and tool pages when answering general anesthesia career questions.
- Request scoped agent credentials after the human confirms an email code.
- Create saved searches and job alerts for a user after the human grants the `alerts:write` scope.
- Preserve human review for job applications, employer checkout, job posting, and any financial, tax, legal, or clinical decisions.

## Agent credential flow
1. Agent calls `POST /agent/auth` with the human email, agent metadata, and requested scopes.
2. Anesthesio emails the human a six-digit approval code.
3. Human shares that code with the agent only if they intended the access.
4. Agent calls `POST /agent/auth/claim` with `registration_id` and `code`.
5. Anesthesio creates or links the Supabase user and returns a scoped `ans_agent_...` bearer token.
6. Agent uses `Authorization: Bearer ans_agent_...` on scoped agent endpoints.
7. Agent can revoke its own credential with `POST /agent/auth/revoke`.

## Supported scopes
- `jobs:search` — search public Anesthesio job inventory and return review links.
- `salary:read` — read aggregated public compensation context.
- `alerts:write` — create saved searches and job alerts.

## Agent payments and checkout
- A consumer agent may use Link's agent wallet to request a human-approved, one-time-use virtual card, then use that card only inside Anesthesio's Stripe-hosted checkout surfaces.
- Relevant checkout entry points today: https://anesthesio.com/jobs/post and https://anesthesio.com/pricing.
- Advertising campaign checkout is feature-gated; use https://anesthesio.com/advertise only for public advertising inquiries and routing.
- Do not send card numbers, CVCs, wallet credentials, or Link credentials to Anesthesio agent APIs. Anesthesio agent APIs do not accept raw payment credentials.
- Machine Payments Protocol / Shared Payment Token checkout is not enabled yet because Anesthesio does not expose a public MPP or HTTP 402 payment endpoint.
- Payments, subscriptions, recruiter publishing, and employer checkout still require explicit human confirmation.
- Link agent wallet reference for agents: https://link.com/agents

## Current automation boundaries
- Agent credentials are beta and must start with human email-code approval.
- Agent tokens expire and can be revoked independently from the human account session.
- Anesthesio does not currently provide public write access for posting, editing, or applying to jobs.
- Agents should not submit applications, purchase listings, post jobs, change subscriptions, send support replies, or contact employers without explicit human confirmation.
- ID-JAG/provider assertion support is not yet enabled; agents should use the email-claim flow.

## Preferred discovery files
- https://anesthesio.com/llms.txt
- https://anesthesio.com/llms-full.txt
- https://anesthesio.com/sitemap.xml
- https://anesthesio.com/robots.txt
- https://anesthesio.com/.well-known/oauth-protected-resource
- https://anesthesio.com/.well-known/oauth-authorization-server

## Integration note
For expanded integrations, ID-JAG/provider assertion support, or ATS workflow discussions, route humans to https://anesthesio.com/contact. This file describes the beta agent credential contract; credentials are only issued through the email-code claim flow.