Skip to content

Interface

An Interface is how a person or an Agent reaches a Product: an API, MCP server, CLI, SDK, Site, or App.

Properties

PropertyTypeRequiredDescription
kindstringrequiredOne of api, mcp, cli, sdk, site, app, docs, or webhooks.
pathstringWhere it is mounted on its Domain, such as /api.
conformsTojsonThe Standards it also speaks, each mapping the Standard’s operations onto the Product’s Verbs.

Object

JSON
{
  "$id": "https://api.sb/patentpad.com/interfaces/interface_1",
  "$type": "Interface",
  "kind": "api",
  "path": "/",
  "conformsTo": {
    "standard": "openai-chat",
    "operations": {
      "chat.completions.create": "Listing.write"
    }
  }
}

Relationships

  • An Interface is mounted on many Domains: an Interface answers requests on the hostnames it is mounted on. mountedOn, inverse mounts.
  • An Interface reaches one Product: each Interface exposes one Product; a Product is reached through many Interfaces. reaches, inverse reachedVia.
  • An Interface speaks many Standards: Callers in a Standard’s shape reach the Interface’s Verbs through the platform’s one translator for that Standard. speaks, inverse spokenBy.

Verbs

  1. createCreates an Interface.
    POST /{namespace}/interfacesdoInterface.created
  2. getReturns one Interface by id.
    GET /{namespace}/interfaces/{id}readNo Event
  3. listReturns Interfaces, newest first, one page at a time.
    GET /{namespace}/interfacesreadNo Event
  4. updateChanges the given properties of an Interface.
    PATCH /{namespace}/interfaces/{id}doInterface.updated
  5. deleteDeletes an Interface; its history is kept.
    DELETE /{namespace}/interfaces/{id}doInterface.deleted

Permissions

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

Operationowneradminmemberviewer
Interface.createYesYesYesNo
Interface.getYesYesYesYes
Interface.listYesYesYesYes
Interface.updateYesYesYesNo
Interface.deleteYesYesYesNo

Call it

Text
Add an interface to ShiftNote.

Example

A currency-conversion Product answers developers over the API, coding Agents as an MCP Tool, operators from the CLI, and people on its pricing Site.