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

# Gerar URL de upload de documento

> Gera um `document-id` e uma URL para que o documento seja enviado ao file-storage da Pipo.
A URL fica habilitada para receber o upload (**via POST ou PUT**) por **30 minutos** após ter
sido gerada, **ou até receber algum dado** — o que ocorrer primeiro.




## OpenAPI

````yaml openapi.yaml POST /v1/enrollment/document-upload-url
openapi: 3.1.0
info:
  title: Pipo Public API
  version: 0.2.0
  description: >
    API pública da Pipo Saúde para integração de movimentações de benefícios

    (inclusões, exclusões e consultas) por parceiros e sistemas de folha de
    pagamento.
  contact:
    name: Pipo Engineering
    email: felipe.rodopoulos@piposaude.com.br
servers:
  - url: https://api.pipo.health
    description: Homologação (staging)
  - url: https://api.piposaude.com.br
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Autenticação
    description: Obtenção do token de acesso.
  - name: Empresas
    description: Consulta de empresas e seus produtos.
  - name: Benefícios
    description: Consulta de produtos/benefícios disponíveis.
  - name: Movimentações
    description: Inclusões, exclusões e histórico de movimentações.
  - name: Membros
    description: Consulta de membros e seus benefícios.
  - name: Solicitações
    description: Consulta do status de requisições assíncronas.
  - name: Health Check
    description: Verificação de disponibilidade.
paths:
  /v1/enrollment/document-upload-url:
    post:
      tags:
        - Movimentações
      summary: Gerar URL de upload de documento
      description: >
        Gera um `document-id` e uma URL para que o documento seja enviado ao
        file-storage da Pipo.

        A URL fica habilitada para receber o upload (**via POST ou PUT**) por
        **30 minutos** após ter

        sido gerada, **ou até receber algum dado** — o que ocorrer primeiro.
      responses:
        '200':
          description: URL de upload gerada.
          content:
            application/json:
              schema:
                type: object
                required:
                  - document-id
                  - upload-url
                properties:
                  document-id:
                    type: string
                    description: >-
                      Identificador do documento, usado para referenciá-lo na
                      movimentação.
                  upload-url:
                    type: string
                    format: uri
                    description: >
                      URL para upload do arquivo, via POST ou PUT. Válida por 30
                      minutos após ter

                      sido gerada, ou até receber algum dado.
              example:
                document-id: fff88888-e99f-1234-a456-456654321012
                upload-url: https://some.url.for/pipo/file/storage
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token Bearer obtido em `POST /v1/authenticate`.

````