Method: Appwrite::Databases#update_document

Defined in:
lib/appwrite/services/databases.rb

#update_document(database_id:, collection_id:, document_id:, data: nil, permissions: nil) ⇒ Document

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

Parameters:

  • database_id (String)

    Database ID.

  • collection_id (String)

    Collection ID.

  • document_id (String)

    Document ID.

  • data (Hash) (defaults to: nil)

    Document data as JSON object. Include only attribute and value pairs to be updated.

  • permissions (Array) (defaults to: nil)

    An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](appwrite.io/docs/permissions).

Returns:

  • (Document)


1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
# File 'lib/appwrite/services/databases.rb', line 1784

def update_document(database_id:, collection_id:, document_id:, data: nil, permissions: nil)
    api_path = '/databases/{databaseId}/collections/{collectionId}/documents/{documentId}'
        .gsub('{databaseId}', database_id)
        .gsub('{collectionId}', collection_id)
        .gsub('{documentId}', document_id)

    if database_id.nil?
      raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
    end

    if collection_id.nil?
      raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
    end

    if document_id.nil?
      raise Appwrite::Exception.new('Missing required parameter: "documentId"')
    end

    api_params = {
        data: data,
        permissions: permissions,
    }
    
    api_headers = {
        "content-type": 'application/json',
    }

    @client.call(
        method: 'PATCH',
        path: api_path,
        headers: api_headers,
        params: api_params,
        response_type: Models::Document
    )
end