Companies

Nombre obligatorio. Upsert por domain.

Contenido oficial AivyroAlineado con el contrato público actual

POST/api/v1/companies

name es obligatorio en create y no puede ir vacío en PATCH. domain ejemplo: analytical.example. Lookup por domain (miss es data: []). q busca name/domain.

HTTP	Path	Scope
GET	`/api/v1/companies`	`rest.crm.companies.read`
POST	`/api/v1/companies`	`rest.crm.companies.write`
POST	`/api/v1/companies/upsert`	`rest.crm.companies.write`
GET	`/api/v1/companies/{id}`	`rest.crm.companies.read`
PATCH	`/api/v1/companies/{id}`	`rest.crm.companies.write`

Query

Parámetro	Tipo	Notas
domain	string	Lookup. Miss es data: [].
q	string	Busca name y domain.
limit / cursor	number / string	Página de cursor. limit 1–100.

Campos

Campo	Tipo	Notas
id	UUID	Inmutable.
name	string	Obligatorio en create. No puede PATCH vacío.
domain	string \| null	Ej.: analytical.example. "" guarda null.
owner_id	UUID \| null	El mismo id de GET /members.
tag_ids	UUID[]	Replace total. [] limpia.
created_at / updated_at	datetime	ISO-8601 UTC.

POST /api/v1/companies

curl -sS -X POST "$AIVYRO_API_BASE/api/v1/companies" \
  -H "Authorization: Bearer $AIVYRO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Analytical Engines","domain":"analytical.example"}'