Run the permit engine

Módulo Safety

POST/permit-requirements/generatepermitRequirements.generate

Runs the jurisdiction permit engine for a project and writes its permit requirements. An unpopulated jurisdiction returns a 422 `NO_ANSWER` refusal; it never passes. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.

Requiere la capacidad safety.permit.write.
Alcances de OAuth: safety.
Envía el encabezado Idempotency-Key. Una repetición con la misma clave devuelve la respuesta original.
Estados de error: 400, 401, 409, 422, 429. Los errores son detalles de problema RFC 9457.

Cuerpo de la solicitud: PermitEngineRequest

permitRequirements.generate: PermitEngineRequest
Campo	Tipo	Obligatorio	Descripción
project_id	string (uuid)	Sí

{
  "project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"
}

Respuesta 200: PermitRequirementPage

permitRequirements.generate: PermitRequirementPage
Campo	Tipo	Obligatorio	Descripción
data	array of PermitRequirement	Sí	Items on this page, in the documented default order.
next_cursor	string \| null	Sí	Opaque cursor for the next page; null on the last page.

{
  "data": [
    {
      "id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "org_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "created_at": "2026-10-08T14:30:00Z",
      "created_by": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "updated_at": "2026-10-08T14:30:00Z",
      "updated_by": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "rule": "Assembly occupancy",
      "jurisdiction_id": "US-FL",
      "permit": "Certificate of occupancy",
      "ahj": "City Building and Fire",
      "permit_state": "Proposed",
      "lead_time": "4-6 wks",
      "trigger_type": "project",
      "record_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"
    }
  ],
  "next_cursor": null
}

Ejemplos de código

curl -X POST "$XOS_BASE_URL/permit-requirements/generate" \
  -H "Authorization: Bearer $XOS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"}'

const { data } = await xos.permitRequirements.generate({
    "project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"
  });

response = xos.permit_requirements.generate({"project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"})

xos permit-requirements generate --data '{"project_id":"0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"}'