1. Files
HQ Rental Software
  • Getting started
  • Authentication
  • Base URLs, regions and versioning
  • Errors
  • Responses and pagination
  • HQ concepts and glossary
  • Custom fields and item types
  • Dates, time zones and money
  • Filtering and incremental sync
  • Guide: build a booking engine on your website
  • Guide: connect an OTA or broker
  • Guide: sync your fleet and prices to a website
  • Guide: sync invoices and payments to accounting
  • Guide: sync customers with a CRM
  • Guide: take payments
  • Guide: bill tolls and fines
  • Rate limits and idempotency
  • Webhooks
  • Car Rental
    • Comments
      • List the comments of a record
      • Create a comment
      • Update a comment
      • Delete a comment
      • List the comments of a reservation
      • Add a comment to a reservation
      • Delete a reservation comment
    • Currencies
      • List currencies
    • Emails
      • List email templates
      • Send an email template for a record
      • Send the reservation confirmation email
      • Send the rental agreement email
      • List the email templates of a reservation
      • Send an email template for a reservation
      • Create a quote and email it
    • Addresses
      • List the addresses of a record
      • Create an address
      • Get an address
      • Update an address
      • Delete an address
    • Fields
      • List the fields of a record type
      • Get a field by its column
      • List the customer form fields (booking step 5)
    • Blocked Days
      • List blocked days
    • Customer Credits
      • List the credit transactions of a customer
      • Add credit to a customer
      • Update a credit transaction
      • Delete a credit transaction
    • Fines
      • List fines
      • Create a fine
      • Get a fine
      • Update a fine
      • Delete a fine
    • Packages
      • List package items
      • Get a package item
      • List packages
      • Get a package
    • Quotes
      • List quotes
      • Get a quote
    • Rate Types
      • List rate types
      • Create a rate type
      • Get a rate type
      • Delete a rate type
      • Update a rate type
    • Rates
      • List rates
      • Create a rate
      • Get a rate
      • Delete a rate
      • List rates (v2)
      • Update a rate
    • Reservation Attempts
      • List reservation attempts
      • List reservation attempts by email
    • Extensions
      • List the extensions of a reservation
      • Extend a rental
      • Delete an extension
    • External Charges
      • List the external charges of a reservation
      • Add an external charge to a reservation
      • Delete an external charge
    • Adjustments
      • List the adjustments of a reservation
      • Add an adjustment to a reservation
      • Delete an adjustment
    • Payments
      • List the payments of a reservation
      • Record a payment on a reservation
      • Update a payment
      • Release an offline security deposit
      • Refund an online security deposit
      • Charge the customer's saved card
    • Refunds
      • List the refunds of a reservation
      • Record a refund on a reservation
      • Update a refund
    • Reservations
      • Confirm a reservation
      • Cancel a reservation
      • Set a reservation to pending
      • Set a reservation to quote
      • Mark a reservation as no-show
      • Mark a reservation as ready for pick-up
      • Get the options for the dates step (booking step 1)
      • Validate dates and list available vehicle classes (booking step 2)
      • Change the vehicle class of a reservation
      • List additional charges for a vehicle class (booking step 3)
      • Price a vehicle class with selected charges (booking step 4)
      • Create or update the booking customer (booking step 6)
      • Create the reservation (booking step 8)
      • Update a reservation
      • List reservations
      • Get the rental agreement link
      • Mark the rental agreement as signed
      • Get a reservation
      • Assign a vehicle to a reservation
      • Detach the vehicle from a reservation
      • List the vehicles available for a reservation
      • List the free vehicle class upgrades of a reservation
      • Apply a free vehicle class upgrade
      • Upload the driver signature
      • Upload pick-up or return photos
      • Search availability and prices for all vehicle classes
      • List reservations (API v2)
    • Vehicle Replacements
      • List the vehicle replacements of a reservation
      • Replace the vehicle of a rental
      • Delete a vehicle replacement
    • Reservation Agents
      • List the users that can be assigned as agents
      • Assign the agents of a reservation
      • Assign the return agents of a reservation
    • Seasons
      • List seasons
      • Create a season
      • Get a season
      • Update a season
      • Delete a season
    • Security Deposits
      • List security deposit rules
      • Get a security deposit rule
    • Availability
      • List availability of vehicle classes
      • Get availability of a vehicle class
    • Driver Licenses
      • Read a driver license barcode
      • Save a driver license barcode to a reservation customer
      • Upload a driver license image for a reservation customer
  • Filters
    • List filter types and operators
  • Contacts
    • List contact categories
    • Get a contact category
    • List contacts of a category
    • Create a contact
    • Get a contact
    • Update a contact
    • Merge contacts
  • Fleets
    • Additional Charges
      • List additional charges
      • Get an additional charge
    • Features
      • List features
      • Get a feature
    • Locations
      • List locations
    • Blocked Periods
      • List the blocked periods of a vehicle
      • Create a blocked period
      • Update a blocked period
      • Delete a blocked period
    • Branches
      • List vehicle makes
      • Get a vehicle make
      • List branches
    • Damages
      • List the damages of a vehicle
      • Create a vehicle damage
      • Get a vehicle damage
      • Update a vehicle damage
    • Vehicles
      • Models
        • List vehicle models
        • Get a vehicle model
      • Types
        • List vehicle types
        • Get a vehicle type
      • List the maintenance status of a vehicle
      • List vehicles
      • Get a vehicle
      • Update a vehicle
      • List vehicles for toll matching
    • Relocations
      • Create a relocation
      • Delete a relocation
      • List the relocations of a vehicle
    • Telematics
      • List the OBD readings of a vehicle
      • List OBD readings of all vehicles since a reading ID
      • List the telematics alerts of a vehicle
      • List the trips of a vehicle
      • List vehicle alert types
    • Maintenance
      • List repair orders
      • Create a repair order line
      • Update a repair order line
      • Delete a repair order line
      • Get a repair order
      • List maintenance types
    • Vehicle Classes
      • List vehicle classes
      • Get a vehicle class
  • Payment Gateways
    • List saved credit cards of a customer
    • Delete a saved credit card
    • List payment methods
    • Get a payment method
    • Get a payment button
    • Get a payment transaction by UUID
    • Create a payment transaction
    • Refund a payment transaction
    • Re-check a payment transaction
    • List payment transactions
  • Sheets
    • List sheet items
    • Create a sheet item
    • Get a sheet item
    • Update a sheet item
    • List sheets
    • Get a sheet
  • Files
    • List files of a record
      GET
    • Upload a file
      POST
    • Delete a file
      DELETE
  • Inventory
    • List inventory categories
    • Get an inventory category
    • Shows a list of inventory items
    • Finds inventory item by id
    • Finds inventory price by id
    • shows a list of inventory purchase order
    • Create purchase order
    • Finds purchase order by id
    • Returns report of purchase order
    • Cancels purchase order by id
    • Finds inventory stock by id
  • Invoice
    • List invoices available as e-invoices
    • Download e-invoices
    • Create invoice item
    • List invoice payments
    • Create an invoice payment
    • Get an invoice payment
    • Update an invoice payment
    • Spread a payment over a contact's open invoices
    • List invoices
    • Create an invoice
    • Get an invoice
    • Email an invoice
    • Void an invoice
    • Download an invoice PDF
  • Audit Logs
    • Lists the audit log entries
  • Countries
    • List countries
  • Taxes
    • List taxes
    • Get a tax
  • Users
    • List users
  • Products
    • Categories
      • List product categories
      • Create a product category
      • Update a product category
      • Delete a product category
    • List products
    • Create a product
    • Update a product
    • Delete a product
  • Schemas
    • RequestBodies
    • Money
    • SaveRepairOrderLine
    • ErrorBusinessRule
    • SaveBlockedPeriod
    • ErrorValidation
    • SaveVehicleDamage
    • ErrorNotFound
    • ErrorUnauthorized
    • ReservationSummary
    • ReservationTotal
    • AvailableVehicleClass
    • AdditionalCharge
    • ReservationOverview
    • ReservationPayment
    • FleetsPageInfo
    • FleetsEmptySuccess
    • VehicleDamage
    • BillingAmount
    • InvoiceLine
    • ReservationRefund
    • CustomField
    • Comment
    • PaginationFields
    • Country
    • CustomFieldAddress
    • FilterDescriptor
    • Tax
    • VehicleClassAvailability
    • CustomerCreditTransaction
    • DriverLicenseData
    • DriverLicenseResult
    • Fine
    • FineInput
    • PackageItem
    • Package
    • Quote
    • RateType
    • RateTypeWrite
    • RatePriceInterval
    • RateRecord
    • RateWrite
    • ReservationAttempt
    • ReservationExtension
    • ReservationAdjustment
    • ReservationStatusResult
    • VehicleReplacement
    • ReservationRecord
    • ReservationListItem
    • ReservationListPage
    • ReservationDetail
    • ReservationOverviewWithVehicles
    • Season
    • SeasonWrite
    • SecurityDepositRule
    • OtaVehicleClassAvailability
    • RateV2
    • ReservationDriverV2
    • ReservationListItemV2
    • ContactCategory
    • Contact
    • ContactInput
    • AttachedFile
    • FleetAdditionalCharge
    • Branch
    • VehicleFeature
    • Location
    • VehicleMaintenanceStatus
    • RepairOrder
    • ObdReading
    • VehicleAlert
    • VehicleTrip
    • BlockedPeriod
    • VehicleMake
    • VehicleClassImage
    • VehicleClassFeature
    • VehicleClass
    • VehicleRelocation
    • VehicleType
    • Vehicle
    • InventoryCategory
    • InvoicePayment
    • Invoice
    • InvoiceDetail
    • SavedCreditCard
    • PaymentGatewaySummary
    • PaymentMethod
    • PaymentTransaction
    • ProductCategory
    • Product
    • SheetItem
    • SheetItemInput
    • Sheet
  1. Files

Upload a file

POST
/files/upload
Attaches a file to a record. Send the file either as multipart/form-data with the binary in file, or as JSON with the content base64-encoded in file_content_base64 (a data:...;base64, prefix is allowed).
To put the file in a file field of a record, also send field_id (the custom field ID from GET /fields). For example, to upload a driver's license image to field 252 of contact 1532 in category 3, send item_type=contacts.3, item_id=1532 and field_id=252.
Naming: with file_content_base64, filename is the stored file name, lowercased, and the label is that name without its extension (My License.JPG is stored as mylicense.jpg with label mylicense). With a multipart file, the stored name is the uploaded file's own name, cut at its first dot (my scan.v2.jpg is stored as myscan.jpg), and filename becomes the label. filename keeps only letters, digits and dots; other characters are removed. label, when sent, sets the label in both cases and is the field for a readable name.
Side effect: with delete_previous, the files already attached to the same record, folder and field are permanently deleted first. The match uses the stored item_type: files uploaded to a contact folder shared by all categories are stored as contacts, so to replace them send item_type=contacts, not contacts.{category_id}.
created_at and updated_at in the response are shifted to your API user's time zone (see Dates, time zones and money) although they end in Z.

Request

Authorization
Header Params

Body Params
application/json
Required

Example
{
    "filename": "license.jpg",
    "file_content_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8U",
    "item_type": "contacts.3",
    "item_id": 1532,
    "field_id": 252
}

Responses

🟢200OK
application/json
The uploaded file under data. HTTP 200 is also used for failures: always check success. When it is false, the body is an ErrorUnauthorized (status_code 401 or 403).
Bodyapplication/json

Example
{
    "success": true,
    "status_code": 200,
    "errors": [],
    "data": {
        "id": 901,
        "uuid": "7d3e9a10-4b2c-4f5e-8a6b-9c0d1e2f3a4b",
        "filename": "license.jpg",
        "extension": "jpg",
        "mime": "image/jpeg",
        "size": 248113,
        "label": "license",
        "item_type": "contacts.3",
        "item_id": 1532,
        "field_id": 252,
        "folder_id": null,
        "order": null,
        "public_link": "https://yourcompany.example.com/files/7d3e9a10-4b2c-4f5e-8a6b-9c0d1e2f3a4b/public?timestamp=1791501538",
        "public_download_link": "https://yourcompany.example.com/files/7d3e9a10-4b2c-4f5e-8a6b-9c0d1e2f3a4b/download",
        "created_by": 2,
        "updated_by": 2,
        "created_at": "2026-10-08T23:18:58.000000Z",
        "updated_at": "2026-10-08T23:18:58.000000Z",
        "deleted_at": null,
        "item": {
            "id": 1532,
            "label": "Jane Doe",
            "entity": "person",
            "first_name": "Jane",
            "last_name": "Doe",
            "email": "jane.doe@example.com"
        }
    }
}
🟠422Parameter Error
Modified at 2026-10-29 13:52:44
Previous
List files of a record
Next
Delete a file
Built with