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

# Retrieve URL (Deprecated)

> **Deprecated:** This endpoint will be removed in a future version.

Upload a file to secure S3 storage and receive a URL for processing with /extract.
Useful when you need to reuse the uploaded file multiple times.


<Note type="warning">
  **Deprecated**: This endpoint is deprecated and will be removed in a future version.
</Note>

<Note type="warning">
  **Temporary Storage**: /convert is purely for temporary file storage into Pulse's S3 bucket (auto-deletes in 24 hours), and returns a presigned URL for use in /extract. For more robust processing please use your own cloud storage.
</Note>


## OpenAPI

````yaml POST /convert
openapi: 3.1.0
info:
  title: Pulse API
  description: >-
    Production-grade document extraction service that transforms complex
    documents  into structured, AI-ready data. This specification is the single
    source of truth  for the Pulse extraction APIs.
  version: 1.0.0
  contact:
    name: Pulse Support
    email: support@trypulse.ai
    url: https://docs.runpulse.com
servers:
  - url: https://api.runpulse.com
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /convert:
    post:
      tags:
        - Utilities
      summary: Upload File to S3 (Deprecated)
      description: >
        **Deprecated:** This endpoint will be removed in a future version.


        Upload a file to secure S3 storage and receive a URL for processing with
        /extract.

        Useful when you need to reuse the uploaded file multiple times.
      operationId: convertFile
      requestBody:
        required: true
        content:
          application/pdf:
            schema:
              type: string
              format: binary
              description: The raw PDF file content
      responses:
        '200':
          description: File uploaded successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConvertResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '413':
          $ref: '#/components/responses/PayloadTooLarge'
        '500':
          $ref: '#/components/responses/InternalServerError'
      deprecated: true
components:
  schemas:
    ConvertResponse:
      type: object
      properties:
        s3_object_url:
          type: string
          format: uri
          description: S3 URL of uploaded file
        presigned_url:
          type: string
          format: uri
          description: Presigned URL for direct access
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Error code (e.g., FILE_001, AUTH_002)
            message:
              type: string
              description: Human-readable error message
            details:
              type: object
              description: Additional error context
  responses:
    BadRequest:
      description: Bad request - Invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    PayloadTooLarge:
      description: File too large
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````