docs: add proper way to submit/cancel

frappe / frappe_docs

[DEPRECATED] Frappe Framework Documentation. Please don't raise new contributions here.

https://frappeframework.com/docs

Other

44 stars 96 forks source link

docs: add proper way to submit/cancel #221

Closed ankush closed 2 years ago

ankush commented 2 years ago

Often in the community, this is recommended for cancelling/submitting:

PUT /api/resource/doctype/name 
{"docstatus": 2}

If you read document.py this isn't really equivalent to cancelling the document. IMO the current best method is to supply run_method (both submit/cancel are whitelisted).

I am not fully sure about this, maybe this would be better?

POST /api/resource/doctype/name/cancel

ankush commented 2 years ago

There are two proposals.

Fix submit and cancel methods so just sending docstatus is sufficient.
Sugary alternative (2nd half of the description)

Better discussed on frappe/frappe