# Nylas IAM principals API

**Canonical:** https://apis.io/apis/nylas/nylas-iam-principals-api/  
**Provider:** Nylas — https://apis.io/providers/nylas/  
**Base URL:** https://api.us.nylas.com  
**Documentation:** https://developer.nylas.com/docs/reference/api/contacts/

Nylas IAM principals API is one of 43 APIs that [Nylas](https://apis.io/providers/nylas/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include IAM principals. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, authentication docs, and rate-limit docs.

Manage reusable IAM identities, their resource bindings, roles, and direct permissions. Requests require an organization-bound IAM API key with the corresponding `iam.principals.*` permission. Start with the [IAM API guide](/docs/v3/auth/nylas-iam/manage-principals-with-api/). ## Principal and credential limits IAM limits start with a base allowance and increase as you bind principals to resources. **N** is the number of distinct applications, workspaces, and grants directly referenced by at least one non-deleted principal's resource binding. Resources without a principal binding don't count. Multiple principals bound to the same resource count that resource once. Organization bindings don't increase N. | Object | Limit | | ----------------------------------- | ---------------------------------------------------- | | Principals per organization | `100 + 2N` | | Active credentials per organization | `2 × (100 + 2N)` | | Credentials per principal | 10 total, including disabled and expired credentials | Suppose your organization has **1 application, 2 workspaces, and 3 grants**. The limits depend on which resources have principal bindings: | Principal bindings | N | Principal limit | Active credential limit | | ------------------------------------------------------------------------- | --- | --------------- | ----------------------- | | No principals are bound to any of the six resources | 0 | 100 | 200 | | One principal is bound to one grant | 1 | 102 | 204 | | Ten principals are all bound to the same grant | 1 | 102 | 204 | | At least one principal is bound to each application, workspace, and grant | 6 | 112 | 224 | | Principals are bound only to the organization | 0 | 100 | 200 | Binding a principal to a grant counts that grant; it doesn't also count the grant's parent application or workspace. Those resources count only when they have their own principal bindings. With 10 distinct bound resources, the limits are 120 principals and 240 active credentials. Every principal still has a separate limit of 10 total credentials. Deleting a credential frees its per-principal slot; disabling it doesn't. Disabling or deleting a key releases its active organization capacity. Expired keys release organization capacity when background reconciliation processes them. Nylas rejects a binding change that lowers the organization's principal limit below current usage. A quota failure returns **400** with `error.code` set to `api.resource_limit_exceeded`, `error.type` set to `api.invalid_request`, and `error.details` containing `resource_type`, `limit`, and `current`. Remove unused objects or disable active keys as appropriate before retrying. Reserve credential capacity for rotation.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/v3/iam/principals` | List IAM principals |
| POST | `/v3/iam/principals` | Create IAM principal |
| GET | `/v3/iam/principals/{principal_id}` | Get IAM principal |
| PATCH | `/v3/iam/principals/{principal_id}` | Update IAM principal |
| DELETE | `/v3/iam/principals/{principal_id}` | Delete IAM principal |

## Machine-readable artifacts (17)

- **OpenAPI** — https://artifacts.apis.io/nylas/openapi/nylas-iam-principals-api-openapi.yml
- **APIReference** — https://developer.nylas.com/docs/reference/notifications/
- **Documentation** — https://developer.nylas.com/docs/v3/notifications/
- **Documentation** — https://developer.nylas.com/docs/
- **APIReference** — https://developer.nylas.com/docs/reference/api/
- **GettingStarted** — https://developer.nylas.com/docs/v3/getting-started/
- **Authentication** — https://developer.nylas.com/docs/v3/auth/
- **RateLimits** — https://developer.nylas.com/docs/dev-guide/platform/rate-limits/
- **ErrorCodes** — https://developer.nylas.com/docs/api/errors/
- **Pricing** — https://www.nylas.com/pricing/
- **Signup** — https://dashboard-v3.nylas.com/register
- **StatusPage** — https://status.nylas.com/
- **SDKs** — https://github.com/nylas/nylas-nodejs
- **SDKs** — https://github.com/nylas/nylas-python
- **SDKs** — https://github.com/nylas/nylas-ruby
- **SDKs** — https://github.com/nylas/nylas-java
- **APIReference** — https://developer.nylas.com/docs/reference/api/application-level-templates/

## Other Nylas APIs (12)

- [Nylas Contacts API](https://apis.io/apis/nylas/nylas-contacts-api/)
- [Nylas Drafts API](https://apis.io/apis/nylas/nylas-drafts-api/)
- [Nylas Events API](https://apis.io/apis/nylas/nylas-events-api/)
- [Nylas Messages API](https://apis.io/apis/nylas/nylas-messages-api/)
- [Nylas Threads API](https://apis.io/apis/nylas/nylas-threads-api/)
- [Nylas Notetaker API](https://apis.io/apis/nylas/nylas-notetaker-api/)
- [Nylas Amazon SNS Notifications API](https://apis.io/apis/nylas/nylas-amazon-sns-notifications-api/)
- [Nylas App migration API](https://apis.io/apis/nylas/nylas-app-migration-api/)
- [Nylas Applications API](https://apis.io/apis/nylas/nylas-applications-api/)
- [Nylas Attachments API](https://apis.io/apis/nylas/nylas-attachments-api/)
- [Nylas Authentication APIs API](https://apis.io/apis/nylas/nylas-authentication-apis-api/)
- [Nylas Availability API](https://apis.io/apis/nylas/nylas-availability-api/)

## Tags

IAM principals

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nylas/nylas-iam-principals-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nylas/.