## Stripe CLI Resources

The Stripe CLI provides commands to interact with Stripe API resources directly from your terminal. These "resource commands" allow you to create, retrieve, update, delete, and list API objects.

### Resource Commands

Resource commands mirror the structure of the Stripe API. You specify the resource you want to interact with, followed by the operation you wish to perform.

**Command:** `stripe {resource command}`

#### Arguments

*   **Operation:** The action to perform on the API object. Common operations include `create`, `delete`, `list`, and `retrieve`.

#### Flags

*   `--param=value`: Specify parameters for the operation.
*   `-d, --data`: Provide additional data for the API request. This flag supports setting nested values (e.g., `nested[param]=value`).
*   `--live`: Make a live API request instead of a test request.

### Examples

**Listing supported operations for a resource:**

```sh
stripe customers --help
```

This will display a list of available operations for the `customers` resource, such as:

```
Available Operations:
create
delete
list
...
```

**Creating a resource:**

```sh
stripe customers create \
  --email=billing@example.com \
  --name="Jenny Rosen" \
  --description="My First Test Customer"
```

**Updating a resource:**

```sh
stripe customers update cus_9s6XKzkNRiz8i3 \
  -d "metadata[key]=value"
```

**Retrieving a resource:**

```sh
stripe customers retrieve cus_9s6XKzkNRiz8i3
```

**Response example:**

```json
{
  "id": "cus_9s6XKzkNRiz8i3",
  "object": "customer",
  "address": null,
  "balance": 0,
  "created": 1680893993,
  "currency": null,
  "default_source": null,
  "delinquent": false,
  "description": "My First Test Customer",
  "discount": null,
  "email": "billing@example.com",
  "invoice_prefix": "0759376C",
  "invoice_settings": {
    "custom_fields": null,
    "default_payment_method": null,
    "footer": null,
    "rendering_options": null
  },
  "livemode": false,
  "metadata": {},
  "name": "Jenny Rosen",
  "next_invoice_sequence": 1,
  "phone": null,
  "preferred_locales": [],
  "shipping": null,
  "tax_exempt": "none",
  "test_clock": null
}
```

For a comprehensive list of available resources and their operations, refer to the [API Reference Guide](https://docs.stripe.com/api.md) and select "Stripe CLI" from the language dropdown. You can also run `stripe resources` to see a complete list of available resources.