La referencia de la API se publica en inglés.
Apply an organization import (legacy route)
/api/companies/importApply an organization import (legacy route).
Accepts either the inline JSON body (application/json) or the raw organization package uploaded as a compressed zip (multipart/form-data with a package file field plus a JSON meta field, or a bare application/zip body with the meta JSON in the meta query parameter); the zip is unzipped server-side into the same import bundle. Callers can opt into asynchronous processing: trusted Cloud tenants set the x-veyra-cloud-async-import: 1 header (browsers cannot — the Cloud harness proxy strips inbound x-veyra-cloud-* headers), while board sessions use the proxy-safe ?async=1 query parameter. Either way the server responds 202 with a job id and status URL instead of holding the connection open for the whole import. While a board actor already has an async job running, a resubmit returns 409 carrying the running job's id and status URL. Jobs are held in memory and are lost on restart.
Autorización
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Cómo funcionan las claves.
Parámetros de consulta
one of: "1"Cuerpo de la solicitud
application/json · obligatorio
one of: "rename", "skip", "replace"Respuestas
details names each field that failed.Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites.