---
title: "Archive Agent Configuration"
method: PUT
path: "/v1/agent-configurations/{id}/archive"
tags: ["Agent Environment", "agent-configurations"]
---

# Archive Agent Configuration

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

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/vijilai/apis/vijil-console-api-combined/docs/v1/agent-configurations/:id/archive/put.ts> (a function with typed inputs; its response is checked against the schema)

Archive agent configuration.

Sets the agent status to ARCHIVED.
Requires agent:write permission (all team members) or
agent:write_all permission (super admin).

## Path parameters

- `id` string, uuid, required

## 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.dev/vijilai/apis/vijil-console-api-combined.md) - [All operations](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/llms.txt) - [OpenAPI document](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/revisions/a8b2ee2b2d06?raw)