Creates a new job 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": "c889ed99-f748-4cc1-865b-f9089ceddd93",
  "db_table_id": "43a19246-f6ef-4f26-9825-dce2b247712d",
  "id_in_table": "e04a1190-8bba-4c0f-89c1-fc80a0dfc4d2",
  "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": "ad923417-fd27-46b6-8d7f-75ab1f8416a8",
  "description": "sample string 11",
  "tags": "sample string 12",
  "date_update": "2026-09-16T10:11:44.5199689+00:00",
  "date_add": "2026-09-16T10:11:44.5199689+00:00",
  "dateutc_add": "2026-09-16T10:11:44.5199689+00:00",
  "name": "sample string 16",
  "file_size": 17,
  "modified_dateutc": "2026-09-16T10:11:44.5199689+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-16T10:11:44.519Z</date_add>
  <date_update>2026-09-16T10:11:44.519Z</date_update>
  <dateutc_add>2026-09-16T10:11:44.519Z</dateutc_add>
  <db_table_id>43a19246-f6ef-4f26-9825-dce2b247712d</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>c889ed99-f748-4cc1-865b-f9089ceddd93</id>
  <id_in_table>e04a1190-8bba-4c0f-89c1-fc80a0dfc4d2</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-16T10:11:44.519Z</modified_dateutc>
  <name>sample string 16</name>
  <sys_logical_delete>true</sys_logical_delete>
  <tags>sample string 12</tags>
  <user_id>ad923417-fd27-46b6-8d7f-75ab1f8416a8</user_id>
</db_file>

Response Information

Resource Description :

IHttpActionResult containing the created job 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": "3b43b06c-2c07-453e-a477-1fc8671c38aa",
  "db_table_id": "7c840fec-ec1b-49aa-b1fe-e27e37547372",
  "id_in_table": "947f9307-9fc2-469e-b26c-2fa234284148",
  "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": "59238f2f-2427-4022-803f-ca19683fd68c",
  "description": "sample string 11",
  "tags": "sample string 12",
  "date_update": "2026-09-16T10:11:44.5199689+00:00",
  "date_add": "2026-09-16T10:11:44.5199689+00:00",
  "dateutc_add": "2026-09-16T10:11:44.5199689+00:00",
  "name": "sample string 16",
  "file_size": 17,
  "modified_dateutc": "2026-09-16T10:11:44.5199689+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-16T10:11:44.519Z</date_add>
  <date_update>2026-09-16T10:11:44.519Z</date_update>
  <dateutc_add>2026-09-16T10:11:44.519Z</dateutc_add>
  <db_table_id>7c840fec-ec1b-49aa-b1fe-e27e37547372</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>3b43b06c-2c07-453e-a477-1fc8671c38aa</id>
  <id_in_table>947f9307-9fc2-469e-b26c-2fa234284148</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-16T10:11:44.519Z</modified_dateutc>
  <name>sample string 16</name>
  <sys_logical_delete>true</sys_logical_delete>
  <tags>sample string 12</tags>
  <user_id>59238f2f-2427-4022-803f-ca19683fd68c</user_id>
</db_file>