# surfingdog-ai Owner API

**Canonical:** https://apis.io/apis/surfingdog-ai/surfingdog-ai-owner-api/  
**Provider:** surfingdog-ai — https://apis.io/providers/surfingdog-ai/  
**Base URL:** https://inbox.surfingdog.ai  
**Documentation:** https://inbox.surfingdog.ai/

surfingdog-ai Owner API is one of 13 APIs that [surfingdog-ai](https://apis.io/providers/surfingdog-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 7 JSON Schema definitions. Tagged areas include owner. The published artifact set on APIs.io includes an OpenAPI specification and 7 JSON Schemas.

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

## Operations (60 of 67)

| Method | Path | Summary |
|---|---|---|
| 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… |

…and 7 more operations. They are listed in full on the page.

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/surfingdog-ai/openapi/surfingdog-ai-owner-api-openapi.yml
- **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

## Other surfingdog-ai APIs (12)

- [surfingdog-ai Census API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-census-api/)
- [surfingdog-ai Directory API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-directory-api/)
- [surfingdog-ai Integrations API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-integrations-api/)
- [surfingdog-ai Keys API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-keys-api/)
- [surfingdog-ai Owners API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-owners-api/)
- [surfingdog-ai Products API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-products-api/)
- [surfingdog-ai Public API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-public-api/)
- [surfingdog-ai Reports API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-reports-api/)
- [surfingdog-ai Rules API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-rules-api/)
- [surfingdog-ai Score API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-score-api/)
- [surfingdog-ai Setup API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-setup-api/)
- [surfingdog-ai Stays API](https://apis.io/apis/surfingdog-ai/surfingdog-ai-stays-api/)

## Tags

owner

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/surfingdog-ai/surfingdog-ai-owner-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/surfingdog-ai/.