POST api/Files

Inserts the given file into storage.

Request Information

URI Parameters

None.

Body Parameters

File content to insert.

Name	Type	Additional information
Content	string	Optional
Id	integer	Optional
Name	string	Optional
MimeType	string	Optional
Album	string	Optional
AlbumKey	string	Optional
Ordinal	integer	Optional
CapturedDate	date	Optional
CreatedOn	date	Optional
Caption	string	Optional
Latitude	decimal number	Optional
Longitude	decimal number	Optional
IsAnnotation	boolean	Optional
IsThumbnail	boolean	Optional
Height	integer	Optional
Width	integer	Optional
S3Path	string	Optional
Url	string	Optional
Tags	Collection of string	None.

Request Formats

application/json, text/json

Sample:

{
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "Content": "sample string 1",
  "Id": 2,
  "Name": "sample string 3",
  "MimeType": "sample string 4",
  "Album": "sample string 5",
  "AlbumKey": "sample string 6",
  "Ordinal": 7,
  "CapturedDate": "2025-10-30T10:32:16.4697796-05:00",
  "CreatedOn": "2025-10-30T10:32:16.4697796-05:00",
  "Caption": "sample string 8",
  "Latitude": 1.1,
  "Longitude": 1.1,
  "IsAnnotation": true,
  "IsThumbnail": true,
  "Height": 1,
  "Width": 1,
  "S3Path": "sample string 11",
  "Url": "api/Files/2/File"
}

Response Information

Resource Description

Returns inserted file.

File

Name	Type	Additional information
Id	integer	Optional
Name	string	Optional
MimeType	string	Optional
Album	string	Optional
AlbumKey	string	Optional
Ordinal	integer	Optional
CapturedDate	date	Optional
CreatedOn	date	Optional
Caption	string	Optional
Latitude	decimal number	Optional
Longitude	decimal number	Optional
IsAnnotation	boolean	Optional
IsThumbnail	boolean	Optional
Height	integer	Optional
Width	integer	Optional
S3Path	string	Optional
Url	string	Optional
Tags	Collection of string	None.

Response Formats

application/json, text/json

Sample:

{
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "Id": 1,
  "Name": "sample string 2",
  "MimeType": "sample string 3",
  "Album": "sample string 4",
  "AlbumKey": "sample string 5",
  "Ordinal": 6,
  "CapturedDate": "2025-10-30T10:32:16.4697796-05:00",
  "CreatedOn": "2025-10-30T10:32:16.4697796-05:00",
  "Caption": "sample string 7",
  "Latitude": 1.1,
  "Longitude": 1.1,
  "IsAnnotation": true,
  "IsThumbnail": true,
  "Height": 1,
  "Width": 1,
  "S3Path": "sample string 10",
  "Url": "api/Files/1/File"
}