api: add required id to doc