curl -X PUT https://maatstays.wtf/v1/blocks/ota-res-55123 \
  -H "Authorization: Bearer $MAAT_PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "listing_id": "7c4b1e58-2a90-4f61-b3d2-5e8a1c0f7d24",
    "check_in": "2026-09-01",
    "check_out": "2026-09-05",
    "reason": "reserved"
  }'

const res = await fetch('https://maatstays.wtf/v1/blocks/ota-res-55123', {
    method: 'PUT',
    headers: {
        Authorization: `Bearer ${process.env.MAAT_PARTNER_TOKEN}`,
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        listing_id: '7c4b1e58-2a90-4f61-b3d2-5e8a1c0f7d24',
        check_in: '2026-09-01',
        check_out: '2026-09-05', // exclusive — the departure day
        reason: 'reserved',
    }),
});

const body = await res.json();
if (res.status === 409) {
    // The whole range was refused; nothing was written.
    throw new Error(`nights already taken on Maat: ${body.conflicts}`);
}
if (!res.ok) throw new Error(`${body.code}: ${body.detail}`);

console.log(body.result, body.nights);

import os

import requests

res = requests.put(
    "https://maatstays.wtf/v1/blocks/ota-res-55123",
    headers={"Authorization": f"Bearer {os.environ['MAAT_PARTNER_TOKEN']}"},
    json={
        "listing_id": "7c4b1e58-2a90-4f61-b3d2-5e8a1c0f7d24",
        "check_in": "2026-09-01",
        "check_out": "2026-09-05",  # exclusive — the departure day
        "reason": "reserved",
    },
    timeout=30,
)

body = res.json()
if res.status_code == 409:
    # The whole range was refused; nothing was written.
    raise RuntimeError(f"nights already taken on Maat: {body['conflicts']}")
if res.status_code >= 400:
    raise RuntimeError(f"{body['code']}: {body.get('detail')}")

print(body["result"], body["nights"])

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]string{
        "listing_id": "7c4b1e58-2a90-4f61-b3d2-5e8a1c0f7d24",
        "check_in":   "2026-09-01",
        "check_out":  "2026-09-05", // exclusive — the departure day
        "reason":     "reserved",
    })

    req, _ := http.NewRequest(http.MethodPut,
        "https://maatstays.wtf/v1/blocks/ota-res-55123",
        bytes.NewReader(payload))
    req.Header.Set("Authorization", "Bearer "+os.Getenv("MAAT_PARTNER_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer res.Body.Close()

    var body map[string]any
    if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
        log.Fatal(err)
    }
    if res.StatusCode == http.StatusConflict {
        // The whole range was refused; nothing was written.
        log.Fatalf("nights already taken on Maat: %v", body["conflicts"])
    }
    if res.StatusCode >= 400 {
        log.Fatalf("%v: %v", body["code"], body["detail"])
    }

    fmt.Println(body["result"], body["nights"])
}

{
  "external_uid": "ota-res-55123",
  "result": "created",
  "nights": 4,
  "listing_id": "7c4b1e58-2a90-4f61-b3d2-5e8a1c0f7d24"
}

{
  "type": "https://developer.maatstays.wtf/errors/validation-failed",
  "title": "Validation failed",
  "status": 400,
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "validation_failed",
  "errors": [
    {
      "field": "body.check_out",
      "code": "custom"
    }
  ]
}

{
  "type": "https://developer.maatstays.wtf/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid partner token is required.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "unauthorized"
}

{
  "type": "https://developer.maatstays.wtf/errors/workspace-scope-mismatch",
  "title": "Workspace scope mismatch",
  "status": 403,
  "detail": "This token is not valid for the requested workspace.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "workspace_scope_mismatch"
}

{
  "type": "https://developer.maatstays.wtf/errors/property-not-found",
  "title": "Property not found",
  "status": 404,
  "detail": "No such property in this workspace. Nothing was blocked.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "property_not_found"
}

{
  "type": "https://developer.maatstays.wtf/errors/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "These nights are already booked or held on Maat, so the block was not applied: 2026-09-02, 2026-09-03. Nothing was written — the whole range was refused rather than part of it.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "conflict",
  "conflicts": [
    "2026-09-02",
    "2026-09-03"
  ]
}

{
  "type": "https://developer.maatstays.wtf/errors/rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "Too many requests for this API key.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "rate_limited"
}

{
  "type": "https://developer.maatstays.wtf/errors/internal-error",
  "title": "Internal error",
  "status": 500,
  "detail": "The request could not be completed.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "internal_error"
}

{
  "type": "https://developer.maatstays.wtf/errors/not-enabled",
  "title": "Not implemented",
  "status": 501,
  "detail": "The calendar-blocks contract is published but not yet enabled. This request was authenticated and validated; no dates were blocked. Keep holding these dates on your own platform.",
  "instance": "urn:maat:request:3b1f7a90-0d4c-4d4e-9b2a-6c1f0a2e5d33",
  "code": "not_enabled"
}