---
title: "Add file to an organisation"
slug: "add-file-to-an-organization"
updated: 2024-09-04T11:14:03Z
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 an organisation

Post/api/v1/relations/organisations/files

Uploads a file and links it to the organisation.

		
			

**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.

Organisations are tenants who are not natural persons but rather entities such as commercial real estate or partnerships. For instance, a university providing rooms where the rent is collected directly from the tenant.

**Use Case**

The Bloxs user wants to prepare certain prospects for renting out a property. In this scenario certain documents will most likely be necessary, 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='8858ec90-7e4b-4c04-baba-f222454b45f3'>multipart/form-data</option>
<option value='2f83fe37-704f-4e5c-b9ce-b2f3c052736b'>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='ca51a783-6ccd-4f1b-9d06-68a92de6ea76'>application/json</option>
</select>integer  (int64)    

400

No file was uploaded

404

There was a problem attaching the file to the organisation

<select class='api-response-data' aria-label='Media type'><option value='8ae81464-e98c-4a7c-a5e7-d6189aab50ee'>application/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
traceIdstring   | null  
statusinteger  (int32)    
errorsobject | null  property* Array of string  | null  additionalPropertiesstring