api notes for actors