Skip to main content
Manage Identity and Access Management (IAM) resources. IAM controls who can access what within your accounts. This includes:
  • Members: users with access to an account
  • Groups: collections of users for easier permission management
  • Service Accounts: machine identities for automation
  • Policies: permission rules defining allowed/denied actions
  • Access Profiles: reusable permission templates
  • Assignments: bindings between identities and access profiles
  • Personal Access Tokens (PATs): API tokens for your user
  • Service Account Tokens (SATs): API tokens for service accounts

Usage

Commands

Inherited flags

Examples

Subcommand reference

idyl iam access-profile

Manage access profiles. Access profiles are reusable permission templates that compose multiple policies. They can be assigned to identities (users, groups, service accounts) to grant permissions on specific accounts. Access profiles can also be used to scope tokens (PATs and SATs) to restrict the permissions of the token holder.

Usage

Aliases

  • access-profiles
  • ap

Commands

Examples

idyl iam access-profile attach-policy

Add a policy to an access profile.

Usage

Flags

Examples

idyl iam access-profile create

Create a new access profile.

Usage

Flags

Examples

idyl iam access-profile delete

Delete an access profile by name or ID. System access profiles cannot be deleted. Deleting an access profile will remove all assignments using it.

Usage

Flags

Examples

idyl iam access-profile detach-policy

Remove a policy from an access profile.

Usage

Flags

Examples

idyl iam access-profile edit

Edit an access profile’s settings. Only the description can be updated. To modify attached policies, use: idyl iam access-profile attach-policy/detach-policy System access profiles cannot be edited.

Usage

Flags

Examples

idyl iam access-profile get

Get details of a specific access profile, or list all access profiles. With no arguments, lists all access profiles. With a name or ID argument, gets details of that specific access profile.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam access-profile list-policies

List all policies attached to an access profile.

Usage

Aliases

  • ls-policies
  • get-policies

Flags

Examples

idyl iam assignment

Manage access assignments within the current account. Assignments bind an identity (user, group, or service account) to an access profile, granting the permissions defined in that profile. The assignment also specifies a target account where the permissions apply. Identity formats:
  • User email: [email protected]
  • Group: group:{group-id}
  • Service Account: sa:{service-account-id}

Usage

Aliases

  • assignments

Commands

Examples

idyl iam assignment create

Create a new assignment binding an identity to an access profile. Identity formats:
  • User email: [email protected]
  • Group: group:{group-id}
  • Service Account: sa:{service-account-id}

Usage

Flags

Examples

idyl iam assignment delete

Delete an assignment by ID. This removes the identity’s permissions granted by this assignment.

Usage

Flags

Examples

idyl iam assignment get

List all assignments in the current account.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam group

Manage groups within the current account. Groups are collections of users that simplify permission management. Instead of assigning access profiles to individual users, you can assign them to a group, and all members inherit those permissions.

Usage

Aliases

  • groups

Commands

Examples

idyl iam group add-member

Add a member to a group. The identity should be an email address. The user must already be a member of the account.

Usage

Flags

Examples

idyl iam group create

Create a new group in the current account.

Usage

Flags

Examples

idyl iam group delete

Delete a group by name or ID. This action removes the group and all its member associations. It does not delete the members themselves.

Usage

Flags

Examples

idyl iam group edit

Edit a group’s settings. Only the specified flags are updated; other settings remain unchanged.

Usage

Flags

Examples

idyl iam group get

Get details of a specific group, or list all groups. With no arguments, lists all groups. With a name or ID argument, gets details of that specific group.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam group list-members

List all members of a group.

Usage

Aliases

  • ls-members
  • get-members

Flags

Examples

idyl iam group remove-member

Remove a member from a group. This removes the user from the group but does not remove them from the account.

Usage

Flags

Examples

idyl iam member

Manage members of the current account. Members are users who have access to an account. Their permissions are determined by access profile assignments, not by the membership itself.

Usage

Aliases

  • members

Commands

Examples

idyl iam member add

Add a member to the current account. The identity should be an email address. The user must already exist in the system (i.e., have logged in before).

Usage

Flags

Examples

idyl iam member get

List all members of the current account.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam member remove

Remove a member from the current account. This removes the user’s access to the account but does not delete the user. The user can be re-added later if needed.

Usage

Flags

Examples

idyl iam pat

Manage personal access tokens (PATs) for API authentication. PATs allow you to authenticate to the API without using the interactive login flow. They are useful for scripts, CI/CD pipelines, and other automation. Each PAT can optionally be scoped to an access profile for restricted permissions. If no access profile is specified, the PAT inherits your full permissions.

Usage

Aliases

  • pats

Commands

Examples

idyl iam pat create

Create a new personal access token. The token secret is only shown once at creation time. Store it securely.

Usage

Flags

Examples

idyl iam pat get

List all personal access tokens.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam pat revoke

Revoke a personal access token. This immediately invalidates the token. Any requests using this token will fail.

Usage

Flags

Examples

idyl iam policy

Manage IAM policies within the current account. Policies define what actions are allowed or denied on which resources. Each policy contains one or more statements with:
  • Effect: “allow” or “deny”
  • Actions: what can be done (e.g., “deployment:create”, ”*:get”)
  • Resources: what it applies to (e.g., “namespace:dev/”, "")

Usage

Aliases

  • policies

Commands

Examples

idyl iam policy create

Create a new policy in the current account. The —statements flag accepts JSON array of policy statements. Statement format: { “effect”: “allow” or “deny”, “actions”: [“action:type”, …], “resources”: [“resource:path”, …] } Action wildcards: “deployment:”, “:get”, ”:” Resource wildcards: “namespace:dev/”, “namespace:”, ”*“

Usage

Flags

Examples

idyl iam policy delete

Delete a policy by name or ID. System policies cannot be deleted.

Usage

Flags

Examples

idyl iam policy edit

Edit a policy’s settings. Only the specified flags are updated; other settings remain unchanged. System policies cannot be edited.

Usage

Flags

Examples

idyl iam policy get

Get details of a specific policy, or list all policies. With no arguments, lists all policies. With a name or ID argument, gets details of that specific policy.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam service-account

Manage service accounts within the current account. Service accounts are machine identities used for CI/CD and automation. Unlike user accounts, they survive employee turnover and provide stable identities for automated processes. Permissions are determined by assignments using identity format: sa:{id}

Usage

Aliases

  • service-accounts
  • sa

Commands

Examples

idyl iam service-account create

Create a new service account in the current account.

Usage

Flags

Examples

idyl iam service-account create-token

Create a new token for a service account. The token secret is only shown once at creation time. Store it securely.

Usage

Flags

Examples

idyl iam service-account delete

Delete a service account by name or ID. This action is irreversible. All tokens associated with the service account will be revoked immediately.

Usage

Flags

Examples

idyl iam service-account get

Get details of a specific service account, or list all service accounts. With no arguments, lists all service accounts. With a name or ID argument, gets details of that specific service account.

Usage

Aliases

  • list
  • ls

Flags

Examples

idyl iam service-account list-tokens

List all tokens for a service account.

Usage

Aliases

  • ls-tokens
  • get-tokens

Flags

Examples

idyl iam service-account revoke-token

Revoke a service account token. This immediately invalidates the token. Any requests using this token will fail.

Usage

Flags

Examples