Partner
A Partner is an outside Organization that is party to an Agreement with a Startup, supplying it, distributing its Offers, or both.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
side | string | required | One of supply, distribution, or both. |
Inherited from Organization: 2 properties
| Property | Type | Required | Description |
|---|---|---|---|
name | string | required | The name it trades under. |
hostname | string | The web domain that keys it. |
Object
{
"$id": "https: //api.sb/ kilnbakery.com/ partners/ partner_1",
"$type": "Partner",
"name": "Kiln Bakery",
"hostname": "kilnbakery.com",
"side": "supply"
}Relationships
- A Partner reserves many Organizations: an Organization a Partner reserved before referring it, for the
partner.reservationWindowSetting (90 days by default); outbound skips it.reserves, inversereservedBy.
Verbs
createCreates a Partner.POST /{namespace}/partnersgetReturns one Partner by id.GET /{namespace}/partners/{id}listReturns Partners, newest first, one page at a time.GET /{namespace}/partnersupdateChanges the given properties of a Partner.PATCH /{namespace}/partners/{id}deleteDeletes a Partner; its history is kept.DELETE /{namespace}/partners/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Partner.create | Yes | Yes | Yes | No |
Partner.get | Yes | Yes | Yes | Yes |
Partner.list | Yes | Yes | Yes | Yes |
Partner.update | Yes | Yes | Yes | No |
Partner.delete | Yes | Yes | Yes | No |
Call it
Add a partner to PetPantry.Example
A practice-management vendor refers law firms to a court-filings API under an Agreement for 20% of first-year revenue. It is a Partner on the distribution side.