# Simon Cullen - Agent Guidance

This website exposes a machine-consumable API for profile retrieval and interaction workflows.

## Canonical API URLs

- OpenAPI: https://simon-cullen.com/api/openapi.yaml
- API Base: https://simon-cullen.com/api/v1
- Portal: https://simon-cullen.com/api
- Agent Manifest: https://simon-cullen.com/.well-known/agent.json

## Recommended Discovery Flow

1. GET /api/v1/person
2. GET /api/v1/person/contact-policy
3. GET /api/v1/person/availability
4. Submit interaction only if request aligns with contact policy.

## Endpoint Semantics

- `/api/v1/person*` endpoints are read-only profile metadata.
- `/api/v1/interactions/*` endpoints are write/status workflow endpoints.
- `/api/v1/admin/*` endpoints require `X-Admin-Token`.
- `/api/entries*` is retired and returns `410 Gone`.

## Write Interaction Rules

- Use Idempotency-Key for every POST.
- Keep submissions concise and high-signal.
- Avoid spam, harassment, phishing, and abusive content.
- Expect asynchronous processing and status polling.
- Respect rate limits and retry after receiving `429`.

## Primary write endpoints

- POST /api/v1/interactions/messages
- POST /api/v1/interactions/meeting-requests
- GET /api/v1/interactions/{id}