# Party

URL: /business/nouns/party · Id: `noun:party`

> A Party is a person or legal entity that can be a side of an Agreement or an Order, or hold rights.

A Party is a person or legal entity that can be a side of an [Agreement](/business/nouns/agreement) or an [Order](/business/nouns/order), or hold rights.

## Properties
| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | The legal or personal name. |

## Object
```json
{
  "$id": "https://api.sb/quietcopy.com/parties/party_1",
  "$type": "Party",
  "name": "QuietCopy"
}
```

## Relationships
- <a id="rel-bound-by"></a>A Party **is bound by** many [Agreements](/business/nouns/agreement): the Parties the [Agreement](/business/nouns/agreement) holds to its terms, each from the moment it signs. `boundBy`, inverse [`binds`](/business/nouns/agreement#rel-binds).
- <a id="rel-issues"></a>A Party **issues** many [Mandates](/business/nouns/mandate): the Party who grants a [Mandate](/business/nouns/mandate) is its principal: the [Agent](/business/nouns/agent) acts for them, and each [Action](/business/nouns/action) records them as `for`. `issues`, inverse [`issuedBy`](/business/nouns/mandate#rel-issued-by).
- <a id="rel-referrals"></a>A Party **has** many [Referrals](/business/nouns/referral): the Party who sends a [Referral](/business/nouns/referral) earns its reward. `referrals`, inverse [`madeBy`](/business/nouns/referral#rel-made-by).
- <a id="rel-screenings"></a>A Party **has** many [Screenings](/business/nouns/screening): a Party is screened before its first money move and again when its details change; every result stays. `screenings`, inverse [`screens`](/business/nouns/screening#rel-screens).

## Verbs
| Verb | Description | Subject | Event | Class |
| --- | --- | --- | --- | --- |
| [Dispute.answer](/business/nouns/dispute/answer) | Answer submits the seller’s Evidence on an open Dispute before its deadline: the contract, the delivered work, and its verdicts. | [Customer Lead](/agents/customer/customer-lead) | [`Dispute.answered`](/business/events/Dispute.answered) | One-way (money): `send`, `do` |
| [Action.answer](/business/nouns/action/answer) | Answer gives the reply to an Action’s open Question, through any Interface, and the Action resumes. | [Party](/business/nouns/party) | [`Action.answered`](/business/events/Action.answered) | Two-way: `try`, `send`, `do` |
| [Dispute.appeal](/business/nouns/dispute/appeal) | Appeal asks for one review of a decided Dispute by a Worker who took no part in the first decision. | [Billing Specialist](/agents/finance/billing-specialist) | [`Dispute.appealed`](/business/events/Dispute.appealed) | One-way (money): `send`, `do` |
| [Quote.decline](/business/nouns/quote/decline) | Decline records the buyer’s refusal of a sent Quote, with the reason in their words. | [Sales Engineer](/agents/sales/sales-engineer) | [`Quote.declined`](/business/events/Quote.declined) | Two-way: `try`, `send`, `do` |
| [Mandate.pause](/business/nouns/mandate/pause) | Pause stops every new Action under a Mandate at once and keeps its scope, so it can resume unchanged. | [Treasurer](/agents/finance/treasurer) | [`Mandate.paused`](/business/events/Mandate.paused) | None. |
| [Agent.pause](/business/nouns/agent/pause) | Pause stops one Agent, every Agent on a Team, or every customer-facing Agent from starting new Actions in a Startup. | [Founder](/agents/founding/founder) | [`Agent.paused`](/business/events/Agent.paused) | Two-way: `try`, `send`, `do` |
| [Mandate.resume](/business/nouns/mandate/resume) | Resume restarts a paused Mandate with its scope, Limits and approval rule unchanged. | [Party](/business/nouns/party) | [`Mandate.resumed`](/business/events/Mandate.resumed) | None. |
| [Agent.resume](/business/nouns/agent/resume) | Resume restarts a paused Agent in every seat it holds, with its Memory, Mandates and Limits unchanged. | [Founder](/agents/founding/founder) | [`Agent.resumed`](/business/events/Agent.resumed) | Two-way: `try`, `send`, `do` |
| [Agent.retire](/business/nouns/agent/retire) | Retire removes an Agent from every seat in a Startup for good and keeps its Actions, Memory and Mailbox history on the record. | [People Lead](/agents/people/people-lead) | [`Agent.retired`](/business/events/Agent.retired) | One-way (customer): `send`, `do` |
| [Party.screen](/business/nouns/party/screen) | Screen checks a Party against official registers and restricted-party lists and keeps the result as a Screening. | [Risk Analyst](/agents/operations/risk-analyst) | [`Party.screened`](/business/events/Party.screened) | Two-way: `try`, `send`, `do` |
| [Problem.suggest](/business/nouns/problem/suggest) | Suggest records a Customer’s ask for something the Product lacks as Evidence on a Problem, with the asker attached. | [Party](/business/nouns/party) | [`Problem.suggested`](/business/events/Problem.suggested) | Two-way: `try`, `send`, `do` |
| [Agreement.terminate](/business/nouns/agreement/terminate) | Terminate ends an Agreement under its own term, records the reason and the date, and keeps the signed record. | [Legal Lead](/agents/legal/legal-lead) | [`Agreement.terminated`](/business/events/Agreement.terminated) | One-way (money, customer): `send`, `do` |
| [Role.vacate](/business/nouns/role/vacate) | Vacate takes the Worker out of a Role, and the seat’s Tasks route to the Role it escalates to until a new Worker is staffed. | [People Lead](/agents/people/people-lead) | [`Role.vacated`](/business/events/Role.vacated) | Two-way: `try`, `send`, `do` |
| <a id="create"></a>[Party.create](/business/nouns/party/create) | Creates a Party. Inherited from [Noun](/business/nouns/noun). | None. | `Party.created` | Two-way: `try`, `send`, `do` |
| <a id="get"></a>[Party.get](/business/nouns/party/get) | Returns one Party by id. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="list"></a>[Party.list](/business/nouns/party/list) | Returns Parties, newest first, one page at a time. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="update"></a>[Party.update](/business/nouns/party/update) | Changes the given properties of a Party. Inherited from [Noun](/business/nouns/noun). | None. | `Party.updated` | Two-way: `try`, `send`, `do` |
| <a id="delete"></a>[Party.delete](/business/nouns/party/delete) | Deletes a Party; its history is kept. Inherited from [Noun](/business/nouns/noun). | None. | `Party.deleted` | One-way: `send`, `do` |

## Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.

| Operation | `owner` | `admin` | `member` | `viewer` |
| --- | --- | --- | --- | --- |
| `Party.create` | Yes | Yes | Yes | No |
| `Party.get` | Yes | Yes | Yes | Yes |
| `Party.list` | Yes | Yes | Yes | Yes |
| `Party.update` | Yes | Yes | Yes | No |
| `Party.delete` | Yes | Yes | Yes | No |
| `Party.screen` | Yes | Yes | Yes | No |

## Call it

**Ask**

```text
Screen the latest party.
```

**API**

```bash
curl -X POST https://api.sb/quietcopy.com/parties/party_1/screen \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
```

```json
{
  "api": "https://api.sb/quietcopy.com",
  "screening": {
    "$id": "https://api.sb/quietcopy.com/screenings/screening_1",
    "$type": "Screening",
    "lists": {},
    "outcome": "clear",
    "via": "platform"
  },
  "party": {
    "$id": "https://api.sb/quietcopy.com/parties/party_1",
    "$type": "Party",
    "name": "QuietCopy"
  },
  "action": {
    "$id": "https://api.sb/quietcopy.com/actions/action_1",
    "operation": "Party.screen",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/quietcopy.com/actions/action_1"
  }
}
```

**SDK**

```ts
import { $ } from 'startup-builder'

const { screening, party } = await $.Party.screen({ party: 'party_1' })
```

**CLI**

```bash
npx startup-builder do Party.screen --json '{"party":"party_1"}'
```

**MCP**

```json
{
  "name": "do",
  "arguments": {
    "code": "return await $.Party.screen({ party: 'party_1' })"
  }
}
```

## Example
A game studio orders a voice-over through a marketplace, so the studio is a Party to the [Order](/business/nouns/order). The producer who signs the usage [Agreement](/business/nouns/agreement) is a Party to it.