---
title: "Subscribe to funded-request completion"
method: POST
path: "/v1/bounties/{id}/subscribe"
tags: ["Bounties & needs"]
---

# Subscribe to funded-request completion

`POST /v1/bounties/{id}/subscribe`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/bounties/{id}/subscribe`
- Auth: none required

No key required. For a pot, repair bounty or funded prepaid posted bounty, registers a public webhook URL, a lowercased delivery email, or both. Targets are private and are never included in bounty GET responses.

## Path parameters

- `id` string, uuid, required

## Request body

- union
  - object
    - `webhook_url` string, uri, required: Public HTTP(S) callback URL.
    - `email` string, email
  - object
    - `webhook_url` string, uri: Public HTTP(S) callback URL.
    - `email` string, email, required

## Response `200`

The same subscription was already registered.

## Other responses

- `201`: One or two completion subscriptions registered.
- `400`: Invalid bounty id, JSON body, email, or public webhook URL.
- `404`: No such bounty.
- `409`: The bounty is not a funded request.
- `429`: Rate limit or per-bounty subscription cap reached.
- `503`: Subscription storage is 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)