---
description: >-
  Roles group one or more organization policies, and can be assigned to
  organization users and access keys.
---

# Organization roles

{% openapi src="https://nest.messagebird.com/public-specs/accounts/accounts.yml" path="/organizations/{organizationId}/iam-roles" method="get" %}
[https://nest.messagebird.com/public-specs/accounts/accounts.yml](https://nest.messagebird.com/public-specs/accounts/accounts.yml)
{% endopenapi %}

{% openapi src="https://nest.messagebird.com/public-specs/accounts/accounts.yml" path="/organizations/{organizationId}/iam-roles" method="post" %}
[https://nest.messagebird.com/public-specs/accounts/accounts.yml](https://nest.messagebird.com/public-specs/accounts/accounts.yml)
{% endopenapi %}

{% openapi src="https://nest.messagebird.com/public-specs/accounts/accounts.yml" path="/organizations/{organizationId}/iam-roles/{roleId}" method="get" %}
[https://nest.messagebird.com/public-specs/accounts/accounts.yml](https://nest.messagebird.com/public-specs/accounts/accounts.yml)
{% endopenapi %}

{% openapi src="https://nest.messagebird.com/public-specs/accounts/accounts.yml" path="/organizations/{organizationId}/iam-roles/{roleId}" method="delete" %}
[https://nest.messagebird.com/public-specs/accounts/accounts.yml](https://nest.messagebird.com/public-specs/accounts/accounts.yml)
{% endopenapi %}

{% openapi src="https://nest.messagebird.com/public-specs/accounts/accounts.yml" path="/organizations/{organizationId}/iam-roles/{roleId}" method="patch" %}
[https://nest.messagebird.com/public-specs/accounts/accounts.yml](https://nest.messagebird.com/public-specs/accounts/accounts.yml)
{% endopenapi %}
