---
updatedAt: 2026-06-19T07:26:13.000Z
agentTools:
  projectIndex: https://docs.verify.ibm.com/ibm-security-verify-access/llms.txt
---

# Use this endpoint to submit user consents

As part of authorization flow, consent page may be displayed to collect
consent information from the user based on the scope requested.
This endpoint is used to collect the consent information and continue the flow.


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "IBM Security Verify Access OIDC Provider",
    "description": "This document describes all the API available in IBM Security Verify Access OIDC Provider.\n",
    "version": "0.1.0"
  },
  "servers": [
    {
      "url": "https://{pointofcontact}/oauth2",
      "variables": {
        "pointofcontact": {
          "default": "{pointofcontact}",
          "description": "URL of your IBM Security Verify Access Point of Contact"
        }
      },
      "description": "OIDC Provider"
    }
  ],
  "paths": {
    "/consents": {
      "post": {
        "tags": [
          "Consents Endpoint"
        ],
        "summary": "Use this endpoint to submit user consents",
        "description": "As part of authorization flow, consent page may be displayed to collect\nconsent information from the user based on the scope requested.\nThis endpoint is used to collect the consent information and continue the flow.\n",
        "operationId": "postConsents",
        "parameters": [
          {
            "$ref": "#/components/parameters/StateID"
          }
        ],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/ConsentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/AuthorizePageResponse"
          },
          "302": {
            "$ref": "#/components/responses/AuthorizeRedirectResponse"
          },
          "400": {
            "$ref": "#/components/responses/UserErrorPage"
          },
          "500": {
            "$ref": "#/components/responses/UserErrorPage"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AuthorizeResponse": {
        "type": "object",
        "description": "authorization response",
        "properties": {
          "code": {
            "description": "The authorization code generated by the authorization server.",
            "type": "string"
          },
          "id_token": {
            "description": "ID Token (JWT) associated with the authenticated session.",
            "type": "string"
          },
          "access_token": {
            "description": "The access token issued by the authorization server.",
            "type": "string"
          },
          "token_type": {
            "description": "The type of the token issued.",
            "type": "string",
            "enum": [
              "Bearer"
            ]
          },
          "expires_in": {
            "description": "The lifetime in seconds of the access token.",
            "type": "number"
          },
          "scope": {
            "description": "Space-delimited string containing the scope associated with the access token",
            "type": "string"
          },
          "state": {
            "description": "An opaque value used by the client to maintain state between the request and callback\n",
            "type": "string"
          }
        }
      },
      "ConsentRequest": {
        "type": "object",
        "description": "consents request",
        "required": [
          "trust_level"
        ],
        "properties": {
          "trust_level": {
            "description": "User decision whether to give consents or not",
            "type": "string",
            "enum": [
              "permit",
              "deny"
            ]
          },
          "scope": {
            "description": "Consented OAuth 2.0 scope",
            "type": "string"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "description": "Error code defined by OAuth specification.",
            "type": "string"
          },
          "error_description": {
            "description": "Text providing additional information, used to assist the client developer in understanding the error that occurred",
            "type": "string"
          },
          "error_uri": {
            "description": "A URI identifying a human-readable web page with information about the error, used to provide the client developer with additional information about the error.",
            "type": "string"
          },
          "state": {
            "description": "The value of \"state\" parameter received in the client authorization request.\n",
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "parameters": {
      "StateID": {
        "name": "stateId",
        "in": "query",
        "description": "State identifier",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    },
    "responses": {
      "AuthorizePageResponse": {
        "description": "Authorization page response",
        "content": {
          "text/html": {
            "schema": {
              "oneOf": [
                {
                  "description": "Consent page"
                },
                {
                  "$ref": "#/components/schemas/AuthorizeResponse"
                }
              ]
            }
          }
        }
      },
      "AuthorizeRedirectResponse": {
        "description": "Authorization redirection response",
        "headers": {
          "location": {
            "description": "",
            "schema": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/AuthorizeResponse"
                },
                {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              ]
            }
          }
        }
      },
      "UserErrorPage": {
        "description": "OAuth error page"
      }
    }
  }
}
```