Source: https://cli.nylas.com/docs/commands/agent-status

# nylas agent status

Connector and account readiness

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## What does nylas agent status do?

The nylas agent status command provides connector and account readiness. It is part of the Agent Email Identities commands, which receive (and send) at managed agent addresses with no OAuth. Replaces the deprecated nylas inbound surface.

## Usage

```bash
nylas agent status
```

## Flags

| Flag | Description |
| --- | --- |
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |

## Examples

The nylas agent status command provides connector and account readiness.

### JSON output for scripting

```bash
nylas agent status --json
```

## Troubleshooting

### Command not found or fails

Run `nylas auth config` and `nylas auth login` to authenticate first.

## Related commands

[nylas agent account createCreate a managed agent email identity (provider=nylas).](https://cli.nylas.com/docs/commands/agent-account-create)

[nylas agent account listList all Nylas agent accounts.](https://cli.nylas.com/docs/commands/agent-account-list)

[nylas agent account updateUpdate a managed agent account's display name or IMAP/SMTP app password.](https://cli.nylas.com/docs/commands/agent-account-update)

[nylas agent account deleteDelete an agent account](https://cli.nylas.com/docs/commands/agent-account-delete)

[nylas agent account getShow one agent account](https://cli.nylas.com/docs/commands/agent-account-get)

[nylas agent policy createCreate an Agent Account policy.](https://cli.nylas.com/docs/commands/agent-policy-create)

## Recommended guides

[Build a Mastra Email AgentGive a Mastra TypeScript agent email by wrapping the Nylas CLI as a createTool — one subprocess call, JSON in and out, across Gmail, Outlook, and more.](https://cli.nylas.com/guides/mastra-email-agent)

[Add Email Sync to Your App Without IMAPSkip per-mailbox IMAP IDLE connections. Use webhooks for push and on-demand reads for backfill, prototyped from the terminal — and know when IMAP still wins.](https://cli.nylas.com/guides/add-email-sync-without-imap)

[Send OTP and 2FA Codes by EmailGenerate a cryptographically secure one-time code and send it by email from the terminal — no SMTP. Test the full round trip and learn email OTP's limits.](https://cli.nylas.com/guides/send-otp-email-cli)

[Build a Transactional Email AgentSend receipts, confirmations, and alerts from a dedicated agent account — DKIM-signed, idempotent, and rate-capped by a workspace policy, no SMTP relay.](https://cli.nylas.com/guides/transactional-email-agent-account)

[Trigger Agents on Inbound Email with WebhooksReplace cron polling with webhooks: register a message.created hook so your agent account wakes the agent the instant mail arrives, signature-verified.](https://cli.nylas.com/guides/agent-account-webhooks)

[Build an Email Digest AgentSend an opt-in digest to a subscriber group from an agent account — resolve the recipient list from contacts, honor unsubscribes, and send on a schedule.](https://cli.nylas.com/guides/newsletter-digest-agent-account)

Run `nylas agent status --help` for full help output.