---
agentTools:
  projectIndex: https://docs.marbleapi.com/llms.txt
---

# Patch Authorization

Patches an authorization for a specific owner and resource.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Public",
    "version": "21.09"
  },
  "servers": [
    {
      "url": "https://api.marbleapi.com"
    }
  ],
  "paths": {
    "/authorizations": {
      "patch": {
        "tags": [
          "Authorizations"
        ],
        "summary": "Patch Authorization",
        "description": "Patches an authorization for a specific owner and resource.",
        "operationId": "authorizations-patch-authorization",
        "parameters": [
          {
            "$ref": "#/components/parameters/apiVersion"
          },
          {
            "name": "owner",
            "in": "query",
            "description": "Owner (must be encoded)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Resource name, can be protected \"~/lives/demographics.read\" or custom \"customResource\"; must be encoded. Please see Authorization schema for more details",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Body payload to send",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchAuthorization"
              },
              "example": {
                "status": "Accepted",
                "signedBase64": "base64://alskdjflakjs"
              }
            }
          }
        },
        "responses": {
          "204": {
            "$ref": "#/components/responses/204NoContent"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BadRequest": {
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string",
                  "example": "An error has occurred."
                },
                "message": {
                  "type": "string",
                  "example": "One or more validations errors occurred."
                },
                "field": {
                  "type": "string",
                  "example": "givenName"
                }
              }
            }
          }
        }
      },
      "PatchAuthorization": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "Accepted",
              "Rejected"
            ],
            "example": "Accepted"
          },
          "signedBase64": {
            "type": "string",
            "description": "A base 64 string representing the file.",
            "example": "base64://alskdjflakjs"
          }
        }
      }
    },
    "securitySchemes": {
      "apiKeyHeader": {
        "type": "apiKey",
        "name": "Api-Key",
        "in": "header"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Always required, obtain one using your Client Id and Client Secret"
      }
    },
    "parameters": {
      "apiVersion": {
        "name": "api-version",
        "in": "query",
        "description": "API Version",
        "schema": {
          "type": "string",
          "default": "21.09"
        }
      }
    },
    "responses": {
      "204NoContent": {
        "description": "No Content <br><br>Returned when the HTTP request was successful."
      },
      "400BadRequest": {
        "description": "Bad Request <br><br>Returned when there is an error in the validation in any of the fields.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/BadRequest",
              "example": {
                "errors": [
                  {
                    "code": "An error has occurred.",
                    "message": "One or more validations errors occurred.",
                    "field": "givenName"
                  }
                ]
              }
            }
          }
        }
      },
      "403Forbidden": {
        "description": "Forbidden <br><br>Returned when there are no authorizations for the specific resource."
      },
      "404NotFound": {
        "description": "Resource not found <br><br>Returned when the specific resource could not be found, or does not exist."
      }
    }
  },
  "security": [
    {
      "bearerAuth": [],
      "apiKeyHeader": []
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 99,
      "1": 129,
      "2": 102,
      "3": 174,
      "4": 222,
      "5": 237,
      "6": 125,
      "7": 0,
      "8": 30,
      "9": 225,
      "10": 38,
      "11": 162
    }
  }
}
```