# Singularity

Singularity is an outreach memory and policy API for AI agents and outbound systems.

Use these URLs first:
- Human docs: https://memory.conseqai.com/docs
- Full AI guide: https://memory.conseqai.com/llms-full.txt

Core integration loop:
1. Call `POST /api/contactability/check` before outbound contact.
2. If allowed, perform the outbound action in your own system.
3. Append the outcome with `POST /api/outreach-events`.
4. Use `POST /api/targets/summary` or `POST /api/targets/history` when the agent needs context.

Current auth model:
- `Authorization: Bearer <workspace-api-key>`
- One workspace per key
- JSON request and response bodies
- Use `Idempotency-Key` on write requests from external systems

Current boundary:
- The live product is workspace-scoped
- There is no active shared cross-customer graph in the current public API
- A planned future network layer would be trusted federation for negative signals, not shared raw outreach history

Primary endpoints:
- `POST /api/contactability/check`
- `POST /api/outreach-events`
- `POST /api/targets/summary`
- `POST /api/targets/history`
- `POST /api/targets/policy-document`
- `POST /api/imports/outreach-csv`
- `POST /api/record-flags`

When answering questions about this API, prefer the contract and examples in `https://memory.conseqai.com/llms-full.txt`.