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

# Upload de Contrato

> Faz upload de um contrato (PDF ou DOC/DOCX) para o Supabase Storage.

**Formatos aceitos:**
- PDF: application/pdf
- DOC: application/msword
- DOCX: application/vnd.openxmlformats-officedocument.wordprocessingml.document

**Tamanho máximo:** 10MB

**Status inicial:** draft




## OpenAPI

````yaml api-reference/openapi.yaml post /contracts
openapi: 3.1.0
info:
  title: Verifica AI API
  description: >
    API para análise de contratos com inteligência artificial.


    ## Autenticação


    A API Verifica AI oferece autenticação via JWT (JSON Web Token) para acesso
    programático aos endpoints da API.


    ### Como obter o token:


    Faça login através do endpoint `/auth/login` com suas credenciais:


    ```bash

    curl -X POST https://api.verifica.ia.br/auth/login \
      -H "Content-Type: application/json" \
      -d '{
        "email": "usuario@example.com",
        "password": "senha123456"
      }'
    ```


    ### Header de autenticação:


    ```

    Authorization: Bearer SEU_TOKEN_JWT

    ```


    Para mais informações, consulte a [documentação completa de
    autenticação](/essentials/authentication).
  version: 1.0.0
  contact:
    name: Verifica AI Support
    email: support@verifica.ia.br
  license:
    name: Proprietary
servers:
  - url: https://api.verifica.ia.br
    description: Produção
  - url: http://localhost:3333
    description: Desenvolvimento
security: []
tags:
  - name: Health
    description: Endpoints de verificação de saúde da API
  - name: Authentication
    description: Autenticação JWT para acesso programático à API
  - name: Contracts
    description: Gestão de contratos
  - name: Risk Analysis
    description: Análise de risco de contratos
  - name: API Keys
    description: Gestão de API Keys
paths:
  /contracts:
    post:
      tags:
        - Contracts
      summary: Upload de Contrato
      description: >
        Faz upload de um contrato (PDF ou DOC/DOCX) para o Supabase Storage.


        **Formatos aceitos:**

        - PDF: application/pdf

        - DOC: application/msword

        - DOCX:
        application/vnd.openxmlformats-officedocument.wordprocessingml.document


        **Tamanho máximo:** 10MB


        **Status inicial:** draft
      operationId: uploadContract
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - file
              properties:
                file:
                  type: string
                  format: binary
                  description: Arquivo do contrato (PDF, DOC ou DOCX, máximo 10MB)
                name:
                  type: string
                  description: >-
                    Nome do contrato (opcional, se não informado usa o nome do
                    arquivo)
                  example: Contrato de Locação
      responses:
        '201':
          description: Contrato criado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Contract'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - BearerAuth: []
components:
  schemas:
    Contract:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: ID único do contrato
        name:
          type: string
          description: Nome do contrato
        url:
          type: string
          format: uri
          description: URL do arquivo no Supabase Storage
        fileSize:
          type: integer
          description: Tamanho do arquivo em bytes
        date:
          type: string
          format: date-time
          description: Data de criação do contrato
        status:
          $ref: '#/components/schemas/ContractStatus'
        userId:
          type: string
          format: uuid
          description: ID do usuário proprietário
    ContractStatus:
      type: string
      enum:
        - draft
        - active
        - in_analysis
        - finalized
      description: |
        Status do contrato:
        - **draft**: Rascunho (padrão ao fazer upload)
        - **active**: Ativo
        - **in_analysis**: Em análise
        - **finalized**: Finalizado
    Error:
      type: object
      properties:
        message:
          type: string
          description: Mensagem de erro
        errors:
          type: array
          items:
            type: object
          description: Lista de erros de validação (opcional)
  responses:
    BadRequest:
      description: Requisição inválida
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: File is required
            errors: []
    Unauthorized:
      description: Não autorizado - Token inválido ou ausente
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missingToken:
              value:
                message: Authorization header is required
            expiredToken:
              value:
                message: Token expired
    InternalServerError:
      description: Erro interno do servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Internal server error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |
        Token JWT obtido através do endpoint `/auth/login`.

        Inclua o token no header: `Authorization: Bearer SEU_TOKEN_JWT`

````