---
title: "Changes to Refresh agent snapshot"
method: POST
path: "/api/registry/agents/{encodedUrl}/refresh"
---

# Changes to Refresh agent snapshot

`POST /api/registry/agents/{encodedUrl}/refresh`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 71 revisions.

- **2026-09-24** `a680bde5ab35`: 1 info
- **2026-09-21** `7fe4a6cd5404`: 2 breaking, 1 warning, 5 info
- **2026-09-17** `cb485604bda3`: 2 breaking, 1 info
- **2026-09-13** `7b7f2a79e874`: 1 info
- **2026-09-13** `298c080b0c59`: 2 info
- **2026-08-30** `a296a08c54d2`: 9 info
- **2026-08-08** `cf570ee22860`: 1 info

## Changes

- **2026-09-24** `a680bde5ab35`: 1 info
  - added the required property `anyOf[subschema #2]/tracking_issue` to the response with the `503` status
- **2026-09-21** `7fe4a6cd5404`: 2 breaking, 1 warning, 5 info
  - the mandatory response header `Retry-After` removed for the status `503`
  - removed the required property `anyOf[subschema #2]/retry_after` from the response with the `503` status
  - added the new `refresh_authorization_provenance_required` enum value to the `anyOf[subschema #2]/code` response property for the response status `503`
  - added the required property `anyOf[subschema #2]/alternative_action` to the response with the `503` status
  - added the required property `anyOf[subschema #2]/alternative_description` to the response with the `503` status
  - added the required property `anyOf[subschema #2]/applies_to` to the response with the `503` status
  - added the required property `anyOf[subschema #2]/retryable` to the response with the `503` status
  - added the required property `anyOf[subschema #2]/scope` to the response with the `503` status
- **2026-09-17** `cb485604bda3`: 2 breaking, 1 info
  - the response's body type changed from `object` to no type for status `503`
  - removed the required property `error` from the response with the `503` status
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `503`
- **2026-09-13** `7b7f2a79e874`: 1 info
  - added the optional property `compliance/provenance` to the response with the `200` status
- **2026-09-13** `298c080b0c59`: 2 info
  - added the optional property `compliance/completeness` to the response with the `200` status
  - added the optional property `compliance/is_authoritative` to the response with the `200` status
- **2026-08-30** `a296a08c54d2`: 9 info
  - added the new optional `header` request parameter `Prefer`
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
  - added the optional property `coalesced` to the response with the `200` status
  - added the optional property `refresh_operation_id` to the response with the `200` status
  - added the optional property `status_url` to the response with the `200` status
  - added the optional property `test_session_id` to the response with the `200` status
  - added the required property `compliance/auth_available` to the response with the `200` status
  - added the success response with the status `202`
- **2026-08-08** `cf570ee22860`: 1 info
  - added optional request body

---

[Operation](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/docs/api/registry/agents/:encodedUrl/refresh/post.md) - [API](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) - [Page](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/changes/api/registry/agents/:encodedUrl/refresh/post)