wrong information in the API doc ( Identity v3 )

asked 2014-10-07 06:29:23 -0600

sumer_link gravatar image


Roles section mentions following APIs :

PUT /v3/domains/​{domain_id}​/users/​{user_id}​/roles/​{role_id}​ Grant role to domain user

HEAD /v3/domains/​{domain_id}​/users/​{user_id}​/roles/​{role_id}​ Check role for domain user

DELETE /v3/domains/​{domain_id}​/users/​{user_id}​/roles/​{role_id}​ Revoke role from domain user

In my opinion these should be under Domains section because :

1) main url is /v3/domains 2) groups functionality with roles is under Domains : /v3/domains/​{domain_id}​/groups/​{group_id}​/roles/​{role_id}​ ( PUT,HEAD,DELETE - same thing as users, does not make any sense why one functionality is under Roles and the other under Domains)


edit retag flag offensive close merge delete

2 answers

Sort by » oldest newest most voted

answered 2014-10-10 13:14:28 -0600

annegentle gravatar image

Just one more finesse point - for API docs on developer.openstack.org we track bugs at http://launchpad.net/openstack-api-site .

I've logged it here: https://bugs.launchpad.net/openstack-...

Thanks for reporting your confusion with the API, it helps us improve.

edit flag offensive delete link more

answered 2014-10-07 13:38:41 -0600

mpetason gravatar image

File a bug against it if you believe it is incorrect:


If you don't have a launchpad account you should set one up, it is the best way to interact with developers for Bugs/Blueprints.

edit flag offensive delete link more

Get to know Ask OpenStack

Resources for moderators

Question Tools

1 follower


Asked: 2014-10-07 06:29:23 -0600

Seen: 125 times

Last updated: Oct 10 '14