← All tools
Write

Create field job

faenas_create

Create a field job from a published procedure and assign inspectors.

Purpose

When to use it

Create a field job from a published procedure and assign inspectors. Use it only within the authorized organization.

When not to use it

Do not use it for another organization, a different action, or to bypass a confirmation.

Input parameters

ParameterTypeRequirementDetails
organization_idstring (uuid)Required—
work_site_idstring (uuid)Required—
template_version_idstring (uuid)Required—
namestringRequired—
shiftstringRequired—
responsible_namestringRequired—
inspector_idsstring[]Required—

Complete example

Input
{
  "organization_id": "11111111-2222-4333-8444-555555555555",
  "work_site_id": "11111111-2222-4333-8444-555555555555",
  "template_version_id": "11111111-2222-4333-8444-555555555555",
  "name": "Ejemplo operativo",
  "shift": "valor-ejemplo",
  "responsible_name": "Ejemplo operativo",
  "inspector_ids": [
    "11111111-2222-4333-8444-555555555555"
  ]
}
Output
{
  "ok": true,
  "requestId": "req_01JEXAMPLE",
  "data": {
    "result": "Respuesta resumida de Voltline"
  }
}

Errors and recovery

authentication_required

Reconecta Voltline mediante OAuth.

mcp_tool_grant_required

Confirma empresa, membresía activa, grant del cliente y request ID antes de reintentar.

organization_scope_mismatch

Selecciona una empresa incluida en la conexión.

internal_error

Entrega el request ID a soporte; no reenvíes tokens ni archivos.

Audit

Recorded

  • ✓request ID
  • ✓usuario y cliente OAuth
  • ✓empresa y herramienta
  • ✓resultado, duración y hash de argumentos

Never recorded

  • ×token
  • ×prompt completo
  • ×URL firmada
  • ×archivo
  • ×contraseña