Update Document

https://appwrite.io/v1/database/collections/{collectionId}/documents/{documentId}

Update a document by its unique ID. Using the patch method you can pass only specific fields that will get updated.

Access Token Required: API Key

Path Parameters

collectionIdstringrequired

Collection unique ID. You can create a new collection with validation rules using the Database service [server integration](/docs/server/database#createCollection).

documentIdstringrequired

Document unique ID.

Body Params

dataobjectrequired

Document data as JSON object.

readarray

An array of strings with read permissions. By default inherits the existing read permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.

writearray

An array of strings with write permissions. By default inherits the existing write permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

curl --request PATCH \
     --url 'https://appwrite.io/v1/database/collections/{collectionId}/documents/{documentId}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

Response

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

PATCH