Suggest a catalog binding

Módulo Settings

POST/aurora/bind-codeaurora.bindCode

Suggests the catalog element an unknown scanned code identifies, only from the candidates given, and proposes `catalogBindings.create` for confirmation. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.

Requiere la capacidad home.dashboard.read.
Alcances de OAuth: home.
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: AuroraBindCodeRequest

aurora.bindCode: AuroraBindCodeRequest
Campo	Tipo	Obligatorio	Descripción
code	string	Sí	The scanned code.Restricciones: length 1 to 100
description	string \| null	Sí	What the label said.Restricciones: length 1 to 300
candidates	array of object	Sí	Catalog elements found for the code.

{
  "code": "0012345678905",
  "description": "LED PANEL 500MM",
  "candidates": [
    {
      "element_id": "9000.02.03-NWL-0001",
      "name": "LED Wall Panel",
      "urid": "9000.02.03"
    }
  ]
}

Respuesta 200: AuroraResult

aurora.bindCode: AuroraResult
Campo	Tipo	Obligatorio	Descripción
outcome	"answer" \| "no_answer" \| "failed"	Sí	answer, no_answer (the data does not support an answer; `missing` says why) or failed (the model call failed and was logged).
ai_generated	true	Sí	Always true: the content is AI-generated and is labeled so (EU AI Act Article 50).
request_id	string (uuid) \| null	Sí	Identifier of the logged AI request; null when no model was called.
model	string \| null	Sí	Model that answered.Restricciones: length 1 to 100
missing	string \| null	Sí	What the data lacks, for no_answer.Restricciones: length 1 to 500
failure_code	string \| null	Sí	Why the request failed.Restricciones: length 1 to 64
answer	object	No	The feature's answer for outcome answer, shaped per operation; null otherwise.
suggestions	array of AuroraProposal	Sí	Changes stored for confirmation.

{
  "outcome": "answer",
  "ai_generated": true,
  "request_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "model": "claude-sonnet-5-5",
  "missing": "No budget lines exist yet.",
  "failure_code": "model_error",
  "answer": {
    "text": "One permit is blocked: Fire Marshal Permit.",
    "citations": []
  },
  "suggestions": [
    {
      "suggestion_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
      "operation_id": "savedViews.create",
      "summary": "Save the view Blocked Miami Permits."
    }
  ]
}

Ejemplos de código

curl -X POST "$XOS_BASE_URL/aurora/bind-code" \
  -H "Authorization: Bearer $XOS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"code":"0012345678905","description":"LED PANEL 500MM","candidates":[{"element_id":"9000.02.03-NWL-0001","name":"LED Wall Panel","urid":"9000.02.03"}]}'

const { data } = await xos.aurora.bindCode({
    "code": "0012345678905",
    "description": "LED PANEL 500MM",
    "candidates": [
      {
        "element_id": "9000.02.03-NWL-0001",
        "name": "LED Wall Panel",
        "urid": "9000.02.03"
      }
    ]
  });

response = xos.aurora.bind_code({"code": "0012345678905", "description": "LED PANEL 500MM", "candidates": [{"element_id": "9000.02.03-NWL-0001", "name": "LED Wall Panel", "urid": "9000.02.03"}]})

xos aurora bind-code --data '{"code":"0012345678905","description":"LED PANEL 500MM","candidates":[{"element_id":"9000.02.03-NWL-0001","name":"LED Wall Panel","urid":"9000.02.03"}]}'