# Relm

> API-first, AI-native CRM. The CRM for LLMs and developers.

Base URL: https://relmcrm.com
Authentication: Authorization: Bearer sk_live_... (or sk_test_...)

## API Reference
- OpenAPI 3.1 spec: /openapi.yaml
- Long-form LLM reference: /llms-full.txt
- Human docs: /docs
- Changelog (HTML): /changelog
- Changelog (RSS): /changelog.rss

## Core resources
- POST/GET /v1/contacts, /v1/contacts/:id (PATCH, DELETE)
- POST /v1/contacts/batch — bulk upsert with dedup_on: ["email"]
- POST/GET /v1/companies, /v1/companies/:id
- POST/GET /v1/deals, /v1/deals/:id
- POST/GET /v1/activities, /v1/activities/:id
- GET  /v1/search?q=...

## Schema & associations
- POST/GET /v1/schema/fields — custom fields on contact/company/deal/activity
- POST/GET /v1/associations — polymorphic edges between any two records

## Webhooks
- POST/GET /v1/webhooks — subscribe an endpoint
- POST /v1/webhooks/:id/replay/:deliveryId — replay a delivery
- Payload signed with HMAC-SHA256, header: relm-signature: t=<unix>,v1=<hex>

## Conventions
- Idempotency-Key header on any POST — replays within 24h return the cached response
- Cursor pagination: list endpoints return { data, has_more, next_cursor }
- Filters: ?filter[field][op]=value  (eq, neq, gt, gte, lt, lte, ilike, in)
- Rate limit headers: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset
- Version header: relm-version