Withlocals · OpenAPI Overlay 1.0.0

Withlocals Partner API — API Evangelist enhancements

7 actions 7 updates update extends ../openapi/_original/withlocals-partner-api-openapi.yaml

Generated by API Evangelist Written by API Evangelist tooling for Withlocals's API. It is a proposal applied on top of the contract, not a document Withlocals publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-agent-hintsx-api-evangelistx-idempotency

Targets 7

$.info

$.paths['/bookings'].post

$.paths['/bookings/{bookingId}'].delete

$.paths['/bookings/{bookingId}'].patch

$.paths['/webhooks'].put

$.paths['/webhooks'].delete

$.paths[*].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: Withlocals Partner API — API Evangelist enhancements
  version: 1.0.0
x-generated: '2026-10-09'
x-method: generated
extends: ../openapi/_original/withlocals-partner-api-openapi.yaml
actions:
- target: $.info
  update:
    x-api-evangelist:
      provider: withlocals
      repo: https://github.com/api-evangelist/withlocals
      provider_hosted_spec: https://developers.withlocals.com/api-reference/openapi.yaml
- target: $.paths['/bookings'].post
  update:
    x-idempotency:
      header: Idempotency-Key
      maxLength: 255
      note: Declared on createBooking only. getSupplier documents supportsIdempotencyKey as currently false, so do not rely on it.
    x-agent-hints:
      retry_safe_with_idempotency_key: true
      conflict_status: 409
- target: $.paths['/bookings/{bookingId}'].delete
  update:
    x-agent-hints:
      destructive: true
      confirm_before_calling: true
      note: The booking persists with status=CANCELLED. It is not deleted.
- target: $.paths['/bookings/{bookingId}'].patch
  update:
    x-agent-hints:
      precondition_failed_status: 412
- target: $.paths['/webhooks'].put
  update:
    x-agent-hints:
      note: The signing secret is returned only once, on the first registration (201). Store it.
- target: $.paths['/webhooks'].delete
  update:
    x-agent-hints:
      destructive: true
      confirm_before_calling: true
- target: $.paths[*].get
  update:
    x-agent-hints:
      readOnly: true

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
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 overlay

curl "https://apis.io/api/v1/overlays/withlocals-partner-api-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?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.