---
title: "Versioning and deprecation. | pjespjes.com"
description: "The public agent API uses URL versioning so an integration can pin a stable contract and upgrade deliberately. The current stable surface is v1."
canonical: "https://pjespjes.com/en/developers/versioning"
image: "https://pjespjes.com/opengraph-image"
---

# Versioning and deprecation.

// API policy

The public agent API uses URL versioning so an integration can pin a stable contract and upgrade deliberately. The current stable surface is v1.

## URL versioning

Use /agent-api/v1 as the base URL. New non-breaking fields may be added to v1; existing fields, meanings, and documented error codes remain stable within the version.

## Breaking changes

A breaking change receives a new URL version, an updated OpenAPI document, and a migration note. The old version remains available during its published support window.

## Deprecation signals

When a version is scheduled for retirement, responses include Deprecation and Sunset headers plus a Link header with rel=deprecation. The policy page and OpenAPI metadata are updated at the same time.

## Current status

v1 is the current stable version and has no retirement date. There is no Sunset header until a real date has been announced.

// Response headers

```
X-API-Version: v1
RateLimit-Limit: 60;w=60
RateLimit-Remaining: 59
RateLimit-Reset: 42

# only when a retirement date is announced
Deprecation: @<unix-seconds>
Sunset: <HTTP-date>
Link: <https://pjespjes.com/developers/versioning>; rel="deprecation"
```

// Related resources

OpenAPI documentAPI directoryContact the operator

```json
[{"@context":"https://schema.org","@type":"Organization","@id":"https://tatbloxe.com/#organization","name":"TAT & BLOXE SH.P.K","legalName":"TAT & BLOXE SH.P.K","alternateName":["TAT & BLOXE","pjespjes.com","pjespjes"],"url":"https://tatbloxe.com","sameAs":["https://tatbloxe.com","https://pjespjes.com","https://github.com/AltinKukaj/HARDWAREEXPERT"],"areaServed":{"@type":"Country","name":"Kosovo"}},{"@context":"https://schema.org","@type":["Organization","LocalBusiness"],"@id":"https://pjespjes.com/#organization","name":"pjespjes.com","alternateName":"pjespjes","url":"https://pjespjes.com","logo":"https://pjespjes.com/brand/pj-mark.png","sameAs":["https://github.com/AltinKukaj/HARDWAREEXPERT","https://tatbloxe.com"],"description":"Kosovo PC builder with local store prices, grouped parts, and compatibility checks.","parentOrganization":{"@id":"https://tatbloxe.com/#organization"},"publisher":{"@id":"https://tatbloxe.com/#organization"},"areaServed":{"@type":"Country","name":"Kosovo"},"knowsAbout":["PC components","PC building","hardware compatibility","PC parts price comparison","Kosovo computer stores"],"telephone":"+38349808030","email":"contact@pjespjes.com","address":{"@type":"PostalAddress","streetAddress":"De Rada","addressLocality":"Prizren","addressCountry":"XK"},"contactPoint":{"@type":"ContactPoint","telephone":"+38349808030","email":"contact@pjespjes.com","contactType":"customer support","areaServed":"Kosovo","availableLanguage":["sq","en"]}},{"@context":"https://schema.org","@type":"WebSite","name":"pjespjes.com","alternateName":"pjespjes","url":"https://pjespjes.com/en","sameAs":["https://github.com/AltinKukaj/HARDWAREEXPERT","https://tatbloxe.com"],"description":"Compare PC part prices across Kosovo stores, check compatibility, and build. The local PCPartPicker alternative — grouped specs, history, and alerts.","inLanguage":"en-US","publisher":{"@id":"https://tatbloxe.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://pjespjes.com/en/parts/cpu?q={search_term_string}"},"query-input":"required name=search_term_string"}},{"@context":"https://schema.org","@type":"Service","@id":"https://pjespjes.com/#service","name":"pjespjes.com PC parts comparison and build planning","serviceType":"PC parts price comparison and compatibility planning","url":"https://pjespjes.com/en","description":"Compare PC part prices across Kosovo stores, check compatibility, and build. The local PCPartPicker alternative — grouped specs, history, and alerts.","provider":{"@id":"https://pjespjes.com/#organization"},"areaServed":{"@type":"Country","name":"Kosovo"},"audience":{"@type":"Audience","audienceType":"PC builders and hardware shoppers in Kosovo"},"availableChannel":{"@type":"ServiceChannel","serviceUrl":"https://pjespjes.com/agent-api/v1","serviceType":"Read-only catalog API"}}]
{"@context":"https://schema.org","@type":"TechArticle","headline":"Versioning and deprecation.","description":"The public agent API uses URL versioning so an integration can pin a stable contract and upgrade deliberately. The current stable surface is v1.","url":"https://pjespjes.com/en/developers/versioning","isPartOf":{"@type":"WebSite","name":"pjespjes.com","url":"https://pjespjes.com"}}
```