update api across all adapters and in docs