Listar los elementos Ask

GET/api/public/v1/asks

cURL

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/asks' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/asks',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

Bash

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/asks' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

PowerShell

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/asks' -Headers $headers | ConvertTo-Json -Depth 20

Autorización

Rol en la organización	Este punto de conexión
owner	Permitido
admin	Permitido
editor	Permitido
viewer	Permitido

Una clave tiene el rol que su propietario ocupa en la organización. Consulte Autenticación.

Ámbito de la clave de API: triage:read

Parámetros de consulta

Parámetro	Tipo	Descripción
zone	string (uuid) or null
agent	string or null
overdue	boolean
page	integer
page_size	integer

Respuesta

• 200 OK — la llamada se completó correctamente.
• 401 Unauthorized — UNAUTHORIZED
• 402 Payment Required — license_expired
• 403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
• 422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
• 429 Too Many Requests — TOO_MANY_REQUESTS
• 500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
• 503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Campos de la respuesta

Campo	Tipo	Descripción
data	array of object	Obligatorio.
data[].action_value_masked	string or null
data[].agent_answer	string — one of approved_in_agent, unanswered_in_agent, unobservable_in_agent or null	What the agent's own prompt came to, when this ASK was also delivered there (mode both): approved_in_agent — the tool ran, so the developer approved it; unanswered_in_agent — nothing ran within ten minutes (refused, abandoned or not delivered — never claimed as a denial); unobservable_in_agent — the agent gives no event to observe the answer. null for an ASK delivered only in the platform, or before any of these is known (AZ-4 D-I16-21, handoff gap 8).
data[].agent_id	string or null
data[].ask_fallback	string — one of allow, block or null	What happens to the agent's action while this ASK is unanswered: allow — it ran and was flagged; block — the agent was denied until someone answers (AZ-4 AC-29). null when the atom is gone.
data[].atom_id	string or null
data[].atom_sentence	string	Obligatorio.
data[].dimension	string or null
data[].first_seen_at	string (date-time)	Obligatorio.
data[].id	string	Obligatorio.
data[].last_seen_at	string (date-time)	Obligatorio.
data[].nudged_at	string (date-time) or null
data[].occurrences	integer	Obligatorio.
data[].overdue	boolean	Obligatorio.
data[].policy_id	string or null
data[].policy_public_id	string or null
data[].policy_status	string or null
data[].recommendation	object or null	The suggested answer drafted for this Ask, when one exists: Allow next time or Block next time, an exception scope and the reasons it rests on. It never applies on its own.
data[].sample_anomaly_id	string or null
data[].scope_proposals	array of object
data[].snoozed_until	string (date-time) or null
data[].zone_id	string or null
page	integer	Obligatorio.
page_size	integer	Obligatorio.
total	integer	Obligatorio.

Ejemplo de respuesta

{
  "data": [
    {
      "action_value_masked": "string",
      "agent_answer": "approved_in_agent",
      "agent_id": "agt_01jbwa2k1vfrn9y42xhgxhmzj2",
      "ask_fallback": "allow",
      "atom_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "atom_sentence": "string",
      "dimension": "string",
      "first_seen_at": "2026-01-15T14:32:05Z",
      "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "last_seen_at": "2026-01-15T14:32:05Z",
      "nudged_at": "2026-01-15T14:32:05Z",
      "occurrences": 3,
      "overdue": false,
      "policy_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "policy_public_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "policy_status": "string",
      "recommendation": {
        "drafted_at": "2026-01-15T14:32:05Z",
        "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
        "language": "string",
        "provenance": "model",
        "reasons": [
          {
            "cites": [
              "string"
            ],
            "text": "Never push to main without a review."
          }
        ],
        "scope": "exact_action",
        "status": "drafting",
        "verdict": "allow"
      },
      "sample_anomaly_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "scope_proposals": [
        {
          "covers": "string",
          "proposed_by": "system",
          "scope": "exact_action"
        }
      ],
      "snoozed_until": "2026-01-15T14:32:05Z",
      "zone_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10"
    }
  ],
  "page": 1,
  "page_size": 3,
  "total": 3
}

Véase también

• GET Anomalías
• GET Detalle de una anomalía
• PATCH Modificar una anomalía