Patch file metadata

Updates file metadata without re-uploading the file. Only provided fields are updated.

PATCH/api/v1/{app_id}/files/{file_id}

Authorization

AuthorizationAPI key · headerrequired

Bearer token (format: "Bearer {token}")

Path parameters

app_idstringrequired

UUID of the app

file_idstringrequired

UUID of the file

Request body

requiredapplication/json

Fields to update

custom_fieldsobject

order_referencestring

organisation_numberstring

relationship_idsstring[]

Responses

200

app_idstring

content_typestring

created_atstring

custom_fieldsobject

filenamestring

idstring

updated_atstring

urlstring

400

Invalid request

detailsstring[] | null

messagestring

successboolean

404

File not found

detailsstring[] | null

messagestring

successboolean

500

Internal server error

detailsstring[] | null

messagestring

successboolean

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

app_idpath*UUID of the appfile_idpath*UUID of the file

Bodyapplication/json

Request body

Request

curl -X PATCH '//customers.enad.io/api/v1/string/files/string' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "custom_fields": {
    "property1": null,
    "property2": null
  },
  "order_reference": "string",
  "organisation_number": "string",
  "relationship_ids": [
    "string"
  ]
}'

const response = await fetch("//customers.enad.io/api/v1/string/files/string", {
  method: "PATCH",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"custom_fields\": {\n    \"property1\": null,\n    \"property2\": null\n  },\n  \"order_reference\": \"string\",\n  \"organisation_number\": \"string\",\n  \"relationship_ids\": [\n    \"string\"\n  ]\n}"
});

import requests

response = requests.patch(
    "//customers.enad.io/api/v1/string/files/string",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"custom_fields\": {\n    \"property1\": null,\n    \"property2\": null\n  },\n  \"order_reference\": \"string\",\n  \"organisation_number\": \"string\",\n  \"relationship_ids\": [\n    \"string\"\n  ]\n}",
)

Response

{
  "app_id": "string",
  "content_type": "string",
  "created_at": "string",
  "custom_fields": {
    "property1": null,
    "property2": null
  },
  "filename": "string",
  "id": "string",
  "updated_at": "string",
  "url": "string"
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": true
}