MARS documentation
API reference

Retry anchor

Gated integration — source implementation does not establish live activation.

Contract and client context

Operation: retry_anchor · HTTP: POST /v1/admin/anchors/{intent_id}/retry

Use an operator-supplied registry base URL. Request execution is disabled in this documentation explorer. Generated request snippets are templates, not signed or authorized submissions.

External anchor activation is gated. Local status or intent mutation does not prove a finalized Sigil transaction.

Exact operation definition
{
  "operationId": "retry_anchor",
  "parameters": [
    {
      "description": "Durable anchor intent identifier",
      "in": "path",
      "name": "intent_id",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Required route-scoped idempotency key",
      "in": "header",
      "name": "Idempotency-Key",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AnchorControlResponse"
          }
        }
      },
      "description": "Intent requeued"
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Session missing or invalid"
    },
    "403": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Admin capability missing"
    },
    "404": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Intent not found"
    },
    "409": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Intent state or idempotency conflict"
    }
  },
  "security": [
    {
      "siwsSession": []
    },
    {
      "siwsCookie": []
    }
  ],
  "tags": [
    "trust"
  ]
}

Resolve schema references against the complete OpenAPI document. Standalone schemas and hashes are generated from the same checked-in source.

POST/v1/admin/anchors/{intent_id}/retry

Authorization

AuthorizationBearer <token>

Opaque capability-bearing MARS session issued by an enabled authentication profile.

In: header

Path Parameters

intent_id*string

Durable anchor intent identifier

Header Parameters

Idempotency-Key*string

Required route-scoped idempotency key

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/admin/anchors/string/retry" \  -H "Idempotency-Key: string"
{  "intentId": "string",  "state": "unanchored"}