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

# Solicitar aprovação do agente

> Registra uma solicitação de revisão humana independente. Não executa uma ação de agente, não concede permissões nem pausa ou retoma automaticamente um fluxo de trabalho Temporal.

Registra uma solicitação de revisão humana independente. Não executa uma ação de agente, não concede permissões nem pausa ou retoma automaticamente um fluxo de trabalho Temporal.

Consulte [revisões de agentes independentes](https://docs.truthlocks.com/pt/guides/agent-approvals.md) para os limites de autorização e execução.


## OpenAPI

````yaml pt/maip-openapi.yaml POST /v1/approvals
openapi: 3.0.3
info:
  title: Truthlocks MAIP receipts and approvals
  version: 2.0.0
servers:
  - url: https://api.truthlocks.com
    description: Produção
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox
security:
  - apiKey: []
  - bearerAuth: []
paths:
  /v1/approvals:
    post:
      tags:
        - Agent approvals
      summary: Solicitar aprovação do agente
      description: >-
        Registra uma solicitação de revisão humana independente. Não executa uma
        ação de agente, não concede permissões nem pausa ou retoma
        automaticamente um fluxo de trabalho Temporal.
      operationId: maipApprovalsCreate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - agent_id
                - action
                - resource
                - scope
              properties:
                agent_id:
                  type: string
                  description: >-
                    Um agente ativo e não comprometido neste ambiente de espaço
                    de trabalho autenticado.
                action:
                  type: string
                  description: >-
                    A ação pretendida; 1–200 bytes UTF-8. Criar uma solicitação
                    não a executa.
                resource:
                  type: string
                  description: Recurso de destino específico; 1–2000 bytes UTF-8.
                scope:
                  type: string
                  description: Permissão pretendida; 1–200 bytes UTF-8. Não concede acesso.
                justification:
                  type: string
                  description: >-
                    Evidências de suporte e propósito; no máximo 4000 bytes
                    UTF-8. Nunca inclua segredos.
                risk_level:
                  type: string
                  enum:
                    - low
                    - medium
                    - high
                    - critical
                  default: medium
                required_approvals:
                  type: integer
                  minimum: 1
                  maximum: 10
                  default: 1
                  description: >-
                    Revisores humanos autorizados distintos; solicitante
                    excluído.
                ttl_minutes:
                  type: integer
                  minimum: 1
                  maximum: 10080
                  default: 60
      responses:
        '201':
          description: Resultado registrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentApproval'
        '400':
          description: Identificador, campos de solicitação ou motivo de decisão inválidos
        '401':
          description: Autenticação necessária
        '403':
          description: >-
            Reino do espaço de trabalho errado, permissão de revisor atual
            ausente, autoavaliação ou cancelamento não autorizado
        '404':
          description: >-
            Agente solicitante ou ativo ausente deste ambiente de espaço de
            trabalho
        '409':
          description: Já decidido, revisor duplicado ou solicitação expirada
components:
  schemas:
    AgentApproval:
      type: object
      required:
        - id
        - agent_id
        - status
        - requested_by
        - required_approvals
        - current_approvals
        - expires_at
        - decisions
      properties:
        id:
          type: string
          format: uuid
        tenant_id:
          type: string
          format: uuid
        agent_id:
          type: string
        action:
          type: string
        resource:
          type: string
        scope:
          type: string
        justification:
          type: string
        requested_by:
          type: string
          description: >-
            Solicitante autenticado: UUID de usuário humano ou api_key:<stored
            key ID>; nunca um revisor fornecido pelo chamador.
        decision_reason:
          type: string
        status:
          type: string
          enum:
            - pending
            - approved
            - rejected
            - expired
            - cancelled
        risk_level:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
        decided_at:
          type: string
          format: date-time
        decided_by:
          type: string
          description: >-
            Revisor final ou requerente a cancelar o pedido; ausente enquanto
            pendente.
        required_approvals:
          type: integer
          minimum: 1
          maximum: 10
        current_approvals:
          type: integer
          minimum: 0
          maximum: 10
        decisions:
          type: array
          description: >-
            Revisões individuais imutáveis. A resposta da fila deixa isso vazio;
            obtenha a solicitação para seu histórico completo de revisões.
          items:
            type: object
            properties:
              reviewer_id:
                type: string
                format: uuid
              decision:
                type: string
                enum:
                  - approved
                  - rejected
              reason:
                type: string
              created_at:
                type: string
                format: date-time
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.