# Human

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

> A Human is a Worker who is a person, acting on Tasks through Apps, Mailboxes, and Channels.

A Human is a [Worker](/business/nouns/worker) who is a person, acting on [Tasks](/business/nouns/task) through [Apps](/business/nouns/app), [Mailboxes](/business/nouns/mailbox), and [Channels](/business/nouns/channel).

## Properties
| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | `email` | Yes | The address the Human signs in with. |

<details>
<summary>Inherited from [Worker](/business/nouns/worker): 2 properties</summary>

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | The name the Worker goes by in a Startup. |
| `instructions` | `text` | No | How the Worker does its work. |

</details>

## Object
```json
{
  "$id": "https://api.sb/ledgerlark.com/humans/human_1",
  "$type": "Human",
  "name": "LedgerLark",
  "instructions": "Example instructions",
  "email": "priya@ledgerlark.com"
}
```

## Relationships
- <a id="rel-paid-in"></a>A Human **is paid in** many [Pay Runs](/business/nouns/pay-run): a [Pay Run](/business/nouns/pay-run) pays the Humans the [Company](/business/nouns/company) employs; each employee appears in one run per pay period. `paidIn`, inverse [`pays`](/business/nouns/pay-run#rel-pays).

## Verbs
| Verb | Description | Subject | Event | Class |
| --- | --- | --- | --- | --- |
| [Risk.accept](/business/nouns/risk/accept) | Accept records an officer’s signed Decision to carry a Risk untreated until its next review. | [Founder](/agents/founding/founder) | [`Risk.accepted`](/business/events/Risk.accepted) | One-way: `send`, `do` |
| [Action.attest](/business/nouns/action/attest) | Attest records a credentialed Human’s signed performance of a Reserved Act that an Action needs to finish. | [Legal Lead](/agents/legal/legal-lead) | [`Action.attested`](/business/events/Action.attested) | None. |
| [Startup.claim](/business/nouns/startup/claim) | Claim binds a provisional Startup to a verified owner, which enables payments and every Verb that moves money. | [Human](/business/nouns/human) | [`Startup.claimed`](/business/events/Startup.claimed) | None. |
| [Human.hold](/business/nouns/human/hold) | Hold sets aside part of a supplying Human’s earned balance against an open Dispute or an Order inside its clearance period. | [Billing Specialist](/agents/finance/billing-specialist) | [`Human.held`](/business/events/Human.held) | Two-way: `try`, `send`, `do` |
| [Human.invite](/business/nouns/human/invite) | Invite asks a person to join a Startup in a named Role, sharing that Role’s work with its Agent. | [Recruiter](/agents/people/recruiter) | [`Human.invited`](/business/events/Human.invited) | None. |
| [Human.onboard](/business/nouns/human/onboard) | Onboard admits a recruited Human to supply work once their identity, Credentials and payout details verify. | [Supply Manager](/agents/operations/supply-manager) | [`Human.onboarded`](/business/events/Human.onboarded) | None. |
| [Startup.pivot](/business/nouns/startup/pivot) | Pivot records a Decision that moves a Live Startup back to Building under a new Founding Hypothesis version. | [Founder](/agents/founding/founder) | [`Startup.pivoted`](/business/events/Startup.pivoted) | One-way (customer): `send`, `do` |
| [Human.recruit](/business/nouns/human/recruit) | Recruit invites a person to supply credentialed work to a Startup through its supply App. | [Supply Manager](/agents/operations/supply-manager) | [`Human.recruited`](/business/events/Human.recruited) | None. |
| [Human.release](/business/nouns/human/release) | Release frees a held amount for payout once its Dispute closes or its clearance period ends. | [Billing Specialist](/agents/finance/billing-specialist) | [`Human.released`](/business/events/Human.released) | Two-way: `try`, `send`, `do` |
| [Human.remit](/business/nouns/human/remit) | Remit pays a supplying Human’s earned balance to their bank account through the Startup’s payment account. | [Supply Manager](/agents/operations/supply-manager) | [`Human.remitted`](/business/events/Human.remitted) | One-way (money): `send`, `do` |
| [Agreement.sign](/business/nouns/agreement/sign) | Sign executes an Agreement for one Party and records the signature, the signer and the time. | [Founder](/agents/founding/founder) | [`Agreement.signed`](/business/events/Agreement.signed) | One-way (money): `send`, `do` |
| [Human.suspend](/business/nouns/human/suspend) | Suspend stops a supplying Human from taking new Tasks while a Credential lapses or a dispute is open. | [Supply Manager](/agents/operations/supply-manager) | [`Human.suspended`](/business/events/Human.suspended) | None. |
| <a id="create"></a>[Human.create](/business/nouns/human/create) | Creates a Human. Inherited from [Noun](/business/nouns/noun). | None. | `Human.created` | Two-way: `try`, `send`, `do` |
| <a id="get"></a>[Human.get](/business/nouns/human/get) | Returns one Human by id. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="list"></a>[Human.list](/business/nouns/human/list) | Returns Humans, newest first, one page at a time. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="update"></a>[Human.update](/business/nouns/human/update) | Changes the given properties of a Human. Inherited from [Noun](/business/nouns/noun). | None. | `Human.updated` | Two-way: `try`, `send`, `do` |
| <a id="delete"></a>[Human.delete](/business/nouns/human/delete) | Deletes a Human; its history is kept. Inherited from [Noun](/business/nouns/noun). | None. | `Human.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` |
| --- | --- | --- | --- | --- |
| `Human.create` | Yes | Yes | Yes | No |
| `Human.get` | Yes | Yes | Yes | Yes |
| `Human.list` | Yes | Yes | Yes | Yes |
| `Human.update` | Yes | Yes | Yes | No |
| `Human.delete` | Yes | Yes | Yes | No |
| `Human.hold` | Yes | Yes | Yes | No |
| `Human.invite` | Yes | Yes | Yes | No |
| `Human.onboard` | Yes | Yes | Yes | No |
| `Human.recruit` | Yes | Yes | Yes | No |
| `Human.release` | Yes | Yes | Yes | No |
| `Human.remit` | Yes | No | No | No |
| `Human.suspend` | Yes | Yes | Yes | No |

## Call it

**Ask**

```text
Remit Lena Fischer.
```

**API**

```bash
curl -X POST https://api.sb/petpantry.shop/humans/human_1/remit \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
```

```json
{
  "api": "https://api.sb/petpantry.shop",
  "transaction": {
    "$id": "https://api.sb/petpantry.shop/transactions/transaction_1",
    "$type": "Transaction",
    "kind": "charge",
    "amount": {
      "amount": 54,
      "currency": "USD"
    }
  },
  "human": {
    "$id": "https://api.sb/petpantry.shop/humans/human_1",
    "$type": "Human",
    "name": "Lena Fischer",
    "email": "lena@petpantry.shop"
  },
  "action": {
    "$id": "https://api.sb/petpantry.shop/actions/action_1",
    "operation": "Human.remit",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/petpantry.shop/actions/action_1"
  }
}
```

**SDK**

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

const { transaction, human } = await $.Human.remit({ human: 'human_1' })
```

**CLI**

```bash
npx startup-builder do Human.remit --json '{"human":"human_1"}'
```

**MCP**

```json
{
  "name": "do",
  "arguments": {
    "code": "return await $.Human.remit({ human: 'human_1' })"
  }
}
```

## Example
A certified court translator is a Human who fills a reviewer [Role](/business/nouns/role) at a translation marketplace. She works [Tasks](/business/nouns/task) in the App, and only she signs each certification.