---
title: "nowyourlink API versioning and deprecation"
description: "nowyourlink API, pricing and agent integration documentation."
canonical: "https://nowyourlink.com/versioning.md"
last-updated: "2026-09-21"
---

# nowyourlink API versioning and deprecation

The public REST interface uses URL versioning at /api/v1. Additive response fields and optional parameters can be introduced within v1; clients should ignore unknown response fields. Breaking contract changes require a new major URL version.

When an endpoint is scheduled for removal, its documentation will identify a replacement and migration instructions. Deprecated responses will advertise Deprecation and Sunset headers when a retirement date is set. No v1 retirement is currently scheduled. No minimum support period or service-level guarantee is offered. Urgent security, legal or removed-ad restrictions may make individual records unavailable immediately.

Read-only GET requests can be retried safely. MCP POST is a JSON-RPC transport: apart from the synthetic sandbox job, none of its tools mutates records, and no tool charges money. The only public write operation is the synthetic sandbox job at POST /api/v1/sandbox/jobs. It requires an Idempotency-Key header, answers 202 Accepted with a Location header, and the same key always maps to the same job. Production data is never written. These guarantees do not extend to the signed-in advertiser website.