---
title: "Set recurring data blocks on service line"
method: PUT
path: "/public/v2/service-lines/{serviceLineNumber}/data/recurring"
tags: ["Service Lines"]
---

# Set recurring data blocks on service line

`PUT /public/v2/service-lines/{serviceLineNumber}/data/recurring`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/service-lines/{serviceLineNumber}/data/recurring`
- Auth: HTTP bearer

Required permission: Service plan, Edit.<br/>Service line must be on a top up plan

## Path parameters

- `serviceLineNumber` string, required

## Request body

- RecurringDataBlocksRequest
  - `recurringDataBlocks` AddDataBlockRequest[], nullable: Recurring data blocks to configure
    - `productId` string, required: Product Id for data blocks
    - `count` integer, required: Quantity of the specified data block to add
  - `dataPoolId` string, nullable: If provided, onboard the service line onto an existing data pool. The data pool must be multi-service-line enabled. This parameter is mutually exclusive with RecurringDataBlocks.
  - `applyToCurrentMonth` boolean, nullable: When true, creates additional blocks for the current billing cycle so the current month data block counts match the new recurring configuration.

## Response `200`

Successfully set recurring blocks on service line

- ServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean

## Other responses

- `400`: Bad request. Invalid or missing parameter
- `401`: Unauthorized
- `403`: Missing required permission for this endpoint or resource
- `422`: Failed to set service line recurring data blocks

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)