MARS documentation
API reference

Delete entry

Contract and client context

Operation: delete_entry · HTTP: DELETE /v1/entries/{did}

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.

Exact operation definition
{
  "operationId": "delete_entry",
  "parameters": [
    {
      "description": "OAS DID of the entry",
      "in": "path",
      "name": "did",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Required route-scoped idempotency key",
      "in": "header",
      "name": "Idempotency-Key",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "204": {
      "description": "Entry revoked"
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "SIWS session missing or invalid"
    },
    "403": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Session publisher mismatch"
    },
    "404": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Entry not found"
    },
    "429": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "Write rate limit exceeded"
    }
  },
  "security": [
    {
      "siwsSession": []
    },
    {
      "siwsCookie": []
    }
  ],
  "tags": [
    "entries"
  ]
}

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

DELETE/v1/entries/{did}

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

did*string

OAS DID of the entry

Header Parameters

Idempotency-Key*string

Required route-scoped idempotency key

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/entries/string" \  -H "Idempotency-Key: string"
Empty