# Implementation

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

> An Implementation is how an Interface, System, or Verb of a Product runs: managed by the platform, custom code on it, or external.

An Implementation is how an [Interface](/business/nouns/interface), [System](/business/nouns/system), or [Verb](/business/nouns/verb) of a [Product](/business/nouns/product) runs: managed by the platform, custom code on it, or external.

## Properties
| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | `string` | Yes | One of `managed`, `custom`, or `external`. |
| `endpoint` | `url` | No | For an external Implementation, where api.sb routes each call. |
| `deliverBy` | `date` | No | For a `declared` Implementation: when a Function runs the Verb; a missed date refunds every reserve. |

## Object
```json
{
  "$id": "https://api.sb/quietcopy.com/implementations/implementation_1",
  "$type": "Implementation",
  "kind": "managed",
  "endpoint": "https://quietcopy.com",
  "deliverBy": "2026-10-22"
}
```

## Relationships
- <a id="rel-runs"></a>An Implementation **runs** one [Product](/business/nouns/product): an Implementation runs an [Interface](/business/nouns/interface), [System](/business/nouns/system) or [Verb](/business/nouns/verb) of one [Product](/business/nouns/product). `runs`, inverse [`implementations`](/business/nouns/product#rel-implementations).

## Verbs
| Verb | Description | Subject | Event | Class |
| --- | --- | --- | --- | --- |
| <a id="create"></a>[Implementation.create](/business/nouns/implementation/create) | Creates an Implementation. Inherited from [Noun](/business/nouns/noun). | None. | `Implementation.created` | Two-way: `try`, `send`, `do` |
| <a id="get"></a>[Implementation.get](/business/nouns/implementation/get) | Returns one Implementation by id. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="list"></a>[Implementation.list](/business/nouns/implementation/list) | Returns Implementations, newest first, one page at a time. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="update"></a>[Implementation.update](/business/nouns/implementation/update) | Changes the given properties of an Implementation. Inherited from [Noun](/business/nouns/noun). | None. | `Implementation.updated` | Two-way: `try`, `send`, `do` |
| <a id="delete"></a>[Implementation.delete](/business/nouns/implementation/delete) | Deletes an Implementation; its history is kept. Inherited from [Noun](/business/nouns/noun). | None. | `Implementation.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` |
| --- | --- | --- | --- | --- |
| `Implementation.create` | Yes | Yes | Yes | No |
| `Implementation.get` | Yes | Yes | Yes | Yes |
| `Implementation.list` | Yes | Yes | Yes | Yes |
| `Implementation.update` | Yes | Yes | Yes | No |
| `Implementation.delete` | Yes | Yes | Yes | No |

## Call it

**Ask**

```text
Add an implementation to TutorLoop.
```

**API**

```bash
curl -X POST https://api.sb/tutorloop.com/implementations \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"managed"}'
```

```json
{
  "api": "https://api.sb/tutorloop.com",
  "implementation": {
    "$id": "https://api.sb/tutorloop.com/implementations/implementation_1",
    "$type": "Implementation",
    "kind": "managed"
  },
  "action": {
    "$id": "https://api.sb/tutorloop.com/actions/action_1",
    "operation": "Implementation.create",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/tutorloop.com/actions/action_1"
  }
}
```

**SDK**

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

const implementation = await $.Implementation.create({ kind: 'managed' })
```

**CLI**

```bash
npx startup-builder do Implementation.create --json '{"kind":"managed"}'
```

**MCP**

```json
{
  "name": "do",
  "arguments": {
    "code": "return await $.Implementation.create({ kind: 'managed' })"
  }
}
```

## Example
A permit tracker runs managed, except `Inspection.book`: its Implementation has kind `external` and an endpoint on the county's scheduling server. The [Implementation chapter](/code/builders/software/implementation) explains each mode.