Submit an endpoint
settled_submitFree, rate-limited. Queue an x402 endpoint URL for indexing. Use when: settled_check or settled_peek reports the URL as unknown or not indexed. Not for: URLs already indexed (it just returns their status) or non-x402 URLs. After: wait a few minutes, then call settled_check; the first probe runs within minutes. Idempotent.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "settled_submit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Full URL of an x402 endpoint to add to Settled's index |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | true when accepted | |
| hint | No | What to call next | |
| error | No | Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it | |
| queued | No | true when queued for its first probe | |
| status | No | Its current status, if already indexed | |
| attestation | No | EIP-191 signature over the answer; verify it with settled_verify or any EVM library | |
| attested_at | No | When Settled signed this answer (ISO 8601) | |
| next_check_at | No | When it will next be probed | |
| already_indexed | No | true when Settled already tracks it |