[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": "aac21e7f-623a-4e69-b097-d9b94cd3aaa0",
  "db_table_id": "2f7978f1-ef03-463b-82ce-b27b4031a4e5",
  "id_in_table": "c0b866ed-b699-4ba9-a661-406bb313d735",
  "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": "301c4b6b-372d-465f-9200-b2baf283fd1e",
  "description": "sample string 11",
  "tags": "sample string 12",
  "date_update": "2026-09-16T08:33:11.1369144+00:00",
  "date_add": "2026-09-16T08:33:11.1369144+00:00",
  "dateutc_add": "2026-09-16T08:33:11.1369144+00:00",
  "name": "sample string 16",
  "file_size": 17,
  "modified_dateutc": "2026-09-16T08:33:11.1369144+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-09-16T08:33:11.136Z</date_add>
  <date_update>2026-09-16T08:33:11.136Z</date_update>
  <dateutc_add>2026-09-16T08:33:11.136Z</dateutc_add>
  <db_table_id>2f7978f1-ef03-463b-82ce-b27b4031a4e5</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>aac21e7f-623a-4e69-b097-d9b94cd3aaa0</id>
  <id_in_table>c0b866ed-b699-4ba9-a661-406bb313d735</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-09-16T08:33:11.136Z</modified_dateutc>
  <name>sample string 16</name>
  <sys_logical_delete>true</sys_logical_delete>
  <tags>sample string 12</tags>
  <user_id>301c4b6b-372d-465f-9200-b2baf283fd1e</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": "875b0e2f-7539-4fe4-8dc0-ace99d9b29e1",
  "db_table_id": "2f0b4933-3c16-4ecc-9b2a-a4bba9826a5c",
  "id_in_table": "3868f72b-93e1-462f-99fa-9421b409531f",
  "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": "2e473b4c-f1f0-43d7-a390-82eed4688c59",
  "description": "sample string 11",
  "tags": "sample string 12",
  "date_update": "2026-09-16T08:33:11.2150466+00:00",
  "date_add": "2026-09-16T08:33:11.2150466+00:00",
  "dateutc_add": "2026-09-16T08:33:11.2150466+00:00",
  "name": "sample string 16",
  "file_size": 17,
  "modified_dateutc": "2026-09-16T08:33:11.2150466+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-09-16T08:33:11.215Z</date_add>
  <date_update>2026-09-16T08:33:11.215Z</date_update>
  <dateutc_add>2026-09-16T08:33:11.215Z</dateutc_add>
  <db_table_id>2f0b4933-3c16-4ecc-9b2a-a4bba9826a5c</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>875b0e2f-7539-4fe4-8dc0-ace99d9b29e1</id>
  <id_in_table>3868f72b-93e1-462f-99fa-9421b409531f</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-09-16T08:33:11.215Z</modified_dateutc>
  <name>sample string 16</name>
  <sys_logical_delete>true</sys_logical_delete>
  <tags>sample string 12</tags>
  <user_id>2e473b4c-f1f0-43d7-a390-82eed4688c59</user_id>
</db_file>