Update agent lifecycle stage

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

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

Update agent lifecycle stage

cURL

curl --request PUT \
  --url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/lifecycle \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "agent_url": "<string>",
  "compliance_opt_out": true,
  "monitoring_paused": true,
  "check_interval_hours": 123,
  "monitoring_paused_at": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

bearerAuthoauth2

Authorization · string · header · required

Bearer token in the Authorization header. Two token types are accepted:

• Organization API key (sk_...) issued via the dashboard. Org-scoped, long-lived, for server-to-server use.
• User JWT obtained via the OAuth 2.1 authorization code flow with PKCE. User-scoped, short-lived. Discover the authorization server at /.well-known/oauth-authorization-server and the protected-resource metadata at /.well-known/oauth-protected-resource/api.

Path Parameters

encodedUrl · string · required

URL-encoded agent URL

Body

application/json

lifecycle_stage · enum<string> · required

Available options: development, testing, production, deprecated

Response

200

application/json

Updated metadata

agent_url · string · required

lifecycle_stage · enum<string> · required

Available options: development, testing, production, deprecated

compliance_opt_out · boolean · required

monitoring_paused · boolean · required

check_interval_hours · integer · required

monitoring_paused_at · string | null · required

created_at · string · required

updated_at · string · required