---
title: "CreateUploadUrlsRequest"
url: "https://stage-api-docs.centraldispatch.com/apis/stage-dispatch-document-api-1-0-0/versions/37a28be1-2b73-47a5-9171-d6fcf5977ad4/schemas/CreateUploadUrlsRequest"
---

> Full API specification: https://stage-api-docs.centraldispatch.com/apis/stage-dispatch-document-api-1-0-0/versions/37a28be1-2b73-47a5-9171-d6fcf5977ad4.md

# CreateUploadUrlsRequest

Details of the request body to retrieve presigned URLs for document upload.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Dispatch Document API
  version: 1.0.0
servers:
  - url: https://document-api.centraldispatch.com
    description: Production server
components:
  schemas:
    UploadUrlRequest:
      type: object
      properties:
        fileName:
          type: string
          description: The actual file name of the document including the file extension.
          example: example.txt
        parentId:
          type: string
          description: The parent resource of the document if not only the dispatch ID or
            listing ID. If the document pertains to a vehicle (bill, inspection
            document, etc.) it will be the vehicle ID.
          format: uuid
          nullable: true
          example: dad00000-e89b-12d3-a456-426614174000
        displayName:
          type: string
          description: The display name of the document. If not provided, `fileName` will
            be used.
          nullable: true
          example: Example document
      description: Details of the upload URL request.
    CreateUploadUrlsRequest:
      type: object
      properties:
        dispatchId:
          type: string
          description: The ID of the dispatch to associate the document with. Required if
            `listingId` is null. Not allowed if `listingId` is provided.
          format: uuid
          nullable: true
          example: d159acc0-e89b-12d3-a456-426614174000
        listingId:
          type: string
          description: The ID of the listing to associate the document with. Required if
            `dispatchId` is null. Not allowed if `disptachId` is provided.
          nullable: true
          example: "42220470"
        documents:
          type: array
          items:
            $ref: "#/components/schemas/UploadUrlRequest"
          description: Details of the documents to be uploaded.
      description: Details of the request body to retrieve presigned URLs for document
        upload.
```