[OBSOLETE]: Creates a new file.

Request Information

URI Parameters :

None.

Body Parameters :

db_file
NameDescriptionTypeAdditional information
id

Primary key

globally unique identifier

Required

db_table_id

Table.id of the linked entity

globally unique identifier
id_in_table

Id of the linked entity

globally unique identifier
file_type

Free-text classification of this file's type/purpose.

string
is_default

Indicates this is the default/primary file for the linked entity.

boolean
file_name

File_name of the file

string
mime_type

MIME type of the file (e.g. "application/pdf", "image/jpeg").

string
file_content

Raw binary content of the file.

Collection of byte
image_width

In case of picture, the original width

integer
image_heigth

In case of picture, the original heigth

integer
user_id

Foreign key of the user who uploaded this file.

globally unique identifier
description

Free-text description of the file.

string
tags

Free-text, comma-separated tags applied to this file (denormalized summary; see for the structured link).

string
date_update

Local date and time this file was last updated.

date
date_add

Local date and time this file was added.

date
dateutc_add

UTC date and time this file was added.

date
name

Display name of the file.

string
file_size

Size of the file, in bytes.

integer
modified_dateutc

Readonly system field managed by database, filled with GetUtcDate when adding,updating

date
is_showonweb

Is available on ServiceDesk?

boolean
sys_logical_delete

Soft-delete flag: when true, this file is considered deleted, optimizing synchronization (can be physically deleted offline).

boolean

Request Formats :

application/json, text/json

Sample:
{
  "id": "2c36be41-c3bb-414d-8227-c44c318ea45a",
  "db_table_id": "9d78dc44-c7e8-4368-9c06-77ad6a7ac911",
  "id_in_table": "9042ba8d-cd3d-40ab-95f8-17f8f663e492",
  "file_type": "sample string 4",
  "is_default": true,
  "file_name": "sample string 6",
  "mime_type": "sample string 7",
  "file_content": "QEA=",
  "image_width": 8,
  "image_heigth": 9,
  "user_id": "20e675de-48de-4022-abe4-e1142d252fd3",
  "description": "sample string 11",
  "tags": "sample string 12",
  "date_update": "2026-11-12T14:27:05.2429862+00:00",
  "date_add": "2026-11-12T14:27:05.2429862+00:00",
  "dateutc_add": "2026-11-12T14:27:05.2429862+00:00",
  "name": "sample string 16",
  "file_size": 17,
  "modified_dateutc": "2026-11-12T14:27:05.2429862+00:00",
  "is_showonweb": true,
  "sys_logical_delete": true
}

application/xml, text/xml

Sample:
<db_file xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <date_add>2026-11-12T14:27:05.242Z</date_add>
  <date_update>2026-11-12T14:27:05.242Z</date_update>
  <dateutc_add>2026-11-12T14:27:05.242Z</dateutc_add>
  <db_table_id>9d78dc44-c7e8-4368-9c06-77ad6a7ac911</db_table_id>
  <description>sample string 11</description>
  <file_content>QEA=</file_content>
  <file_name>sample string 6</file_name>
  <file_size>17</file_size>
  <file_type>sample string 4</file_type>
  <id>2c36be41-c3bb-414d-8227-c44c318ea45a</id>
  <id_in_table>9042ba8d-cd3d-40ab-95f8-17f8f663e492</id_in_table>
  <image_heigth>9</image_heigth>
  <image_width>8</image_width>
  <is_default>true</is_default>
  <is_showonweb>true</is_showonweb>
  <mime_type>sample string 7</mime_type>
  <modified_dateutc>2026-11-12T14:27:05.242Z</modified_dateutc>
  <name>sample string 16</name>
  <sys_logical_delete>true</sys_logical_delete>
  <tags>sample string 12</tags>
  <user_id>20e675de-48de-4022-abe4-e1142d252fd3</user_id>
</db_file>

Response Information

Resource Description :

IHttpActionResult containing the created file.

db_file
NameDescriptionTypeAdditional information
id

Primary key

globally unique identifier

Required

db_table_id

Table.id of the linked entity

globally unique identifier
id_in_table

Id of the linked entity

globally unique identifier
file_type

Free-text classification of this file's type/purpose.

string
is_default

Indicates this is the default/primary file for the linked entity.

boolean
file_name

File_name of the file

string
mime_type

MIME type of the file (e.g. "application/pdf", "image/jpeg").

string
file_content

Raw binary content of the file.

Collection of byte
image_width

In case of picture, the original width

integer
image_heigth

In case of picture, the original heigth

integer
user_id

Foreign key of the user who uploaded this file.

globally unique identifier
description

Free-text description of the file.

string
tags

Free-text, comma-separated tags applied to this file (denormalized summary; see for the structured link).

string
date_update

Local date and time this file was last updated.

date
date_add

Local date and time this file was added.

date
dateutc_add

UTC date and time this file was added.

date
name

Display name of the file.

string
file_size

Size of the file, in bytes.

integer
modified_dateutc

Readonly system field managed by database, filled with GetUtcDate when adding,updating

date
is_showonweb

Is available on ServiceDesk?

boolean
sys_logical_delete

Soft-delete flag: when true, this file is considered deleted, optimizing synchronization (can be physically deleted offline).

boolean

Response Formats

application/json, text/json

Sample:
{
  "id": "75e91948-d0e7-4c2d-b149-dde2ede9df83",
  "db_table_id": "32362057-4f7e-4dc3-8ffa-a441556dc68e",
  "id_in_table": "d0eb0dea-2482-4925-959c-8fe0a6ec1980",
  "file_type": "sample string 4",
  "is_default": true,
  "file_name": "sample string 6",
  "mime_type": "sample string 7",
  "file_content": "QEA=",
  "image_width": 8,
  "image_heigth": 9,
  "user_id": "961ecaac-6394-44c6-8308-d7a031aecc43",
  "description": "sample string 11",
  "tags": "sample string 12",
  "date_update": "2026-11-12T14:27:05.2429862+00:00",
  "date_add": "2026-11-12T14:27:05.2429862+00:00",
  "dateutc_add": "2026-11-12T14:27:05.2429862+00:00",
  "name": "sample string 16",
  "file_size": 17,
  "modified_dateutc": "2026-11-12T14:27:05.2429862+00:00",
  "is_showonweb": true,
  "sys_logical_delete": true
}

application/xml, text/xml

Sample:
<db_file xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <date_add>2026-11-12T14:27:05.242Z</date_add>
  <date_update>2026-11-12T14:27:05.242Z</date_update>
  <dateutc_add>2026-11-12T14:27:05.242Z</dateutc_add>
  <db_table_id>32362057-4f7e-4dc3-8ffa-a441556dc68e</db_table_id>
  <description>sample string 11</description>
  <file_content>QEA=</file_content>
  <file_name>sample string 6</file_name>
  <file_size>17</file_size>
  <file_type>sample string 4</file_type>
  <id>75e91948-d0e7-4c2d-b149-dde2ede9df83</id>
  <id_in_table>d0eb0dea-2482-4925-959c-8fe0a6ec1980</id_in_table>
  <image_heigth>9</image_heigth>
  <image_width>8</image_width>
  <is_default>true</is_default>
  <is_showonweb>true</is_showonweb>
  <mime_type>sample string 7</mime_type>
  <modified_dateutc>2026-11-12T14:27:05.242Z</modified_dateutc>
  <name>sample string 16</name>
  <sys_logical_delete>true</sys_logical_delete>
  <tags>sample string 12</tags>
  <user_id>961ecaac-6394-44c6-8308-d7a031aecc43</user_id>
</db_file>