---
title: "Watch an artifact for flag alerts"
method: POST
path: "/v1/me/watch"
tags: ["Alerts"]
---

# Watch an artifact for flag alerts

`POST /v1/me/watch`

## Request

- Base URL: `https://api.farofinance.app`
- URL: `https://api.farofinance.app/v1/me/watch`
- Auth: HTTP bearer

Register mandate-scoped interest in a normalized artifact node. When the node gains a critical/high signal, Faro POSTs an `artifact.flagged` webhook to your registered endpoints — even if you have not checked this node recently.

## Request body

- WatchIn: Register interest in an artifact for mandate-scoped alerts.
  - `type` 'url' | 'payee' | 'message' | 'document', required
  - `value` string, required: Artifact to watch.

## Response `201`

Successful Response

- WatchOut
  - `artifact_id` string, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/farofinance/apis/faro.md) · [All operations](https://skmtc.dev/farofinance/apis/faro/llms.txt) · [OpenAPI document](https://skmtc.dev/farofinance/apis/faro/revisions/205cdf54420b?raw)