---
title: "Propose Action"
method: POST
path: "/v1/orchestrator/agents/{agent_id}/propose"
tags: ["Agent Orchestrator"]
---

# Propose Action

`POST /v1/orchestrator/agents/{agent_id}/propose`

## Request

- Base URL: `https://api.grafomem.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grafomem.com/v1/orchestrator/agents/{agent_id}/propose`
- Auth: none declared

PR-0 — record a CGR-attributed governed decision for a proposed tool action
(no LLM run). The decision carries the agent's agent_key + invoice_ref so the agent
becomes CGR-scorable. Edge-gate/HITL enforcement arrives in later PRs.

## Path parameters

- `agent_id` string, required

## Request body

- ProposeActionRequest: Request body for POST /v1/orchestrator/agents/{agent_id}/propose (Phase 2, PR-0).
  - `tool` string, required
  - `args` object
  - `invoice_ref` string, required
  - `reason` string
  - `agent_tier` number, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/grafomem/apis/grafomem-cloud.md) · [All operations](https://skmtc.dev/grafomem/apis/grafomem-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/grafomem/apis/grafomem-cloud/revisions/a472af705375?raw)