---
title: "Trigger Location Links Maintenance"
method: POST
path: "/v1/locations/links/maintenance"
tags: ["locations"]
---

# Trigger Location Links Maintenance

`POST /v1/locations/links/maintenance`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/locations/links/maintenance`
- Auth: HTTP bearer

## Headers

- `x-api-key` string, nullable

## Request body

- union
  - LinkMaintenanceRequest: Schema for triggering campaign-wide wikilink maintenance via webhook.
    - `operation` 'add' | 'remove', required
    - `worldId` string, required
    - `targetId` string, required
    - `targetType` 'Character' | 'Faction' | 'Location' | 'Item' | 'Moment', required
    - `alias` string, required
  - LinkMaintenanceUpdateRequest: Schema for updating existing links across a campaign.
    - `operation` 'update', required
    - `worldId` string, required
    - `targetId` string, required
    - `newTargetId` string, nullable
    - `newAlias` string, nullable

## Response `202`

Successful Response

- LinkMaintenanceResult
  - `success` boolean, required
  - `taskId` string, nullable

## Other responses

- `422`: Validation Error

---

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