---
title: "Add a file to a service ticket"
slug: "preview-add-file-to-a-service-ticket"
updated: 2026-02-10T13:17:51Z
published: 2026-02-10T13:17:51Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://www.bloxs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add file to a service ticket

Post/api/v1/maintenance/servicetickets/files

Uploads a file and links it to the service ticket.

		
			

**Description**

Endpoint to add a file to an existing service ticket. Each file must be uploaded in a separate request. Files can be used to support the reported issue, for example by adding photos, or other relevant documents.

**Use Case**

Add a file to a service ticket, such as a photo.

**Request fields**

The request contains the following fields:

| Field | Description |
| --- | --- |
| reference | The unique identifier for this service ticket within Bloxs. This is unique (per client specific environment) for all service tickets. This identifier is generated by the Bloxs system. |
| externalIdentifier | The unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system. |

		
		
SecurityHTTPType Bearer

Please enter a valid token

Query parametersreferencestring

The internal identifier of the model (i.e. Reference, Code, Name, depends on model).

externalIdentifierstring

The external API identifier of the model.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='76ebd3c2-02c5-481e-b059-9daa6e60884e'>multipart/form-data</option>
<option value='ac814cc9-8ffe-4f28-b759-d85cda184dd3'>application/json</option>
</select>object  Filestring  (binary)    

object  Filestring  (binary)    

Responses200

The file was created

<select class='api-response-data' aria-label='Media type'><option value='9933e405-0df7-4441-a257-f25322772fc4'>application/json</option>
</select>integer  (int64)    

400

No file was uploaded

404

There was a problem attaching the file to the service ticket

<select class='api-response-data' aria-label='Media type'><option value='928efe9c-0b0f-4247-bb89-7058ecf197c5'>application/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
traceIdstring   | null  
statusinteger  (int32)    
errorsobject | null  property* Array of string  | null  additionalPropertiesstring