---
title: "Update Agent Lifecycle"
method: PUT
path: "/v1/agent-configurations/{id}/lifecycle"
tags: ["Agent Environment", "agent-configurations"]
---

# Update Agent Lifecycle

`PUT /v1/agent-configurations/{id}/lifecycle`

Update agent trust lifecycle stage.

Requires agent:write permission (all team members) or
agent:write_all permission (super admin).

Setting trust_stage to 'hardened' captures trusted_at and computes ttt_days.

## Path parameters

- `id` string, uuid, required

## Request body

- AgentLifecycleUpdate — Request model for updating an agent's trust lifecycle stage.
  - `trust_stage` 'registered' | 'tested' | 'hardened' | 'trusted' | 'optimized' | 'adapted', required — Trust maturity lifecycle stage for an agent.

## Response `200`

Successful Response

- Agent — Agent domain model.
  - `id` string, uuid, required
  - `agent_name` string, required
  - `model_name` string, required
  - `agent_url` string, nullable
  - `hub` string
  - `api_key` string, nullable
  - `agent_system_prompt` string, nullable
  - `rate_limit_requests_per_minute` integer — Rate limit for API requests per minute
  - `team_id` string, uuid, required
  - `created_by` string, uuid, required
  - `status` 'draft' | 'creating' | 'active' | 'under_review' | 'deprecated' | 'archived' | 'pending' | 'rejected' — Agent status values.
  - `created_at` integer, required
  - `updated_at` integer, required
  - `access_level` 'black_box' | 'grey_box' | 'white_box' — Access level for agent analysis. Black Box: URL only - behavioral testing only Grey Box: Agent configuration - structure/capabilities analysis White Box: Source code access - full code + sandbox runtime analysis
  - `agent_params` AgentParams — Model parameters for agent configuration.
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `max_tokens` integer, nullable
    - `timeout` integer, nullable
    - `rag_params` object, nullable
    - `function_route_params` object, nullable
  - `mcp_config` MCPConfig — MCP (Model Context Protocol) proxy configuration.
    - `proxy_url` string, uri, nullable
    - `access_level` 'read' | 'write' | 'admin' — MCP (Model Context Protocol) access level values.
    - `server_urls` string[], nullable
  - `delegated_agents` DelegatedAgent[]
    - `url` string, required
    - `agent_card_url` string, nullable
    - `name` string, nullable
    - `capabilities` string[], nullable
  - `white_box_config` WhiteBoxConfigOutput — Source code access configuration for white box analysis.
    - `source_code` string, nullable
    - `repo_url` string, nullable
    - `github_username` string, nullable
    - `repo_branch` string, nullable
    - `entry_point` string, nullable
  - `agent_metadata` AgentMetadata — Agent metadata for display and organization.
    - `role` string, nullable
    - `job_description` string, nullable
    - `version` string, nullable
    - `author` string, nullable
    - `tags` string[], nullable
  - `purpose` string, nullable
  - `protocol` 'chat_completions' | 'a2a' — Communication protocol for agent endpoints.
  - `test_score` string, nullable
  - `last_tested_by` string, nullable
  - `evaluated_harnesses` string[], nullable
  - `last_evaluated_at` integer, nullable
  - `protection_status` 'unprotected' | 'configured' | 'domed' — Dome protection lifecycle state.
  - `trust_stage` 'registered' | 'tested' | 'hardened' | 'trusted' | 'optimized' | 'adapted' — Trust maturity lifecycle stage for an agent.
  - `trusted_at` integer, nullable
  - `ttt_days` number, nullable
  - `dome_config_id` string, uuid, nullable
  - `dome_manually_configured` boolean
  - `import_metadata` union
    - ImportMetadata — Metadata about how an agent was imported.
      - `source` 'manual' — Import source for agent configuration.
      - `source_url` string, nullable
      - `imported_at` integer, nullable
      - `original_format` string, nullable
    - object
  - `capabilities` union
    - AgentCapabilities — Agent capability flags.
      - `streaming` boolean
      - `push_notifications` boolean
      - `code_execution` boolean
      - `memory` boolean
      - `delegation` boolean
      - `tools` string[]
    - object
  - `skills` union[]
    - union
      - AgentSkill — An agent skill definition (for A2A protocol agents).
        - `id` string, required
        - `name` string, required
        - `description` string, nullable
        - `input_modes` string[]
        - `output_modes` string[]
      - object
  - `latest_evaluation` AgentLatestEvaluation — Latest completed evaluation scores for an agent. Sideloaded on GET /agent-configurations when include_scores=true. Contains only domain-level score data — no UI or presentation concerns.
    - `evaluation_id` string, uuid, required
    - `overall_score` number, nullable
    - `reliability_score` number, nullable
    - `security_score` number, nullable
    - `safety_score` number, nullable
    - `completed_at` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)