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

# Create approval request

> Create approval request

## OpenAPI

````json POST /v1/approval_requests
{
  "openapi": "3.0.4",
  "info": {
    "title": "Confidential Computing Manager",
    "description": "Fortanix Confidential Computing Manager Backend. These are APIs using which the frontend and other clients (compute node agents) interact with Fortanix Confidential Computing Manager functionalities, which include compute node and app enrollment, attestation and signing, and Certificate Authority.",
    "termsOfService": "https://www.fortanix.com/legal/terms/",
    "contact": {
      "name": "Fortanix Support",
      "url": "https://support.fortanix.com/hc/en-us/categories/360003107511-Confidential-Computing-Manager",
      "email": "support@fortanix.com"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://ccm.fortanix.com"
    }
  ],
  "paths": {
    "/v1/approval_requests": {
      "post": {
        "tags": [
          "ApprovalRequests"
        ],
        "summary": "Create approval request.",
        "description": "Create approval request",
        "operationId": "createApprovalRequest",
        "requestBody": {
          "$ref": "#/components/requestBodies/ApprovalRequestRequest"
        },
        "responses": {
          "201": {
            "description": "A newly created approval request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalRequest"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerToken": []
          }
        ],
        "x-auth-resource": "Reader,Writer,Manager"
      }
    }
  },
  "components": {
    "requestBodies": {
      "ApprovalRequestRequest": {
        "description": "Request to create an approval request.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApprovalRequestRequest"
            }
          }
        },
        "required": true,
        "x-bodyName": "body"
      }
    },
    "schemas": {
      "ApprovalRequest": {
        "required": [
          "request_id",
          "requester",
          "created_at",
          "acct_id",
          "group_id",
          "operation",
          "method",
          "approvers",
          "status",
          "expiry"
        ],
        "type": "object",
        "properties": {
          "request_id": {
            "type": "string",
            "description": "UUID uniquely identifying this approval request.",
            "format": "uuid"
          },
          "requester": {
            "$ref": "#/components/schemas/Entity"
          },
          "created_at": {
            "type": "integer",
            "description": "When this approval request was created.",
            "format": "int64"
          },
          "acct_id": {
            "type": "string",
            "description": "The account ID of the account that this approval request belongs to.",
            "format": "uuid"
          },
          "group_id": {
            "type": "string",
            "description": "The group ID where this approval request belongs to.",
            "format": "uuid"
          },
          "operation": {
            "type": "string",
            "description": "Operation URL path, e.g. `/crypto/v1/keys`, `/crypto/v1/groups/<id>`."
          },
          "method": {
            "type": "string",
            "description": "Method for the operation: POST, PATCH, PUT, DELETE, or GET. Default is POST."
          },
          "body": {
            "type": "object"
          },
          "approvers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Entity"
            }
          },
          "denier": {
            "$ref": "#/components/schemas/Entity"
          },
          "denial_reason": {
            "type": "string",
            "description": "Reason given by denier."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Entity"
            }
          },
          "status": {
            "$ref": "#/components/schemas/ApprovalRequestStatus"
          },
          "subjects": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApprovalSubject"
            }
          },
          "description": {
            "type": "string",
            "description": "Optional comment about the approval request for the reviewer."
          },
          "expiry": {
            "type": "integer",
            "description": "When this approval request expires.",
            "format": "int64"
          }
        }
      },
      "ApprovalRequestRequest": {
        "required": [
          "operation"
        ],
        "type": "object",
        "properties": {
          "operation": {
            "type": "string",
            "description": "Operation URL path, e.g. `/crypto/v1/keys`, `/crypto/v1/groups/<id>`."
          },
          "method": {
            "type": "string",
            "description": "Method for the operation: POST, PATCH, PUT, DELETE, or GET. Default is POST."
          },
          "body": {
            "type": "object"
          },
          "description": {
            "type": "string",
            "description": "Optional comment about the approval request for the reviewer."
          }
        },
        "description": "Request to create an approval request."
      },
      "Entity": {
        "type": "object",
        "properties": {
          "user": {
            "type": "string",
            "description": "The user ID of the user who created this entity, if this entity was created by a user.",
            "format": "uuid"
          }
        },
        "description": "An app, user, or plugin ID."
      },
      "ApprovalRequestStatus": {
        "enum": [
          "PENDING",
          "APPROVED",
          "DENIED",
          "FAILED",
          "DENIED_OTHER",
          "PENDING_CHILD",
          "PENDING_OTHER"
        ],
        "type": "string",
        "description": "Approval request status."
      },
      "ApprovalSubject": {
        "type": "object",
        "properties": {
          "workflow": {
            "type": "string",
            "description": "The ID of the workflow being acted upon.",
            "format": "uuid"
          }
        },
        "description": "Identifies an object acted upon by an approval request."
      }
    },
    "securitySchemes": {
      "bearerToken": {
        "type": "apiKey",
        "description": "A JWT bearer token to be passed once authenticated.",
        "name": "Authentication",
        "in": "header"
      }
    }
  }
}
````