optimistic api docs