surfingdog-ai

surfingdog-ai Owner API

The owner API from surfingdog-ai — 60 operation(s) for owner.

GitHub OpenAPI

Operations 67

GET /v1/owner/items List items, newest change first #
GET /v1/owner/items/{id} One item with its events (who caused each, and through which door)… #
GET /v1/owner/spam The spam filter: its filters, learning weeks, counts, lists and the AI check's… #
PUT /v1/owner/spam/filters/{filter} Switch a spam filter on or off, or choose what it does (a person in person only) #
PUT /v1/owner/spam/ai Turn the AI check on or off, on a Pro the host gave for free (the owner in… #
POST /v1/owner/spam/filters/{filter}/start End a filter's learning week now (basic for the free protection) #
POST /v1/owner/spam/lists/domains Let everyone at a company's domain through #
DELETE /v1/owner/spam/lists Remove a row from Let through or Always put aside #
GET /v1/owner/spam/model Your AI model: what reads for the spam filters here, and whether you may bring… #
PUT /v1/owner/spam/model Keep your own AI model and its key, sealed (a person in person only) #
DELETE /v1/owner/spam/model Remove your AI model and its key #
POST /v1/owner/spam/model/models The provider's own list of models for a key (the key is used for the call, not… #
POST /v1/owner/spam/model/test Two samples through your model: a sales pitch spotted, a customer asking a… #
POST /v1/owner/items/{id}/let-in Let in a request the spam filter holds: it goes on, and its sender comes… #
POST /v1/owner/items/{id}/looks-fine Take the spam filter's label off a request, and let its sender through #
POST /v1/owner/items/{id}/spam Spam, on a request the filter holds: from Held to Spam #
POST /v1/owner/items/{id}/always-put-aside Always put aside what this request's sender sends #
POST /v1/owner/items/{id}/transitions Move an item to its next state #
POST /v1/owner/items/{id}/returns Open a return a customer asked for by email or phone, on their fulfilled order #
GET /v1/owner/items/{id}/offers Every offer of an item: the customer's request, what you proposed, each answer… #
POST /v1/owner/items/{id}/offers Make your offer: another time for a booking, changes to an order, a quote, a… #
GET /v1/owner/items/{id}/payments An order's pay links in your own Stripe or Mollie account, newest first, and… #
POST /v1/owner/items/{id}/payments/shop-total Propose the shop's total: the order at what your own shop counts, with its tax… #
POST /v1/owner/items/{id}/payments/stop-waiting Stop waiting for a payment from the customer's assistant that Stripe never… #
POST /v1/owner/items/{id}/offers/draft/send Send the draft your AI, a rule or another system made outside your limits, as… #
DELETE /v1/owner/items/{id}/offers/draft Drop the item's draft, unsent #
POST /v1/owner/items/{id}/replies Reply to the customer or add a note #
GET /v1/owner/customers/{id} One customer: their parties, items, emails, and whether booking networks are… #
GET /v1/owner/customers/{id}/export Everything the inbox holds about one customer, as one JSON document #
POST /v1/owner/customers/{id}/networks-off Stop using booking networks for one customer #
POST /v1/owner/customers/{id}/erase Erase one customer's personal data (cannot be undone) #
GET /v1/owner/mail Whether this inbox can send email #
GET /v1/owner/email The email channel: this inbox's own address, the addresses forwarded to it, and… #
GET /v1/owner/email/provider Which mail provider an address most likely lives at, from its domain and MX… #
POST /v1/owner/email/forwards Add an address the business forwards to this inbox (the owner in person) #
DELETE /v1/owner/email/forwards/{id} Stop expecting mail forwarded from an address #
POST /v1/owner/email/forwards/{id}/check Send a check to the business's own address: it comes back here if the forward… #
POST /v1/owner/email/forwards/{id}/confirmed The owner dealt with the provider's forwarding confirmation: stop showing it #
PUT /v1/owner/email/sender Send customers' emails from the business's own address, through the host (null… #
POST /v1/owner/email/sender/check Look at the business's DNS rows for sending again now #
GET /v1/owner/items/{id}/attachments What came attached to the item's emails, and what became of each file #
DELETE /v1/owner/attachments/{id} Delete one kept file (a person at the business): its bytes go, and the… #
GET /v1/owner/attachments/{id} One attached file, to download (never shown in the page) #
GET /v1/owner/settings The settings document, secrets left out (named in redacted) #
PUT /v1/owner/settings Change settings #
GET /v1/owner/receipts Whether this instance issues receipts, and how many it has #
POST /v1/owner/receipt-keys/rotate Make a new receipt key: the one that signed until now signs nothing more from… #
GET /v1/owner/networks The networks this inbox reports to, and how each one is doing #
GET /v1/owner/discovery The lines that lead AI agents from the business's own site to this inbox #
POST /v1/owner/discovery/check Ask Surfing Dog's checker whether the lines are in place #
GET /v1/owner/items/{id}/files A request's files, each with a link that works for ten minutes #
GET /v1/owner/items/{id}/job-tool Where a request stands in the job tool: the mode, the tools, what was sent #
POST /v1/owner/items/{id}/job-tool Send a request to the job tool now #
GET /v1/owner/work Settings → Area and Work, with what the business says of them in public #
GET /v1/owner/menu Settings → Menu: every product, its place on the menu, and what a person… #
PUT /v1/owner/menu/items/{id} Put a product on the menu, change its place there, or take it off (menu: null) #
POST /v1/owner/menu/items/{id}/allergens/confirm Confirm an item's allergens, exactly as shown (their fingerprint) #
POST /v1/owner/menu/items/{id}/sold-out Sold out today, or back on sale #
POST /v1/owner/menu/import Keep items from a connected tool's menu, read again from the tool #
PUT /v1/owner/services/{id}/tables A service's tables: covers in people, the largest party, a deposit, covers set… #
GET /v1/owner/kitchen Whether orders are taken now, and paused until when #
POST /v1/owner/kitchen/pause Pause orders for 15, 30 or 60 minutes or the rest of the day, or resume #
POST /v1/owner/items/{id}/progress An order's progress: preparing, ready, out for delivery #
GET /v1/owner/pos-orders Orders taken in your own ordering system, for your eyes only (no customer… #
GET /v1/owner/download Whether the inbox can be downloaded here #
POST /v1/owner/download Download the inbox: one SQLite file in a zip, with a README and a manifest #
POST /v1/owner/download/code Send the code a download needs to the owner's email #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/surfingdog-ai/openapi/surfingdog-ai-owner-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-schema0-schema.json
📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-listing-schema.json
📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-door-history-schema.json
📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-pay-with-schema.json
📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-product-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-offer-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/surfingdog-ai/json-schema/surfingdog-ai-read-allowance-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/surfingdog-ai:surfingdog-ai-owner-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

surfingdog-ai-owner-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Surfing Dog Inbox Owner API
  description: Typed inbox for people and AI agents. Public routes need no auth; /v1/owner needs an owner API key.
  version: 0.2.0
tags:


# --- truncated at 32 KB (283 KB total) ---
# Full source: https://artifacts.apis.io/surfingdog-ai/openapi/surfingdog-ai-owner-api-openapi.yml