> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ameo.agiwithai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# REST API v1

> Public JSON API for agents, decisions, verification, and policies.

AMEO exposes a versioned REST API under `/v1/*` on the worker service.

Base URL (production): `https://agentic-micro-economy-os.onrender.com`

## Agents

### Register agent

```bash theme={null}
curl -s -X POST https://agentic-micro-economy-os.onrender.com/v1/agents \
  -H 'Content-Type: application/json' \
  -d '{}'
```

Returns the deployed ERC-8004 identity on Mantle Sepolia.

### Get agent

```bash theme={null}
curl -s https://agentic-micro-economy-os.onrender.com/v1/agents/0
```

## Decisions

### Create decision (full cycle)

```bash theme={null}
curl -s -X POST https://agentic-micro-economy-os.onrender.com/v1/decisions \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"0xB86dC64573089D8DD89C5686010295bB4412D652","action":{"type":"rebalance"},"rationale":"Policy-bound rebalance"}'
```

### List decisions

```bash theme={null}
curl -s 'https://agentic-micro-economy-os.onrender.com/v1/decisions?limit=10&offset=0'
```

### Get decision

```bash theme={null}
curl -s https://agentic-micro-economy-os.onrender.com/v1/decisions/cyc_example
```

## Verify

### Verify settlement transaction

```bash theme={null}
curl -s https://agentic-micro-economy-os.onrender.com/v1/verify/{real_tx_from_/v1/decisions}
```

Returns rationale hash, action type, and Mantlescan URL for an on-chain `DecisionLogged` event.

## Policies

```bash theme={null}
curl -s https://agentic-micro-economy-os.onrender.com/v1/policies
```

## Skills

```bash theme={null}
curl -s https://agentic-micro-economy-os.onrender.com/v1/skills
```

## Errors

Non-2xx responses use:

```json theme={null}
{ "error": { "code": "string", "message": "string", "details": {} } }
```