Mark As Ready Document

Purpose

Using this API, you can mark the document as ready from the draft state and make it accessible to everyone available in your team folder.

Quick Reference

PropertyValue
MethodPOST
Request URLhttps://{zohoapis_domain}/writer/api/v1/documents/{document_id}/meta
ScopesZohoWriter.documentEditor.ALL
Rate LimitSee Writer API throttle limits

Parameters

Path Parameters

ParameterData TypeMandatory/OptionalDescription
document_idStringMandatorySpecify the unique id for the Writer document.

Body Parameters

ParameterData TypeMandatory/OptionalDescription
operationsJSONObjectMandatoryPass "mark_as_complete" String value through 'state' key inside the JSON Object.

Notes

  • Note: You can also mark the document as ready using this deluge task.
  • For possible errors, refer to error codes.

Sample Request

Copiedcurl -X POST \
  https://www.zohoapis.com/writer/api/v1/documents/h36bc2a6c50b2754a405880c1d1679a5*****/meta \
  -H 'Authorization: Zoho-oauthtoken xxx.yyy.zzz' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -F 'operations={"state": "mark_as_complete"}'

Sample Response

Copied{
  "modified_by": {
        "email_id": "amelia@zylker.com",
        "profile_photo": "https://contacts.zoho.com/file?t=user&ID=1234&fs=thumb",
        "user_id": "456215787",
        "timezone": "Asia/Kolkata",
        "language": "en",
        "display_name": "Amelia"
    },
    "state": "active",
    "message": "Document marked as complete successfully"
}

Deluge Snippet

Copieddocument_id = "h36bc2a6c50b2754a405880c1d1679a5f5be9";
response = zoho.writer.documents.markAsReady(document_id, "writer_oauth_connection");
info response;