---
title: "Attach files"
method: POST
path: "/users/{id}/files"
tags: ["Users"]
---

# Attach files

`POST /users/{id}/files`

Attach files to entity

## Request body

- FileJoin
  - `tag` string, nullable — User-generated tag(s) or desription.
  - `title` string, nullable — A user-generated title, such as exterior_front, exterior_rear, interior, basement, friends, headquarters, user manual, tornado path, furthest extent, etc. Note: file_files.title and location_locations.name are the default titles. However, this field allows the user to create their own title if it is shared. It may or may not be implemented.
  - `notes` string, nullable — Any user-specific notes, caption, or description for the file. Note: file_files.notes is the default captions. However, this field allows the user to create their own caption if they wish, e.g. if someone else shares it with them. It may or may not be implemented.
  - `created_at` string, date-time — Timestamp when the file was attached to the object.
  - `file_updated_at` string
  - `id` integer
  - `file` integer, nullable, required — The file.id of the file being attached to object_id.
  - `filename` string
  - `url` string
  - `full_url` string
  - `general_file_url` string
  - `blog_url` string
  - `large_blog_url` string
  - `large_thumbnail_url` string
  - `small_thumbnail_url` string
  - `filename_original` string
  - `file_type_t` string
  - `mime_content_type` string
  - `attr` string
  - `image_exif` string

## Response `201`

File attached successfully

## Other responses

- `400` — Invalid file data
- `404` — Entity not found

---

[API](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api.md) · [All operations](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crisiscleanup/crisiscleanup-api/revisions/3fa73d4b2895/schema)