add doc for unallocated API endpoint