Python SDK

import os
from meridian import Meridian

client = Meridian(os.environ["MERIDIAN_API_KEY"])

client = Meridian(
    os.environ["MERIDIAN_API_KEY"],
    timeout=30.0,        # seconds per attempt
    max_retries=3,       # for 429 and 5xx
)

from meridian import AsyncMeridian

client = AsyncMeridian(os.environ["MERIDIAN_API_KEY"])
project = await client.projects.create(name="billing-sync", region="us-east")

project = client.projects.create(name="billing-sync", region="us-east")

# Auto-paginating iterator
for p in client.projects.list(status="active"):
    print(p.id, p.name)

endpoint = client.webhooks.create(
    project_id=project.id,
    url="https://api.acme.io/webhooks/meridian",
    events=["project.updated"],
)

for event in client.events.list(project_id=project.id, type="project.updated"):
    print(event.sequence, event.data["object"]["name"])

key = client.keys.create(name="svc-ci", environment="test",
                         scopes=["events:read"], expires_in_days=30)

from meridian.webhooks import verify_signature, SignatureVerificationError

@app.post("/webhooks/meridian")
def receive(request):
    try:
        event = verify_signature(
            request.data,                       # raw bytes required
            request.headers["Meridian-Signature"],
            os.environ["WEBHOOK_SECRET"],
        )
    except SignatureVerificationError:
        return "", 400
    print(event["type"], event["data"]["object"]["id"])
    return "", 200

from meridian import MeridianError, RateLimitError, NotFoundError

try:
    client.projects.create(name="x", region="us-east")
except RateLimitError as e:
    retry_after = e.retry_after     # seconds from Retry-After header
except NotFoundError as e:
    print(e.request_id)
except MeridianError as e:
    print(e.status, e.code, e.request_id)

client = Meridian(
    api_key="mrnd_test_…",                  # or omit to read MERIDIAN_API_KEY
    base_url="https://api.meridian.dev/v2",
    timeout=30.0,
    max_retries=3,
    default_headers={"X-Team": "payments"},
    http_client=httpx.Client(proxy="…"),    # bring your own httpx client
)