Skip to content

Product Template routes: update, delete

The Product Template Verbs update, delete as api.sb routes, with inputs, result, refusals and an example.

Reference for Product Template, one group of Product Template routes.

ProductTemplate.update

Changes the given properties of a Product Template. Verb page.

Text
PATCH /{namespace}/product-templates/{id}

Path: id. Body, as JSON: the other inputs. Emits ProductTemplate.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Product Template.
slugstringThe page path under /start/templates/products.
kindstringThe abstract Product: data, software, agent, or service.
supplystringWho supplies the work: digital, which is unlimited, or human, which is recruited and credentialed.
workerstringWho does the work: agents, humans, or agents-and-humans.
buyerstringWho buys: human, agent, or human-or-agent.
earningModelstringHow it earns: subscription, usage, commerce, marketplace, or directory.
assurancetextWhat the buyer can rely on, in one sentence.

Returns

OutputTypeRequiredDescription
productTemplateProduct TemplaterequiredThe Product Template.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X PATCH https://api.sb/leaseline.app/product-templates/ptpl_mLTPhHFQYD \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"leaseline"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "productTemplate": {
    "$id": "https://api.sb/leaseline.app/product-templates/ptpl_mLTPhHFQYD",
    "$type": "ProductTemplate",
    "slug": "leaseline",
    "kind": "data",
    "supply": "Example supply",
    "worker": "agents"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "ProductTemplate.update",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

ProductTemplate.delete

Deletes a Product Template: a soft delete that keeps its history, undone by Thing.restore. Verb page.

Text
DELETE /{namespace}/product-templates/{id}

Path: id. Emits ProductTemplate.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Product Template.

Returns

OutputTypeRequiredDescription
productTemplateProduct TemplaterequiredThe Product Template.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X DELETE https://api.sb/leaseline.app/product-templates/ptpl_mLTPhHFQYD \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
JSON
{
  "api": "https://api.sb/leaseline.app",
  "productTemplate": {
    "$id": "https://api.sb/leaseline.app/product-templates/ptpl_mLTPhHFQYD",
    "$type": "ProductTemplate",
    "slug": "leaseline",
    "kind": "data",
    "supply": "Example supply",
    "worker": "agents"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "ProductTemplate.delete",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}