> ## Documentation Index
> Fetch the complete documentation index at: https://humanity-eaeda8f6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OAuth · Approve authorization

Programmatically approve a pending authorization when operating Humanity’s consent experience server-side (for example, bespoke trust & safety workflows). Supply the `authorization_id` plus an optional subset of scopes to grant. The response returns an authorization code and all metadata necessary for `/oauth/token`.

Most consumer flows should rely on the hosted consent screen; this API is intended for regulated partners that need to stitch Humanity into an existing adjudication queue.


## OpenAPI

````yaml api-reference/openapi.json post /oauth/authorize/approve
openapi: 3.1.0
info:
  version: 0.1.0
  title: hp-public-dev-api-server
  description: NestJS CQRS + TDD base for Humanity Public Dev API
servers:
  - url: https://api.sandbox.humanity.org/v2
    description: Sandbox environment for development and testing
  - url: https://api.humanity.org/v2
    description: Production environment
security: []
tags: []
paths:
  /oauth/authorize/approve:
    post:
      tags: []
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthorizeApproveRequest'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorizeApproveResponse'
components:
  schemas:
    AuthorizeApproveRequest:
      type: object
      properties:
        authorization_id:
          type: string
        scopes:
          type: array
          items:
            type: string
      required:
        - authorization_id
    AuthorizeApproveResponse:
      type: object
      properties:
        authorization_id:
          type: string
        status:
          const: approved
        code:
          type: string
        code_expires_at:
          type: string
        scopes:
          type: array
          items:
            type: string
        granted_scopes:
          type: array
          items:
            type: string
        app_scoped_user_id:
          type: string
        organization_id:
          type: string
        state:
          type: string
        redirect_uri:
          type: string
        client_id:
          type: string
      required:
        - authorization_id
        - status
        - code
        - code_expires_at
        - scopes
        - granted_scopes
        - app_scoped_user_id
        - organization_id
        - redirect_uri
        - client_id

````