Interface
An Interface is how a person or an Agent reaches a Product: an API, MCP server, CLI, SDK, Site, or App.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
kind | string | required | One of api, mcp, cli, sdk, site, app, docs, or webhooks. |
path | string | Where it is mounted on its Domain, such as /. | |
conformsTo | json | The Standards it also speaks, each mapping the Standard’s operations onto the Product’s Verbs. |
Object
{
"$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, inversemounts. - An Interface reaches one Product: each Interface exposes one Product; a Product is reached through many Interfaces.
reaches, inversereachedVia. - 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, inversespokenBy.
Verbs
createCreates an Interface.POST /{namespace}/interfacesgetReturns one Interface by id.GET /{namespace}/interfaces/{id}listReturns Interfaces, newest first, one page at a time.GET /{namespace}/interfacesupdateChanges the given properties of an Interface.PATCH /{namespace}/interfaces/{id}deleteDeletes an Interface; its history is kept.DELETE /{namespace}/interfaces/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Interface.create | Yes | Yes | Yes | No |
Interface.get | Yes | Yes | Yes | Yes |
Interface.list | Yes | Yes | Yes | Yes |
Interface.update | Yes | Yes | Yes | No |
Interface.delete | Yes | Yes | Yes | No |
Call it
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.