More specificity and clarity for iid field in API documentation.

Closes gitlab-ee#7019

See merge request gitlab-org/gitlab-ce!21490