> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update auto reload

> Use this endpoint to update an auto reload.

PUT/autoreloads/\{token}

Use this endpoint to update an auto reload. Only values of parameters in the request are modified; all others are left unchanged.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the auto reload. **Allowable Values:**  Existing auto reload token |

## Request body

| Fields | Description |
| - | - |
| active boolean  Optional | Specifies whether the auto reload is active. Only one auto reload per level, per object, can be active. **Allowable Values:**  `true`, `false` **Default value:** `true` |
| association object  Optional | Specifies the scope of the auto reload. Input no more than one field. If no value is supplied, the auto reload applies at the program level. **Allowable Values:**  `business_token`, `card_product_token`, `user_token` |
| association.**business\_token** string  Optional | Unique identifier of the business for which the auto reload is configured. Send a `GET` request to `/businesses` to retrieve business tokens. **Allowable Values:**  1–36 chars |
| association.**card\_product\_token** string  Optional | Unique identifier of the card product for which the auto reload is configured. Send a `GET` request to `/cardproducts` to retrieve card product tokens. **Allowable Values:**  1–36 chars |
| association.**user\_token** string  Optional | Unique identifier of the user for which the auto reload is configured. Send a `GET` request to `/users` to retrieve user tokens. **Allowable Values:**  1–36 chars |
| currency\_code string  Optional | Three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  Any currency code allowed by your program |
| funding\_source\_address\_token string  Optional | Unique identifier of the funding source address to use for this auto reload. If your funding source is an ACH account, then a `funding_source_address_token` is not required. If your funding source is a payment card, you must have at least one funding source address in order to create a GPA order. Send a `GET` request to `/fundingsources/addresses/user/{user_token}` to retrieve address tokens for a user. Send a `GET` request to `/fundingsources/addresses/business/{business_token}` to retrieve address tokens for a business. **Allowable Values:**  1–36 chars  Existing funding source address token. |
| funding\_source\_token string  Optional | Unique identifier of the funding source to use for this auto reload. Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve funding source tokens for a user. Send a `GET` request to `/fundingsources/business/{business_token}` to retrieve funding source tokens for a business. **Allowable Values:**  1–36 chars  Existing funding source token. |
| order\_scope object  Optional | Defines the balance threshold and reload amounts. **Allowable Values:**  `gpa` |
| order\_scope.**gpa** object  Optional | Defines the type of order. **Allowable Values:**  `reload_amount`, `trigger_amount` |
| order\_scope.gpa.**reload\_amount** decimal  Required | Available balance on the card after the reload has completed. This value must be greater than or equal to the value of `trigger_amount`. Note that this is not the same as the amount added to the card, which will vary from reload to reload. **Allowable Values:**  0.01 min |
| order\_scope.gpa.**trigger\_amount** decimal  Required | Threshold that determines when the reload happens. The reload is triggered when the card balance falls below this amount. **Allowable Values:**  0.01 min |
| token string  Optional | The token in the path parameter takes precedence over the `token` body field. **Allowable Values:**  1–36 chars |

## Sample request body

```json JSON lines wrap theme={null}
{
  "order_scope": {
    "gpa": {
      "trigger_amount": 250,
      "reload_amount": 500
    }
  }
}
```

## Response body

| Fields | Description |
| - | - |
| active boolean  Conditionally returned | Specifies whether the auto reload is active. This field is returned if it exists in the resource. **Allowable Values:**  `true`, `false` |
| association object  Conditionally returned | Specifies the scope of the auto reload. **Allowable Values:**  `business_token`, `card_product_token`, `user_token` |
| association.**business\_token** string  Conditionally returned | Unique identifier of the business for which the auto reload is configured. **Allowable Values:**  1–36 chars |
| association.**card\_product\_token** string  Conditionally returned | Unique identifier of the card product for which the auto reload is configured. **Allowable Values:**  1–36 chars |
| association.**user\_token** string  Conditionally returned | Unique identifier of the user for which the auto reload is configured. **Allowable Values:**  1–36 chars |
| created\_time datetime  Returned | Date and time when the auto reload object was created, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| currency\_code string  Returned | Three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  Any currency code allowed by your program |
| funding\_source\_address\_token string  Conditionally returned | Unique identifier of the funding source address to use for this auto reload. This field is returned if it exists in the resource. **Allowable Values:**  1–36 chars |
| funding\_source\_token string  Conditionally returned | Unique identifier of the funding source to use for this auto reload. This field is returned if it exists in the resource. **Allowable Values:**  1–36 chars |
| last\_modified\_time datetime  Returned | Date and time when the auto reload object was last modified, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| order\_scope object  Returned | Defines the balance threshold and reload amounts. **Allowable Values:**  `gpa` |
| order\_scope.**gpa** object  Conditionally returned | Defines the type of order. **Allowable Values:**  `reload_amount`, `trigger_amount` |
| order\_scope.gpa.**reload\_amount** decimal  Returned | Available balance on the card after the reload has completed. **Allowable Values:**  0.01 min |
| order\_scope.gpa.**trigger\_amount** decimal  Returned | Threshold that determines when the reload happens. The reload is triggered when the card balance falls below this amount. **Allowable Values:**  0.01 min |
| token string  Conditionally returned | Unique identifier of the auto reload. This field is always returned. **Allowable Values:**  1–36 chars |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "my_user_01_autoreload_01",
  "active": false,
  "funding_source_token": "my_program_funding_source_01",
  "association": {
    "user_token": "my_user_01"
  },
  "order_scope": {
    "gpa": {
      "trigger_amount": 250,
      "reload_amount": 500
    }
  },
  "currency_code": "USD",
  "created_time": "2022-11-10T22:15:20Z",
  "last_modified_time": "2022-11-10T22:25:00Z"
}
```


## Related topics

- [Auto Reload Overview](https://www.marqeta.com/docs/core-api/auto-reload.md)
- [Create auto reload](https://www.marqeta.com/docs/core-api/auto-reload/create-auto-reload.md)
- [Retrieve auto reload](https://www.marqeta.com/docs/core-api/auto-reload/retrieve-auto-reload.md)
- [List auto reloads](https://www.marqeta.com/docs/core-api/auto-reload/list-auto-reloads.md)
- [Auto Reload Object](https://www.marqeta.com/docs/core-api/auto-reload/auto-reload-object.md)
