---
title: "POST /v1/{+name}:extend"
method: POST
path: "/v1/{+name}:extend"
tags: ["partners"]
---

# POST /v1/{+name}:extend

`POST /v1/{+name}:extend`

[Opt-in only] Most partners should be on auto-extend by default. Extends a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.

## Path parameters

- `name` string, required

## Request body

- ExtendSubscriptionRequest — Request message for extending a Subscription resource. A new recurrence will be made based on the subscription schedule defined by the original product.
  - `requestId` string — Required. Restricted to 36 ASCII characters. A random UUID is recommended. The idempotency key for the request. The ID generation logic is controlled by the partner. request_id should be the same as on retries of the same request. A different request_id must be used for a extension of a different cycle.
  - `extension` Extension — Describes the details of an extension request.
    - `partnerUserToken` string — Required. Identifier of the end-user in partner’s system.
    - `duration` Duration — Describes the length of a period of a time.
      - `unit` 'UNIT_UNSPECIFIED' | 'MONTH' | 'DAY' | 'HOUR' — The unit used for the duration
      - `count` integer — number of duration units to be included.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/paymentsresellersubscription.md) · [All operations](https://skmtc.net/google/apis/paymentsresellersubscription/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/paymentsresellersubscription/versions/c3d2f15ca50d/schema)
