Creates or updates a job file.
Request Information
URI Parameters :
None.
Body Parameters :
db_file| Name | Description | Type | Additional 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
{
"id": "d9d80630-b2d9-4c80-a948-6f30e21588af",
"db_table_id": "308b5f61-1466-4eaf-bb8c-8e0d2011beef",
"id_in_table": "383a971f-32c5-40e7-9419-8ac307c5cda8",
"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": "147ced03-4369-4676-9e89-86d769f9b180",
"description": "sample string 11",
"tags": "sample string 12",
"date_update": "2026-11-12T14:27:25.3370761+00:00",
"date_add": "2026-11-12T14:27:25.3370761+00:00",
"dateutc_add": "2026-11-12T14:27:25.3370761+00:00",
"name": "sample string 16",
"file_size": 17,
"modified_dateutc": "2026-11-12T14:27:25.3370761+00:00",
"is_showonweb": true,
"sys_logical_delete": true
}
application/xml, text/xml
<db_file xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <date_add>2026-11-12T14:27:25.337Z</date_add> <date_update>2026-11-12T14:27:25.337Z</date_update> <dateutc_add>2026-11-12T14:27:25.337Z</dateutc_add> <db_table_id>308b5f61-1466-4eaf-bb8c-8e0d2011beef</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>d9d80630-b2d9-4c80-a948-6f30e21588af</id> <id_in_table>383a971f-32c5-40e7-9419-8ac307c5cda8</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:25.337Z</modified_dateutc> <name>sample string 16</name> <sys_logical_delete>true</sys_logical_delete> <tags>sample string 12</tags> <user_id>147ced03-4369-4676-9e89-86d769f9b180</user_id> </db_file>
Response Information
Resource Description :
IHttpActionResult containing the saved job file.
db_file| Name | Description | Type | Additional 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
{
"id": "cff446d3-5bd1-4c16-b4d8-019bd638d81f",
"db_table_id": "089d7662-8fb6-44b7-8da0-59a69e0e69d4",
"id_in_table": "0798e17f-6288-45eb-9d2a-80b7bd4bfcc6",
"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": "3ecf194a-3d60-4f14-b6e7-e14f33d85c40",
"description": "sample string 11",
"tags": "sample string 12",
"date_update": "2026-11-12T14:27:25.3370761+00:00",
"date_add": "2026-11-12T14:27:25.3370761+00:00",
"dateutc_add": "2026-11-12T14:27:25.3370761+00:00",
"name": "sample string 16",
"file_size": 17,
"modified_dateutc": "2026-11-12T14:27:25.3370761+00:00",
"is_showonweb": true,
"sys_logical_delete": true
}
application/xml, text/xml
<db_file xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <date_add>2026-11-12T14:27:25.337Z</date_add> <date_update>2026-11-12T14:27:25.337Z</date_update> <dateutc_add>2026-11-12T14:27:25.337Z</dateutc_add> <db_table_id>089d7662-8fb6-44b7-8da0-59a69e0e69d4</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>cff446d3-5bd1-4c16-b4d8-019bd638d81f</id> <id_in_table>0798e17f-6288-45eb-9d2a-80b7bd4bfcc6</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:25.337Z</modified_dateutc> <name>sample string 16</name> <sys_logical_delete>true</sys_logical_delete> <tags>sample string 12</tags> <user_id>3ecf194a-3d60-4f14-b6e7-e14f33d85c40</user_id> </db_file>