---
title: "Update agent lifecycle stage"
method: PUT
path: "/api/registry/agents/{encodedUrl}/lifecycle"
tags: ["Agent Compliance"]
---

# Update agent lifecycle stage

`PUT /api/registry/agents/{encodedUrl}/lifecycle`

Set the lifecycle stage for an agent. Requires authentication and ownership of the agent.

## Path parameters

- `encodedUrl` string, required — URL-encoded agent URL

## Request body

- object
  - `lifecycle_stage` 'development' | 'testing' | 'production' | 'deprecated', required

## Response `200`

Updated metadata

- RegistryMetadata
  - `agent_url` string, required
  - `lifecycle_stage` 'development' | 'testing' | 'production' | 'deprecated', required
  - `compliance_opt_out` boolean, required
  - `monitoring_paused` boolean, required
  - `check_interval_hours` integer, required
  - `monitoring_paused_at` string, nullable, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400` — Invalid agent URL or lifecycle stage
- `401` — Authentication required
- `403` — Not authorized
- `500` — Server error

---

[API](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) · [All operations](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adcontextprotocol/agenticadvertising-org-registry-api/versions/9ea7fedf54c0/schema)