---
title: "Set the free addresses of the brand"
method: PUT
path: "/projects/{id}/link-targets"
tags: ["Projects"]
---

# Set the free addresses of the brand

`PUT /projects/{id}/link-targets`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/projects/{id}/link-targets`
- Auth: HTTP bearer

The addresses that are neither the canon website nor a surface: a satellite domain kept
outside the registry, a tracking link, a partner page. They are set ONCE for the project and
serve every line of the corroboration registry, present and future. The list REPLACES the
previous one, and the answer returns what the project now holds, derived addresses included.
An empty list keeps the derived ones. Manager or above.

## Request body

- object
  - `link_targets` string[], required: The full list of the free addresses, as absolute http(s) URLs.

## Response `200`

The link targets the project now holds.

- LinkTargets
  - `derived` object[], required: What is already covered from work done elsewhere.
    - `url` string, required
    - `source` 'canon' | 'surface', required
  - `free` string[], required: What has been set on the project on top of the derived ones.

## Other responses

- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `404`: `not_found`: unknown for this account.
- `422`: `invalid_link_targets`: the message says what the list takes.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.

---

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