Companies - Salty

Endpoints

Method	Path	Purpose
`GET`	`/companies`	List, paginated
`POST`	`/companies`	Create
`POST`	`/companies/search`	Filter, sort, paginate
`GET`	`/companies/:id`	Fetch one
`PATCH`	`/companies/:id`	Update
`DELETE`	`/companies/:id`	Soft-delete (moves to 30-day trash; restore via POST /trash/companies/:id/restore)

Search

POST /companies/search takes the same structured filter body as people search: operators equals | not_equals | contains | gt | gte | lt | lte | is_null, combinators and | or, custom attributes via custom_attributes.<key>. Filterable fields: id, name, domain, created_at, updated_at.

curl -X POST $SALTY_API/companies/search \
  -H "Authorization: Bearer $SALTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":{"domain":{"equals":"acme.com"}}}'

Fields

Field	Type	Notes
`id`	uuid
`name`	string	Required
`domain`	string \| null	Indexed (case-insensitive)
`custom_attributes`	object	Validated by the schema engine
`created_at`, `updated_at`	datetime

Create

curl -X POST $SALTY_API/companies \
  -H "Authorization: Bearer $SALTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Corp","domain":"acme.com","custom_attributes":{"tier":"enterprise","arr":250000}}'

Validation errors

name is required:

{
  "error": {
    "type": "invalid_request",
    "code": "validation_failed",
    "message": "Required",
    "param": "name"
  }
}