---
title: "POST /files"
method: POST
path: "/files"
tags: ["files"]
---

# POST /files

`POST /files`

Create file

## Request body

- File
  - `actor_id` integer
  - `auto_include` boolean
  - `booking_id` integer
  - `created` string
  - `created_by_id` integer
  - `description` string
  - `description_location` string
  - `description_text` string
  - `exif_created` string
  - `format` string
  - `geo_latitude` number, double
  - `geo_longitude` number, double
  - `guid` string, nullable
  - `has_damage` boolean
  - `id` integer
  - `include_esign` boolean, nullable
  - `message_id` integer
  - `name` string
  - `out_of_date` boolean, nullable
  - `public_id` string
  - `rental_id` integer
  - `shared` boolean
  - `signable` boolean
  - `signers` unknown[]
    - unknown
  - `signing_canceled` boolean, nullable
  - `signing_complete` boolean, nullable
  - `signing_service_id` string — Unique identifier for digital signature record
  - `title` string
  - `type` string, nullable
  - `updated` string
  - `url` string
  - `user_id` integer

## Response `200`

- File
  - `actor_id` integer
  - `auto_include` boolean
  - `booking_id` integer
  - `created` string
  - `created_by_id` integer
  - `description` string
  - `description_location` string
  - `description_text` string
  - `exif_created` string
  - `format` string
  - `geo_latitude` number, double
  - `geo_longitude` number, double
  - `guid` string, nullable
  - `has_damage` boolean
  - `id` integer
  - `include_esign` boolean, nullable
  - `message_id` integer
  - `name` string
  - `out_of_date` boolean, nullable
  - `public_id` string
  - `rental_id` integer
  - `shared` boolean
  - `signable` boolean
  - `signers` unknown[]
    - unknown
  - `signing_canceled` boolean, nullable
  - `signing_complete` boolean, nullable
  - `signing_service_id` string — Unique identifier for digital signature record
  - `title` string
  - `type` string, nullable
  - `updated` string
  - `url` string
  - `user_id` integer

## Other responses

- `400` — Invalid input or state means you're bad
- `401` — Unauthorized error

---

[API](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation.md) · [All operations](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outdoorsy/outdoorsy-api-documentation/versions/f0cf8f605ea0/schema)