Accept a learning proposal

POST/api/public/v1/learning-proposals/{public_id}/accept beta

Applies the proposal through its kind's own operation, with the input_digest the caller read. 409 PROPOSAL_STALE when its inputs moved since it opened (it is then superseded); 409 PROPOSAL_CLOSED when it is no longer open or has expired. A connected agent is refused 403 FORBIDDEN: a proposal is accepted by a person or an API key. The applied operation's own refusals (for example NOT_ATTACHED, INHERITED_HERE, INVALID_PATTERN, NOT_RATIFIED) leave the proposal open.

cURL

curl --fail-with-body -X POST 'https://app.openlatch.ai/api/public/v1/learning-proposals/<proposal_public_id>/accept' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"input_digest":"<input_digest>"}'

Python

import json
import os
import urllib.request

body = '{"input_digest":"<input_digest>"}'
request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/learning-proposals/<proposal_public_id>/accept',
    method='POST',
    data=body.encode(),
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
        'Content-Type': 'application/json',
    },
)
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 POST 'https://app.openlatch.ai/api/public/v1/learning-proposals/<proposal_public_id>/accept' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"input_digest":"<input_digest>"}' | jq .

PowerShell

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
$body = '{"input_digest":"<input_digest>"}'
Invoke-RestMethod -Method POST -Uri 'https://app.openlatch.ai/api/public/v1/learning-proposals/<proposal_public_id>/accept' -Headers $headers -ContentType 'application/json; charset=utf-8' -Body $body | ConvertTo-Json -Depth 20

Authorization

Role in the organization	This endpoint
owner	Allowed
admin	Allowed
editor	Allowed
viewer	Not allowed

A key carries the role its owner holds in the organization. See Authentication.

API key scope: proposals:write

Path parameters

Parameter	Type	Description
public_id	string	Required.

Query parameters

Parameter	Type	Description
zone_id	string (uuid) or null	The deciding zone: a proposal above it answers 404.

Header parameters

Parameter	Type	Description
Idempotency-Key	string or null	Optional. Makes the request safe to retry: the same key and the same request, within 24 hours, returns the stored response with Idempotent-Replayed: true and runs once.

Request body

Field	Type	Description
input_digest	string	Required.

Response

• 200 OK — the call succeeded.
• 400 Bad Request — BAD_REQUEST
• 401 Unauthorized — UNAUTHORIZED
• 402 Payment Required — license_expired
• 403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
• 404 Not Found — NOT_FOUND
• 409 Conflict — CONFLICT, IDEMPOTENCY_IN_PROGRESS, INHERITED_HERE, LOOSENS_LAYER, NOT_ACTIVATABLE, NOT_ATTACHED, NOT_RATIFIED, PROPOSAL_CLOSED, PROPOSAL_STALE, SAME_LAYER_CONFLICT
• 422 Unprocessable Content — IDEMPOTENCY_KEY_REUSED, INVALID_ID, INVALID_PATTERN, VALIDATION_ERROR
• 429 Too Many Requests — TOO_MANY_REQUESTS
• 500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
• 503 Service Unavailable — ENGINE_UNAVAILABLE, FEATURE_STATE_UNAVAILABLE, PROOF_UNAVAILABLE, SERVICE_UNAVAILABLE

Response fields

Field	Type	Description
data	object	Required. One proposal: what would change, why, in which direction, and what was decided.
data.case	object or null
data.case.action_line	object or null
data.case.kind	string	Required.
data.case.outcome_today	object or null
data.changed	object or null
data.changed.sample	array of object
data.changed.to_allow	integer
data.changed.to_ask	integer
data.changed.to_block	integer
data.decided_at	string (date-time) or null
data.decided_by	object or null
data.decided_by.kind	string — one of user, api_key	Required.
data.decided_by.name	string	Required.
data.direction	string — one of tightens, neutral, widens	Required.
data.evidence	object or null
data.evidence.action	object or null	A regression case's reviewed action in plain words, scrubbed; null when a secret still matched.
data.expires_at	string (date-time)	Required.
data.input_digest	string	Required.
data.intent_policy	object or null
data.intent_policy.id	string	Required.
data.intent_policy.sentence	string	Required.
data.kind	string — one of monitor_to_enforce, dictionary_value, decisive_declaration, regression_case	Required.
data.opened_at	string (date-time)	Required.
data.policy	object or null
data.policy.name	string	Required.
data.policy.public_id	string	Required.
data.policy.version	integer	Required.
data.public_id	string	Required.
data.result	object or null
data.state	string — one of open, accepted, dismissed, superseded, expired	Required.
data.table_name	string or null
data.value	string or null
data.zone	object or null
data.zone.id	string	Required.
data.zone.name	string	Required.

Example response

{
  "data": {
    "case": {
      "action_line": "string",
      "kind": "string",
      "outcome_today": "string"
    },
    "changed": {
      "sample": [
        {
          "action": "string",
          "action_line": "string",
          "category": "string",
          "decision_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
          "occurred_at": "2026-01-15T14:32:05Z",
          "verdict_after": "string",
          "verdict_before": "string"
        }
      ],
      "to_allow": 0,
      "to_ask": 0,
      "to_block": 0
    },
    "decided_at": "2026-01-15T14:32:05Z",
    "decided_by": {
      "kind": "user",
      "name": "release-bot"
    },
    "direction": "tightens",
    "evidence": {
      "action": "string"
    },
    "expires_at": "2026-01-15T14:32:05Z",
    "input_digest": "string",
    "intent_policy": {
      "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "sentence": "string"
    },
    "kind": "monitor_to_enforce",
    "opened_at": "2026-01-15T14:32:05Z",
    "policy": {
      "name": "release-bot",
      "public_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "version": 3
    },
    "public_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
    "result": {},
    "state": "open",
    "table_name": "release-bot",
    "value": "string",
    "zone": {
      "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "name": "release-bot"
    }
  }
}

Related

• GET List learning proposals
• GET Read a learning proposal
• POST Dismiss a learning proposal