> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terrapinfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assignments

> Attach automated work to every entity in a watchlist.

An assignment ties a [watchlist](/platform-guide/watchlists/introduction) to a piece of work that should run across every entity in it. The platform discovers new inputs (documents, trades), processes them, and surfaces the output as **events** on the watchlist and in [Surveillance](/platform-guide/surveillance).

Once an assignment is attached, it keeps working in the background. New disclosures or trades for any entity trigger another run automatically. You don't need to re-trigger anything.

## Adding an assignment

On the watchlist detail page, click **Add Assignment**. Pick a **Type** and fill in the parameters below.

## Assignment types

### Prompt Template

Runs a saved [prompt template](/platform-guide/prompt-templates) against every entity in the watchlist. Common uses are tear sheets, financial summaries, and any structured write-up where you want the same analytical lens applied to many credits.

**Parameters**

| Field                       | Description                                                                                                                                                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Discovery Scope**         | *By Obligor (all deals)* runs the prompt once per obligor, pooling every CUSIP under it. *By CUSIP (single bond)* pins it to a specific bond, useful when bond-level structural detail matters (different liens, etc.). |
| **Template**                | Which saved template to apply.                                                                                                                                                                                          |
| **Years Back**              | How many years of disclosure history to include (1, 2, 3, or 5).                                                                                                                                                        |
| **Document Types**          | Which categories to include. *Official Statement* is required; add *Disclosure document* for ongoing filings.                                                                                                           |
| **Filing Types** (optional) | Narrow disclosure documents to specific filing categories: annual financial, audited statements, quarterly/monthly, interim, other financial data.                                                                      |

When the assignment runs, the prompt is rendered against the matching documents, the agent extracts the requested information, and the result is stored as an event. Browse the events from the watchlist page or in Surveillance; click an event to see the agent's full reasoning and citations.

### Document Publication

Emits an event each time a new disclosure is published for any entity in the watchlist. Every event includes the document metadata (name, type, filing type, publish date) and an **AI-generated summary** with key takeaways, so you can triage from the feed without opening every PDF.

The lightweight option for keeping tabs on a portfolio: no prompt to author, no template required. From any event you can:

* Set a priority or mark it completed.
* Click **Deep Dive** on the event to open a fresh [Deep Dive session](/platform-guide/deep-dive/introduction) pre-scoped to that disclosure.

**Parameters**

| Field          | Description                                                                                                                                            |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Years Back** | How far back to backfill events when the assignment is first attached. Going forward, every new disclosure produces an event regardless of years-back. |

### Price Update

Emits an event each time a bond in the watchlist trades. Useful when you want a heads-up on activity instead of waiting to spot it in the daily flow.

## Stopping an assignment

From the watchlist's assignment list, open an assignment and click **Delete**. Existing events stay searchable in Surveillance for audit. No new events are emitted.

## Where output shows up

In three places:

* **The watchlist detail page**: events from every assignment on the watchlist, newest first.
* **[Surveillance](/platform-guide/surveillance)**: the cross-watchlist feed, with filters by watchlist, entity, type, period, and flag/priority.
* The **events page for a specific assignment** at `/platform/events/<assignment_id>`.

<Tip>For batch extraction of comparable metrics across all entities (e.g. "Operating revenue and DSCR for every obligor across the last three years"), use [Data Tables](/platform-guide/data-tables). Data Tables runs one prompt across the watchlist and assembles the results into a sortable matrix. A Prompt Template assignment gives you a per-entity write-up instead.</Tip>