Functions

Importa una Función desde su manifiesto. Una Función nueva aterriza DESACTIVADA. Body: { doc, target_function_id?, flow_binding? }. Con target_function_id actualiza esa Función en vez de duplicarla (idempotente).

Una Función nueva aterriza desactivada: importar no la pone a disposición de ningún Met, hay que activarla y vincularla. Con target_function_id actualiza esa Función en vez de duplicarla, que es lo que hace repetible el despliegue desde un repositorio.

post/workspaces/{workspaceId}/functions/import

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/functions/import
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Path parameters

workspaceIdnumber required

ID numérico del workspace. Debe ser el mismo workspace de tu API key: pedir otro devuelve 401.

Request body

flow_bindingstring

ID del flujo local que atiende la Función, cuando el manifiesto trae flow_ref. Sin esto la Función se importa sin handler y desactivada.

target_function_idnumber

Actualiza esta Función en vez de crear una nueva. Es lo que hace el import idempotente en un pipeline que corre en cada despliegue.

Example request

{
  "doc": {
    "content_hash": "a3f1c9…",
    "dependencies": [
      {
        "kind": "workspace_variable",
        "name": "API_TOKEN_PEDIDOS",
        "purpose": "Bearer token con el que Meteor autentica la llamada",
        "ref": "workspace_variable:API_TOKEN_PEDIDOS"
      }
    ],
    "exported_at": "2026-08-29T18:40:11.900Z",
    "function": {
      "activo": true,
      "descripcion": "Consulta el estado de un pedido por su número",
      "function_prompt": "Úsala solo cuando el cliente mencione un número de pedido.",
      "http": {
        "auth_workspace_variable": "API_TOKEN_PEDIDOS",
        "last_probe": {
          "checked_at": "2026-08-29T18:40:11.900Z",
          "code": "endpoint_not_found",
          "duration_ms": 143,
          "http_status": 200,
          "message": "El endpoint respondió 200 a un HEAD. Está vivo y alcanzable.",
          "method": "HEAD",
          "mode": "safe",
          "status": "ok"
        },
        "method": "POST",
        "probe": "safe",
        "sign_secret_variable": "FIRMA_PEDIDOS",
        "timeout_ms": 30000,
        "url": "https://api.tu-empresa.com/pedidos"
      },
      "nombre": "consultar_pedido",
      "parameters": [
        {
          "description": "Número de la orden que el cliente quiere consultar",
          "enum_values": [
            "abierto",
            "cerrado"
          ],
          "name": "order_id",
          "required": true,
          "save_to": "ultimo_pedido",
          "type": "string"
        }
      ],
      "ref": "function:consultar_pedido",
      "required_tools": [
        "check_menu"
      ],
      "version": 3
    },
    "kind": "meteor.function",
    "schema_version": 1,
    "source": {
      "function_ref": "function:consultar_pedido",
      "workspace_id": 7
    }
  },
  "flow_binding": "5f0a1e3c-9b2d-4a77-8f31-6c1d0e2b4a99",
  "target_function_id": 812
}

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "action": "created",
    "function_id": 812,
    "version": 4
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.