# polymorfa cloud

> Official API Number operations (beta). Team enrollment and scopes apply.

## Commands

- [polymorfa cloud catalog list](https://docs.polymorfa.com/cli/cloud/catalog-list): List visible Meta product catalogs for a WhatsApp Business Account. Requires sessions:read and Graph access.
- [polymorfa cloud catalog products](https://docs.polymorfa.com/cli/cloud/catalog-products): List products in a catalog linked to an Official API WABA (beta). Requires sessions:read and Graph access.
- [polymorfa cloud credentials get](https://docs.polymorfa.com/cli/cloud/credentials-get): Read redacted Meta credential checks for an enrolled Official API Number (beta). Requires sessions:read.
- [polymorfa cloud credentials reauthorize](https://docs.polymorfa.com/cli/cloud/credentials-reauthorize): Create one reauthorization QuickLink for a stopped or disconnected standalone Official API Number (beta). Requires quicklink:manage. Never stops the Number or retries link creation.
- [polymorfa cloud group create](https://docs.polymorfa.com/cli/cloud/group-create): Ask WhatsApp to create an Official group (beta). Requires groups:manage, team enrollment and an Official Business Account. Sends once; the group ID and invite link arrive in a group.update event carrying the returned requestId.
- [polymorfa cloud group delete](https://docs.polymorfa.com/cli/cloud/group-delete): Delete an Official group and remove every participant, including your business (beta). Requires groups:manage. Does not retry an uncertain write.
- [polymorfa cloud group get](https://docs.polymorfa.com/cli/cloud/group-get): Read an Official group: subject, description, participants and settings (beta). Requires groups:read.
- [polymorfa cloud group invite-link](https://docs.polymorfa.com/cli/cloud/group-invite-link): Show an Official group invite link, or create a new one with --reset (beta). Resetting stops every earlier link. Requires groups:read, or groups:manage with --reset.
- [polymorfa cloud group join-requests approve](https://docs.polymorfa.com/cli/cloud/group-join-requests-approve): Approve open join requests for an Official group (beta). Requires groups:manage. Sends once; requests WhatsApp could not approve are listed in failed.
- [polymorfa cloud group join-requests list](https://docs.polymorfa.com/cli/cloud/group-join-requests-list): List open join requests for an Official group that requires approval (beta). Requires groups:read.
- [polymorfa cloud group join-requests reject](https://docs.polymorfa.com/cli/cloud/group-join-requests-reject): Reject open join requests for an Official group (beta). Requires groups:manage. Sends once; requests WhatsApp could not reject are listed in failed.
- [polymorfa cloud group list](https://docs.polymorfa.com/cli/cloud/group-list): List Official groups on an Official API Number (beta). Requires groups:read and team enrollment.
- [polymorfa cloud group pin](https://docs.polymorfa.com/cli/cloud/group-pin): Pin an Official group message for 1 to 30 days, or unpin it with --unpin (beta). At most three messages stay pinned. Requires groups:manage. Sends once.
- [polymorfa cloud group remove-participants](https://docs.polymorfa.com/cli/cloud/group-remove-participants): Remove up to eight participants from an Official group (beta). A removed participant cannot rejoin with the invite link. Requires groups:manage. Sends once.
- [polymorfa cloud group update](https://docs.polymorfa.com/cli/cloud/group-update): Change an Official group subject or description (beta). Requires groups:manage. Sends once; a group.update event reports what WhatsApp applied.
- [polymorfa cloud marketing status](https://docs.polymorfa.com/cli/cloud/marketing-status): Read raw Marketing Messages WABA status strings (beta). Requires sessions:read and Graph access.
- [polymorfa cloud pricing](https://docs.polymorfa.com/cli/cloud/pricing): Read Meta-reported message counts (beta), without prices or invoice amounts. Requires sessions:read and service-window enrollment.
- [polymorfa cloud service-window](https://docs.polymorfa.com/cli/cloud/service-window): Read the observed customer service window (beta). Unknown does not establish permission to send. Requires chats:read and service-window enrollment; HMS is not required.
- [polymorfa cloud template create](https://docs.polymorfa.com/cli/cloud/template-create): Submit one Meta template (beta). Requires messages:write. Sends once; pass --idempotency-key so a manual retry cannot submit twice.
- [polymorfa cloud template delete](https://docs.polymorfa.com/cli/cloud/template-delete): Delete every language of a Meta template name (beta). Requires messages:write. Does not retry an uncertain write.
- [polymorfa cloud template edit](https://docs.polymorfa.com/cli/cloud/template-edit): Submit changes to one Meta template language (beta). Requires messages:write. Acceptance does not establish approval.
- [polymorfa cloud template get](https://docs.polymorfa.com/cli/cloud/template-get): Read a Meta template by name and language (beta). Omitted language defaults to en_US; requires messages:write.
- [polymorfa cloud template list](https://docs.polymorfa.com/cli/cloud/template-list): List the refreshed Meta template catalog for an Official API Number (beta). Requires messages:write.

## polymorfa cloud catalog list

List visible Meta product catalogs for a WhatsApp Business Account. Requires sessions:read and Graph access.

### Usage

```bash
polymorfa cloud catalog list [flags]
```

### Flags

- `--after <value>` (value). Opaque cursor from the previous response.
- `--graph-version <value>` (value, required). Meta Graph version, for example v26.0.
- `--limit <value>` (value). Page size from 1 to 100; API default is 25.
- `--waba <value>` (value, required). WhatsApp Business Account ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud catalog products

List products in a catalog linked to an Official API WABA (beta). Requires sessions:read and Graph access.

### Usage

```bash
polymorfa cloud catalog products [flags]
```

### Flags

- `--after <value>` (value). Opaque cursor from the previous response.
- `--catalog <value>` (value, required). Numeric product catalog ID linked to the WABA.
- `--graph-version <value>` (value, required). Meta Graph version, for example v26.0.
- `--limit <value>` (value). Page size from 1 to 100; API default is 25.
- `--waba <value>` (value, required). WhatsApp Business Account ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud credentials get

Read redacted Meta credential checks for an enrolled Official API Number (beta). Requires sessions:read.

### Usage

```bash
polymorfa cloud credentials get [flags]
```

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud credentials reauthorize

Create one reauthorization QuickLink for a stopped or disconnected standalone Official API Number (beta). Requires quicklink:manage. Never stops the Number or retries link creation.

### Usage

```bash
polymorfa cloud credentials reauthorize [flags]
```

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group create

Ask WhatsApp to create an Official group (beta). Requires groups:manage, team enrollment and an Official Business Account. Sends once; the group ID and invite link arrive in a group.update event carrying the returned requestId.

### Usage

```bash
polymorfa cloud group create [flags]
```

### Flags

- `--description <value>` (value). Group description, at most 2048 characters.
- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--join-approval` (boolean). Require approval for people who open the invite link.
- `--session <value>` (value, required). Messaging Number ID.
- `--subject <value>` (value, required). Group subject, 1 to 128 characters.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group delete

Delete an Official group and remove every participant, including your business (beta). Requires groups:manage. Does not retry an uncertain write.

### Usage

```bash
polymorfa cloud group delete GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--session <value>` (value, required). Messaging Number ID.
- `--yes` (boolean, required). Confirm deleting the group for every participant.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group get

Read an Official group: subject, description, participants and settings (beta). Requires groups:read.

### Usage

```bash
polymorfa cloud group get GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group invite-link

Show an Official group invite link, or create a new one with --reset (beta). Resetting stops every earlier link. Requires groups:read, or groups:manage with --reset.

### Usage

```bash
polymorfa cloud group invite-link GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--reset` (boolean). Create a new link; every earlier link stops working. Sends once.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group join-requests approve

Approve open join requests for an Official group (beta). Requires groups:manage. Sends once; requests WhatsApp could not approve are listed in failed.

### Usage

```bash
polymorfa cloud group join-requests approve GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--request <value>` (value, required, repeatable). Join request ID. Repeat for several.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group join-requests list

List open join requests for an Official group that requires approval (beta). Requires groups:read.

### Usage

```bash
polymorfa cloud group join-requests list GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--after <value>` (value). Cursor from a previous page (cursors.after).
- `--before <value>` (value). Cursor from a previous page (cursors.before).
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group join-requests reject

Reject open join requests for an Official group (beta). Requires groups:manage. Sends once; requests WhatsApp could not reject are listed in failed.

### Usage

```bash
polymorfa cloud group join-requests reject GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--request <value>` (value, required, repeatable). Join request ID. Repeat for several.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group list

List Official groups on an Official API Number (beta). Requires groups:read and team enrollment.

### Usage

```bash
polymorfa cloud group list [flags]
```

### Flags

- `--after <value>` (value). Cursor from a previous page (cursors.after).
- `--before <value>` (value). Cursor from a previous page (cursors.before).
- `--limit <value>` (value). Groups per page, 1 to 1024.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group pin

Pin an Official group message for 1 to 30 days, or unpin it with --unpin (beta). At most three messages stay pinned. Requires groups:manage. Sends once.

### Usage

```bash
polymorfa cloud group pin GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--days <value>` (value). Pin duration, 1 to 30 days.
- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--message <value>` (value, required). ID of a message in this group.
- `--session <value>` (value, required). Messaging Number ID.
- `--unpin` (boolean). Unpin the message.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group remove-participants

Remove up to eight participants from an Official group (beta). A removed participant cannot rejoin with the invite link. Requires groups:manage. Sends once.

### Usage

```bash
polymorfa cloud group remove-participants GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--participant <value>` (value, required, repeatable). Conversation ID or E.164 phone number. Repeat up to eight times.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud group update

Change an Official group subject or description (beta). Requires groups:manage. Sends once; a group.update event reports what WhatsApp applied.

### Usage

```bash
polymorfa cloud group update GROUP [flags]
```

### Arguments

- `GROUP` (required). Conversation ID of the group.

### Flags

- `--description <value>` (value). New description, at most 2048 characters.
- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API answers instead of changing the group again.
- `--session <value>` (value, required). Messaging Number ID.
- `--subject <value>` (value). New subject, 1 to 128 characters.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud marketing status

Read raw Marketing Messages WABA status strings (beta). Requires sessions:read and Graph access.

### Usage

```bash
polymorfa cloud marketing status [flags]
```

### Flags

- `--graph-version <value>` (value, required). Meta Graph version, for example v26.0.
- `--waba <value>` (value, required). WhatsApp Business Account ID from an Official API Number in your project.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud pricing

Read Meta-reported message counts (beta), without prices or invoice amounts. Requires sessions:read and service-window enrollment.

### Usage

```bash
polymorfa cloud pricing [flags]
```

### Flags

- `--session <value>` (value, required). Messaging Number ID.
- `--since <value>` (value). Inclusive ISO 8601 start; defaults to 30 days before until.
- `--until <value>` (value). Exclusive ISO 8601 end; defaults to now. Maximum period: 93 days.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud service-window

Read the observed customer service window (beta). Unknown does not establish permission to send. Requires chats:read and service-window enrollment; HMS is not required.

### Usage

```bash
polymorfa cloud service-window CONVERSATION [flags]
```

### Arguments

- `CONVERSATION` (required). Conversation ID or E.164 phone number.

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud template create

Submit one Meta template (beta). Requires messages:write. Sends once; pass --idempotency-key so a manual retry cannot submit twice.

### Usage

```bash
polymorfa cloud template create [flags]
```

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API returns idempotency_completed instead of writing again.
- `--input <value>` (value, required). Template JSON file or - for stdin: name, language, category, components.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud template delete

Delete every language of a Meta template name (beta). Requires messages:write. Does not retry an uncertain write.

### Usage

```bash
polymorfa cloud template delete NAME [flags]
```

### Arguments

- `NAME` (required). Meta template name to delete in all languages.

### Flags

- `--idempotency-key <value>` (value). Key that fences a manual retry: reuse it after an unknown outcome and the API returns idempotency_completed instead of writing again.
- `--session <value>` (value, required). Messaging Number ID.
- `--yes` (boolean, required). Confirm deletion of all language variants.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud template edit

Submit changes to one Meta template language (beta). Requires messages:write. Acceptance does not establish approval.

### Usage

```bash
polymorfa cloud template edit NAME [flags]
```

### Arguments

- `NAME` (required). Meta template name.

### Flags

- `--input <value>` (value, required). JSON file or - for stdin containing components.
- `--language <value>` (value). Template language; API default is en_US.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud template get

Read a Meta template by name and language (beta). Omitted language defaults to en_US; requires messages:write.

### Usage

```bash
polymorfa cloud template get NAME [flags]
```

### Arguments

- `NAME` (required). Meta template name.

### Flags

- `--language <value>` (value). Template language; defaults to en_US at the API.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa cloud template list

List the refreshed Meta template catalog for an Official API Number (beta). Requires messages:write.

### Usage

```bash
polymorfa cloud template list [flags]
```

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).
