PATCH
/
v1
/
files
/
{id}
Update a file
curl --request PATCH \
  --url https://api.steuerboard.com/v1/files/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <x-client-id>' \
  --data '{
  "name": "document.pdf",
  "documentDate": "2021-01-01T00:00:00Z",
  "folderId": "cmf41ajzv003706un4i99q19z"
}'
{
  "id": "cmf41ajzv003706un4i99q19z",
  "documentDate": "2021-01-01T00:00:00Z",
  "createdAt": "2021-01-01T00:00:00Z",
  "updatedAt": "2021-01-01T00:00:00Z",
  "name": "document.pdf",
  "mimetype": "application/pdf",
  "size": 1024,
  "workspaceId": "cmf41ajzv003706un4i99q19z",
  "createdById": "cmf41ajzv003706un4i99q19z",
  "taskId": "cmf41ajzv003706un4i99q19z",
  "folderId": "cmf41ajzv003706un4i99q19z",
  "labelIds": [
    "cmf41ajzv003706un4i99q19z"
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication

Headers

​
x-client-id
string<cuid>
required

The ID of the client

Example:

"cmf41ajzv003706un4i99q19z"

Path Parameters

​
id
string<cuid>
required

The ID of the item

Example:

"cmf41ajzv003706un4i99q19z"

Body

application/json

File update

​
name
string

The name of the file

Example:

"document.pdf"

​
documentDate
string

The date of the document (not the upload date)

Example:

"2021-01-01T00:00:00Z"

​
folderId
string<cuid>

The ID of the folder to place the file in

Example:

"cmf41ajzv003706un4i99q19z"

Response

File updated successfully

​
id
string<cuid>
required

The ID of the file

Example:

"cmf41ajzv003706un4i99q19z"

​
documentDate
string | null
required

The date of the document (not the upload date)

Example:

"2021-01-01T00:00:00Z"

​
createdAt
string
required

The date and time of the creation for the file

Example:

"2021-01-01T00:00:00Z"

​
updatedAt
string
required

The date and time of the last update for the file

Example:

"2021-01-01T00:00:00Z"

​
name
string
required

The name of the file

Example:

"document.pdf"

​
mimetype
string
required

The mime type of the file

Example:

"application/pdf"

​
size
number
required

The size of the file in bytes

Example:

1024

​
workspaceId
string<cuid>
required

The ID of the workspace

Example:

"cmf41ajzv003706un4i99q19z"

​
createdById
string<cuid> | null
required

The ID of the creator

Example:

"cmf41ajzv003706un4i99q19z"

​
taskId
string<cuid> | null
required

The ID of the task this file was uploaded to.

Example:

"cmf41ajzv003706un4i99q19z"

​
folderId
string<cuid> | null
required

The ID of the folder this file was uploaded to.

Example:

"cmf41ajzv003706un4i99q19z"

​
labelIds
string<cuid>[] | null
required

The IDs of the assigned labels

Example:
["cmf41ajzv003706un4i99q19z"]