---
title: "Changes to Register an agent for a sandbox key"
method: POST
path: "/api/v1/agents/register"
---

# Changes to Register an agent for a sandbox key

`POST /api/v1/agents/register`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 89 revisions.

- **2026-09-23** `ece7a25b7a44` — 3 warning, 3 info
- **2026-09-23** `8462acf80f8c` — 3 warning
- **2026-09-22** `1c5e270b4124` — 3 warning, 1 info
- **2026-09-22** `9958c95371de` — 6 warning
- **2026-09-22** `4bade829e228` — 6 warning
- **2026-09-22** `7b5489c2cd3e` — 14 warning, 1 info
- **2026-09-21** `4b70e1891f61` — 4 warning
- **2026-09-17** `05ff312f4bbc` — 2 warning
- **2026-09-16** `1b8c2226ee7b` — 1 info

## Changes

- **2026-09-23** `ece7a25b7a44` — 3 warning, 3 info
  - added the new `freshness_ceiling_unsatisfied` enum value to the `error/reason` response property for the response status `408`
  - added the new `freshness_ceiling_unsatisfied` enum value to the `error/reason` response property for the response status `429`
  - added the new `freshness_ceiling_unsatisfied` enum value to the `error/reason` response property for the response status `500`
  - added the optional property `error/freshness` to the response with the `408` status
  - added the optional property `error/freshness` to the response with the `429` status
  - added the optional property `error/freshness` to the response with the `500` status
- **2026-09-23** `8462acf80f8c` — 3 warning
  - added the new `export_expired` enum value to the `error/reason` response property for the response status `408`
  - added the new `export_expired` enum value to the `error/reason` response property for the response status `429`
  - added the new `export_expired` enum value to the `error/reason` response property for the response status `500`
- **2026-09-22** `1c5e270b4124` — 3 warning, 1 info
  - added the new `unknown_query_parameter` enum value to the `error/reason` response property for the response status `408`
  - added the new `unknown_query_parameter` enum value to the `error/reason` response property for the response status `429`
  - added the new `unknown_query_parameter` enum value to the `error/reason` response property for the response status `500`
  - added the new optional `header` request parameter `X-Query-Validation`
- **2026-09-22** `9958c95371de` — 6 warning
  - added the new `webhook_secret_rotation_not_prepared` enum value to the `error/reason` response property for the response status `408`
  - added the new `webhook_secret_rotation_not_prepared` enum value to the `error/reason` response property for the response status `429`
  - added the new `webhook_secret_rotation_not_prepared` enum value to the `error/reason` response property for the response status `500`
  - added the new `webhook_secret_rotation_overlap_active` enum value to the `error/reason` response property for the response status `408`
  - added the new `webhook_secret_rotation_overlap_active` enum value to the `error/reason` response property for the response status `429`
  - added the new `webhook_secret_rotation_overlap_active` enum value to the `error/reason` response property for the response status `500`
- **2026-09-22** `4bade829e228` — 6 warning
  - added the new `ip_rate_limited` enum value to the `error/reason` response property for the response status `408`
  - added the new `ip_rate_limited` enum value to the `error/reason` response property for the response status `429`
  - added the new `ip_rate_limited` enum value to the `error/reason` response property for the response status `500`
  - added the new `ip_throttled` enum value to the `error/reason` response property for the response status `408`
  - added the new `ip_throttled` enum value to the `error/reason` response property for the response status `429`
  - added the new `ip_throttled` enum value to the `error/reason` response property for the response status `500`
- **2026-09-22** `7b5489c2cd3e` — 14 warning, 1 info
  - added the new `invalid_body` enum value to the `error/reason` response property for the response status `429`
  - added the new `invalid_body` enum value to the `error/reason` response property for the response status `500`
  - added the new `invalid_path` enum value to the `error/reason` response property for the response status `429`
  - added the new `invalid_path` enum value to the `error/reason` response property for the response status `500`
  - added the new `invalid_query` enum value to the `error/reason` response property for the response status `429`
  - added the new `invalid_query` enum value to the `error/reason` response property for the response status `500`
  - added the new `method_not_allowed` enum value to the `error/reason` response property for the response status `429`
  - added the new `method_not_allowed` enum value to the `error/reason` response property for the response status `500`
  - added the new `payload_too_large` enum value to the `error/reason` response property for the response status `429`
  - added the new `payload_too_large` enum value to the `error/reason` response property for the response status `500`
  - added the new `request_timeout` enum value to the `error/code` response property for the response status `429`
  - added the new `request_timeout` enum value to the `error/code` response property for the response status `500`
  - added the new `unsupported_media_type` enum value to the `error/reason` response property for the response status `429`
  - added the new `unsupported_media_type` enum value to the `error/reason` response property for the response status `500`
  - added the media type `application/json` for the response with the status `408`
- **2026-09-21** `4b70e1891f61` — 4 warning
  - added the new `insufficient_scope` enum value to the `error/code` response property for the response status `429`
  - added the new `insufficient_scope` enum value to the `error/code` response property for the response status `500`
  - added the new `monthly_quota_exceeded` enum value to the `error/reason` response property for the response status `429`
  - added the new `monthly_quota_exceeded` enum value to the `error/reason` response property for the response status `500`
- **2026-09-17** `05ff312f4bbc` — 2 warning
  - added the new `api_key_in_query` enum value to the `error/reason` response property for the response status `429`
  - added the new `api_key_in_query` enum value to the `error/reason` response property for the response status `500`
- **2026-09-16** `1b8c2226ee7b` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/0xinsider/apis/0xinsider-api/docs/api/v1/agents/register/post.md) · [API](https://skmtc.dev/0xinsider/apis/0xinsider-api.md) · [Page](https://skmtc.dev/0xinsider/apis/0xinsider-api/changes/api/v1/agents/register/post)
