---
title: "Repeat an accepted contract"
method: POST
path: "/v1/recurrences"
tags: ["Bounties & needs"]
---

# Repeat an accepted contract

`POST /v1/recurrences`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/recurrences`
- Auth: HTTP bearer

Creates a weekly, monthly, or on-drop schedule from an accepted posted bounty. Balance mode reserves the full amount before each cycle and captures it on acceptance. Returns 503 while schedule creation is closed.

## Request body

- object
  - `template_bounty_id` string, uuid, required
  - `cadence` 'weekly' | 'monthly' | 'on_drop', required
  - `amount_usd` integer, required
  - `funding_mode` 'invoice' | 'balance', required
  - `notify` object
    - `kind` 'email' | 'webhook', required
    - `target` string, required

## Response `201`

Recurrence created.

## Other responses

- `400`: Invalid schedule, funding, or notification input.
- `401`: Requester authentication required.
- `403`: The contract belongs to another requester.
- `409`: The template is not accepted, or the family already has an active recurrence.
- `413`: Request body exceeds 4 KiB.
- `503`: Repeating posts are currently closed or unavailable.

---

[API](https://skmtc.dev/licium/apis/licium-public-api.md) · [All operations](https://skmtc.dev/licium/apis/licium-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/licium/apis/licium-public-api/revisions/d91a72f755f4?raw)
