---
title: "Add file to a person"
slug: "add-file-to-a-person"
updated: 2024-09-18T11:05:46Z
published: 2026-02-10T10:27:20Z
---

> ## 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 person

Post/api/v1/relations/persons/files

Uploads a file and links it to the person.

		
			

**Description**

Uploads a file and links it to the specified relation. Either reference or externalIdentifier must have a value. Please note that if both identifiers are given, both must match; otherwise, an error message will be generated. It is recommended that the user utilizes only one identifier, with a preference for the reference.

A person is a standalone entity and pertains to an enhancement of organisation. This could be a contact person within an organisation. Several users utilize this to enter their own employees into the system.

**Example Use Case**

The Bloxs user wants to prepare certain prospects for renting out a property. In this scenario certain documents will most likely be necesarry, such as a payment slip or an employment agreement. By using this endpoint the user can attach these documents to a certain relation.

| Field | Description |
| --- | --- |
| reference | The relationship number within Bloxs. This is unique (per client specific environment) for all relationships (EstateAgents, Organisations, Owners, Persons, Suppliers). The relationship number 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. |
| File | The file that needs to be attached should be entered here. |

		
		
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='c55c2ba3-eb82-4f25-bfcd-65bd743e8cd1'>multipart/form-data</option>
<option value='9a278308-3e40-4bed-ab39-35cb0951f503'>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='4bb42445-4732-476f-b828-299a4f6f980c'>application/json</option>
</select>integer  (int64)    

400

No file was uploaded

404

There was a problem attaching the file to the person

<select class='api-response-data' aria-label='Media type'><option value='69e2b028-a977-4506-ad4b-f9bf361adc94'>application/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
traceIdstring   | null  
statusinteger  (int32)    
errorsobject | null  property* Array of string  | null  additionalPropertiesstring