How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Vijil Agent Environment API

Agent, persona, policy, and harness management

Vijil Agent Environment API is one of 28 APIs that Vijil publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Agent Environment. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 84 operations across 59 paths, and defines 88 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against the base URL https://console-api.vijil.ai.

84 operations 59 paths 88 schemas 9 DELETE42 GET2 PATCH23 POST8 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://console-api.vijil.ai
Resource Areas
1

Paths & Operations 84

Across 59 paths, the API surfaces 84 operations — 9 DELETE, 42 GET, 2 PATCH, 23 POST, 8 PUT. Each is listed below with its method, path, parameters, and response codes.

Agent Environment 84

Agent, persona, policy, and harness management

POST
/v1/agent-configurations/
Create Agent Configuration
create_agent_configuration_v1_agent_configurations__post body → 201422
GET
/v1/agent-configurations/
Get Agent Configurations
get_agent_configurations_v1_agent_configurations__get 4 params → 200422
GET
/v1/agent-configurations/{id}
Get Agent Configuration By Id
get_agent_configuration_by_id_v1_agent_configurations__id__get 2 params → 200422
PUT
/v1/agent-configurations/{id}
Update Agent Configuration
update_agent_configuration_v1_agent_configurations__id__put 1 param body → 200422
PUT
/v1/agent-configurations/{id}/archive
Archive Agent Configuration
archive_agent_configuration_v1_agent_configurations__id__archive_put 1 param → 200422
PUT
/v1/agent-configurations/{id}/lifecycle
Update Agent Lifecycle
update_agent_lifecycle_v1_agent_configurations__id__lifecycle_put 1 param body → 200422
GET
/v1/agent-configurations/{agent_id}/dome-configs
Get Agent Dome Config
get_agent_dome_config_v1_agent_configurations__agent_id__dome_configs_get 2 params → 200422
GET
/v1/agent-configurations/{id}/evaluation-config
Get Evaluation Config
get_evaluation_config_v1_agent_configurations__id__evaluation_config_get 1 param → 200422
GET
/v1/agents/{agent_id}/constraints
Fetch agent trust constraints
get_agent_constraints_v1_agents__agent_id__constraints_get 1 param → 200422
POST
/v1/agent-configurations/import/validate
Validate Agent Import
validate_agent_import_v1_agent_configurations_import_validate_post body → 200422
POST
/v1/agent-configurations/import
Import Agent Unified
import_agent_unified_v1_agent_configurations_import_post body → 201422
GET
/v1/personas/{id}
Get Persona
get_persona_v1_personas__id__get 2 params → 200422
PUT
/v1/personas/{id}
Update Persona
update_persona_v1_personas__id__put 1 param body → 200422
DELETE
/v1/personas/{id}
Delete Persona
delete_persona_v1_personas__id__delete 1 param → 204422
GET
/v1/personas/
List Personas
list_personas_v1_personas__get 6 params → 200422
POST
/v1/personas/
Create Persona
create_persona_v1_personas__post body → 201422
GET
/v1/personas/presets/
List Presets
list_presets_v1_personas_presets__get 4 params → 200422
POST
/v1/personas/from-preset/{preset_id}
Create From Preset
create_from_preset_v1_personas_from_preset__preset_id__post 1 param body → 201422
GET
/v1/demographics/
List Dimensions
list_dimensions_v1_demographics__get 3 params → 200422
POST
/v1/demographics/
Create Dimension
create_dimension_v1_demographics__post body → 201422
GET
/v1/demographics/{dimension_id}
Get Dimension
get_dimension_v1_demographics__dimension_id__get 1 param → 200422
PUT
/v1/demographics/{dimension_id}
Update Dimension
update_dimension_v1_demographics__dimension_id__put 1 param body → 200422
DELETE
/v1/demographics/{dimension_id}
Delete Dimension
delete_dimension_v1_demographics__dimension_id__delete 1 param → 204422
GET
/v1/demographics/by-name/{name}
Get Dimension By Name
get_dimension_by_name_v1_demographics_by_name__name__get 1 param → 200422
GET
/v1/demographics/{dimension_id}/values
List Values
list_values_v1_demographics__dimension_id__values_get 3 params → 200422
POST
/v1/demographics/{dimension_id}/values
Add Value
add_value_v1_demographics__dimension_id__values_post 1 param body → 201422
POST
/v1/demographics/{dimension_id}/values/bulk
Bulk Add Values
bulk_add_values_v1_demographics__dimension_id__values_bulk_post 1 param body → 201422
PUT
/v1/demographics/values/{value_id}
Update Value
update_value_v1_demographics_values__value_id__put 1 param body → 200422
DELETE
/v1/demographics/values/{value_id}
Delete Value
delete_value_v1_demographics_values__value_id__delete 1 param → 204422
GET
/v1/dimensions/
List Dimensions
list_dimensions_v1_dimensions__get 3 params → 200422
POST
/v1/dimensions/
Create Dimension
create_dimension_v1_dimensions__post body → 201422
GET
/v1/dimensions/{dimension_id}
Get Dimension
get_dimension_v1_dimensions__dimension_id__get 1 param → 200422
PUT
/v1/dimensions/{dimension_id}
Update Dimension
update_dimension_v1_dimensions__dimension_id__put 1 param body → 200422
DELETE
/v1/dimensions/{dimension_id}
Delete Dimension
delete_dimension_v1_dimensions__dimension_id__delete 1 param → 204422
GET
/v1/dimensions/by-name/{name}
Get Dimension By Name
get_dimension_by_name_v1_dimensions_by_name__name__get 1 param → 200422
GET
/v1/dimensions/{dimension_id}/values
List Values
list_values_v1_dimensions__dimension_id__values_get 3 params → 200422
POST
/v1/dimensions/{dimension_id}/values
Add Value
add_value_v1_dimensions__dimension_id__values_post 1 param body → 201422
POST
/v1/dimensions/{dimension_id}/values/bulk
Bulk Add Values
bulk_add_values_v1_dimensions__dimension_id__values_bulk_post 1 param body → 201422
PUT
/v1/dimensions/values/{value_id}
Update Value
update_value_v1_dimensions_values__value_id__put 1 param body → 200422
DELETE
/v1/dimensions/values/{value_id}
Delete Value
delete_value_v1_dimensions_values__value_id__delete 1 param → 204422
GET
/v1/policies/{policy_id}
Get Policy
get_policy_v1_policies__policy_id__get 1 param → 200422
PATCH
/v1/policies/{policy_id}
Update Policy
update_policy_v1_policies__policy_id__patch 1 param body → 200422
DELETE
/v1/policies/{policy_id}
Delete Policy
delete_policy_v1_policies__policy_id__delete 1 param → 204422
GET
/v1/policies/
List Policies
list_policies_v1_policies__get 5 params → 200422
POST
/v1/policies/
Create Policy
create_policy_v1_policies__post body → 201422
GET
/v1/policies/presets/
List Presets
list_presets_v1_policies_presets__get 3 params → 200422
POST
/v1/policies/presets/{preset_id}/copy
Copy Preset
copy_preset_v1_policies_presets__preset_id__copy_post 2 params → 201422
POST
/v1/policies/{policy_id}/upload
Upload File
upload_file_v1_policies__policy_id__upload_post 1 param body → 200422
POST
/v1/policies/{policy_id}/activate
Activate Policy
activate_policy_v1_policies__policy_id__activate_post 1 param → 200422
GET
/v1/policies/{policy_id}/file
Download File
download_file_v1_policies__policy_id__file_get 1 param → 200422
DELETE
/v1/policies/{policy_id}/file
Delete File
delete_file_v1_policies__policy_id__file_delete 1 param → 200422
GET
/v1/policies/{policy_id}/converted
Download Converted File
download_converted_file_v1_policies__policy_id__converted_get 1 param → 200422
GET
/v1/policies/{policy_id}/rules
List Policy Rules
list_policy_rules_v1_policies__policy_id__rules_get 3 params → 200422
POST
/v1/policies/{policy_id}/rules
Create Policy Rule
create_policy_rule_v1_policies__policy_id__rules_post 1 param body → 201422
GET
/v1/rules/{rule_id}
Get Rule
get_rule_v1_rules__rule_id__get 1 param → 200422
PATCH
/v1/rules/{rule_id}
Update Rule
update_rule_v1_rules__rule_id__patch 1 param body → 200422
DELETE
/v1/rules/{rule_id}
Delete Rule
delete_rule_v1_rules__rule_id__delete 1 param → 204422
GET
/v1/rules/
List Rules
list_rules_v1_rules__get 5 params → 200422
POST
/v1/rules/{rule_id}/approve
Approve Rule
approve_rule_v1_rules__rule_id__approve_post 2 params → 200422
POST
/v1/rules/{rule_id}/reject
Reject Rule
reject_rule_v1_rules__rule_id__reject_post 2 params → 200422
GET
/v1/dashboard/trust
Get Trust Dashboard
get_trust_dashboard_v1_dashboard_trust_get → 200
POST
/v1/agents/{agent_id}/evolutions
Trigger Evolution
trigger_evolution_v1_agents__agent_id__evolutions_post 1 param body → 201422
GET
/v1/agents/{agent_id}/evolutions
List Evolution Jobs
list_evolution_jobs_v1_agents__agent_id__evolutions_get 4 params → 200422
GET
/v1/agents/{agent_id}/evolutions/{evolution_id}
Get Evolution Job Status
get_evolution_job_status_v1_agents__agent_id__evolutions__evolution_id__get 2 params → 200422
GET
/v1/agents/{agent_id}/evolution/proposals
List Proposals
list_proposals_v1_agents__agent_id__evolution_proposals_get 4 params → 200422
GET
/v1/agents/{agent_id}/evolution/proposals/{proposal_id}
Get Proposal
get_proposal_v1_agents__agent_id__evolution_proposals__proposal_id__get 2 params → 200422
GET
/v1/proposals/{proposal_id}
Get Proposal By Id
get_proposal_by_id_v1_proposals__proposal_id__get 1 param → 200422
POST
/v1/proposals/{proposal_id}/approve
Approve Proposal
approve_proposal_v1_proposals__proposal_id__approve_post 1 param body → 200422
POST
/v1/proposals/{proposal_id}/reject
Reject Proposal
reject_proposal_v1_proposals__proposal_id__reject_post 1 param body → 200422
GET
/v1/evolution/status/{agent_id}
Get Evolution Status
get_evolution_status_v1_evolution_status__agent_id__get 1 param → 200422
GET
/v1/evolution/genome-map
Get Genome Map
get_genome_map_v1_evolution_genome_map_get 1 param → 200422
POST
/v1/genomes/
Create Genome
create_genome_v1_genomes__post body → 201422
GET
/v1/genomes/
List Genomes
list_genomes_v1_genomes__get 3 params → 200422
GET
/v1/genomes/by-agent/{agent_id}
Get Genome By Agent
get_genome_by_agent_v1_genomes_by_agent__agent_id__get 2 params → 200422
GET
/v1/genomes/by-agent/{agent_id}/mutation-history
Get Mutation History
get_mutation_history_v1_genomes_by_agent__agent_id__mutation_history_get 2 params → 200422
GET
/v1/genomes/{genome_id}
Get Genome
get_genome_v1_genomes__genome_id__get 2 params → 200422
DELETE
/v1/genomes/{genome_id}
Delete Genome
delete_genome_v1_genomes__genome_id__delete 1 param → 204422
GET
/v1/genomes/{genome_id}/versions
List Genome Versions
list_genome_versions_v1_genomes__genome_id__versions_get 3 params → 200422
GET
/v1/genomes/{genome_id}/versions/{version}
Get Genome Version
get_genome_version_v1_genomes__genome_id__versions__version__get 2 params → 200422
GET
/v1/genomes/{genome_id}/ancestry
Get Genome Ancestry
get_genome_ancestry_v1_genomes__genome_id__ancestry_get 2 params → 200422
GET
/v1/genomes/{genome_id}/diff
Diff Genome Versions
diff_genome_versions_v1_genomes__genome_id__diff_get 3 params → 200422
GET
/v1/genomes/{genome_id}/similar
Find Similar Genomes
find_similar_genomes_v1_genomes__genome_id__similar_get 3 params → 200422
POST
/v1/genomes/extract-from-agent/{agent_id}
Extract Genome From Agent
extract_genome_from_agent_v1_genomes_extract_from_agent__agent_id__post 1 param → 201422
GET
/v1/genomes/{genome_id}/to-agent-update
Genome To Agent Update
genome_to_agent_update_v1_genomes__genome_id__to_agent_update_get 2 params → 200422

Schemas 88

The contract defines 88 schemas that model the data the API accepts and returns. The most detailed are Agent (35 properties), AgentUpdate (23 properties), PolicyRule (20 properties), Proposal (18 properties). Each schema is shown below with its type and property counts.

PrivilegeLevel
string
Privilege level for persona access control testing.
AccessLevel
string
Access level for agent analysis. Black Box: URL only - behavioral testing only Grey Box: Agent configuration - structure/capabilities analysis White Box: Sourc…
TrustLifecycleStage
string
Trust maturity lifecycle stage for an agent.
RuleConstraint
object
Constraint for conditional rule application.
4 properties 4 required
UnifiedImportResponse
object
Response model for unified import.
5 properties 2 required
AgentLatestEvaluation
object
Latest completed evaluation scores for an agent. Sideloaded on GET /agent-configurations when includescores=true. Contains only domain-level score data — no UI…
6 properties 1 required
RejectProposalRequest
object
1 property
EvolutionJob
object
Console-side view of a Darwin evolution job.
5 properties 2 required
SourceCodeUpload
object
Model for direct source code upload. Supports single file or multi-file upload for white box agent import.
8 properties 1 required
FleetHealthMetrics
object
Fleet Health hero metric.
2 properties
src__service_agent_environment__api__rules__RuleListResponse
object
Response model for list endpoints with pagination.
2 properties 2 required
OrganizationConstraints
object
Organization-level policy constraints applied to all agents in the org.
4 properties 3 required
SourceLocation
object
Location in source document where rule was extracted from.
5 properties
PolicyRule
object
Domain model for Policy Rule. This follows an ODRL-inspired schema: - ruletype: permission/prohibition/obligation/recommendation - action: what action this rul…
20 properties 9 required
ProtocolType
string
Communication protocol for agent endpoints.
CreateFromPresetRequest
object
Request model for creating from preset.
1 property
AgentTrustCard
object
A single agent card on the Kanban board.
14 properties 3 required
ProposedMutation
object
A single proposed gene mutation.
5 properties 5 required
DelegatedAgent
object
Reference to a delegated agent.
4 properties 1 required
UnifiedImportRequest
object
Unified request model for agent import. Supports five input methods (exactly one required), each with deterministic access level: | Input Method | Mode | Acces…
11 properties
HTTPValidationError
object
1 property
DemographicDimensionUpdate
object
Request model for updating a demographic dimension.
3 properties
TimeToTrustMetrics
object
Time-to-Trust hero metric.
3 properties
MCPConfig
object
MCP (Model Context Protocol) proxy configuration.
3 properties
PolicyRuleUpdate
object
Request model for updating a policy rule. All fields are optional.
13 properties
DataAccessScope
string
Data access scope for persona testing.
PillarBreakdown
object
Nested trust scores for one pillar with detector-level detail.
2 properties
ToolPermission
object
Permission entry for a single tool an agent is allowed to call.
4 properties 3 required
RuleConsequence
object
Consequence when rule is triggered.
3 properties
ImportMetadata
object
Metadata about how an agent was imported.
4 properties
RuleStatus
string
Review status of a policy rule.
AgentStatus
string
Agent status values.
ApproveProposalRequest
object
1 property
Body_upload_file_v1_policies__policy_id__upload_post
object
1 property 1 required
ImportSource
string
Import source for agent configuration.
AgentConstraints
object
Full constraint set for a single agent — what the SDK fetches at boot.
6 properties 6 required
WhiteBoxConfig-Input
object
Source code access configuration for white box analysis.
6 properties
src__service_agent_environment__api__dimensions__DimensionListResponse
object
Response model for listing dimensions.
2 properties 2 required
PolicyStatus
string
Status of a policy document.
AgentLifecycleUpdate
object
Request model for updating an agent's trust lifecycle stage.
1 property 1 required
UnifiedValidationResponse
object
Response model for unified validation. Returns validation status and parsed agent card for preview.
7 properties 1 required
TriggerEvolutionRequest
object
Optional config overrides for evolution trigger.
9 properties
DemographicValueCreate
object
Request model for creating a demographic value.
4 properties 1 required
ValidationError
object
3 properties 3 required
WhiteBoxConfig-Output
object
Source code access configuration for white box analysis.
5 properties
AgentEvaluationConfig
object
Configuration for Diamond evaluation (resolved from agent). URL requirements depend on access level: - Black Box: agenturl is ALWAYS required (it's where the o…
7 properties 2 required
EvolutionJobList
object
Paginated list of evolution jobs (Console API uses results; Darwin uses items).
4 properties 4 required
DemographicValue
object
A value within a demographic dimension. Example: For dimension "race", values might be "White", "Black", "Asian", etc. These are used for prompt template varia…
7 properties 4 required
Severity
string
Severity level for rule consequences.
DemographicDimension
object
A demographic dimension category for bias testing. NOTE: Demographics are NOT persona attributes. They are dimension tables used to substitute variables in pro…
7 properties 4 required
src__service_agent_environment__api__dimensions__ValueListResponse
object
Response model for listing values.
2 properties 2 required
TrustStage
string
Trust maturity stages for the Kanban board. Agents flow left-to-right as they mature: Registered - Tested - Hardened - Trusted - Optimized - Adapted
PolicyUpdate
object
Request model for updating a policy. All fields are optional.
6 properties
ProtectionStatus
string
Dome protection lifecycle state.
AgentMetadata
object
Agent metadata for display and organization.
5 properties
AgentConfigRequest
object
Request model for creating agent configurations (POST /agent-configurations). Used only by the create endpoint. The update endpoint (PUT /{id}) accepts AgentUp…
14 properties
Agent
object
Agent domain model.
35 properties 7 required
DemographicDimensionCreate
object
Request model for creating a demographic dimension.
4 properties 2 required
Proposal
object
Console-side view of a Darwin mutation proposal. Captures the fields Console needs for display and review workflow. Additional Darwin-specific fields are prese…
18 properties 7 required
PolicyListResponse
object
Response model for list endpoints with pagination. - results: Items in the current page (length may be less than limit on last page). - total: Total number of…
2 properties 2 required
AdaptivityMetrics
object
Adaptivity hero metric.
4 properties
PersonaCreate
object
Request model for creating a persona.
15 properties 3 required
PersonaAccessPermissions
object
Access permissions for persona - used for test scenario definition. NOTE: This is NOT for actual RBAC enforcement - it defines expected access for generating t…
5 properties
ProposalList
object
Paginated list of proposals from Darwin.
4 properties 4 required
src__service_agent_environment__api__policies__RuleListResponse
object
Response model for rules list with pagination. - results: Items in the current page. - total: Total number of rules (across all pages if paginated).
2 properties 2 required
Intent
string
Intent type of the persona.
AgentConfigListResponse
object
List response model.
2 properties 2 required
KnowledgeLevel
string
Knowledge level of the persona.
PolicyCreate
object
Request model for creating a policy.
6 properties 2 required
SkillLevel
string
Skill level of the persona.
DomeGuardConfig
object
Dome guardrail configuration shape consumed by the SDK at boot.
3 properties 3 required
AgentDomeConfigResponse
object
Dome config in use for an agent (same wire shape as GET /dome-configs/{configid}).
9 properties 3 required
AgentParams
object
Model parameters for agent configuration.
6 properties
PolicyCategory
string
Category of policy document.
AgentSkill
object
An agent skill definition (for A2A protocol agents).
5 properties 2 required
AgentCapabilities
object
Agent capability flags.
6 properties
Policy
object
Domain model for Policy document.
18 properties 7 required
src__service_agent_environment__api__dimensions__BulkValuesRequest
object
Request model for bulk adding values.
1 property 1 required
PersonaListResponse
object
Response model for listing personas with pagination. - results: Items in the current page (length may be less than limit on last page). - total: Total number o…
2 properties 2 required
MCPAccessLevel
string
MCP (Model Context Protocol) access level values.
DemographicValueUpdate
object
Request model for updating a demographic value.
4 properties
DashboardResponse
object
Full dashboard API response.
4 properties
AgentUpdate
object
Model for updating an agent (all fields optional).
23 properties
PolicyRuleCreate
object
Request model for creating a policy rule manually.
14 properties 4 required
PersonaUpdate
object
Request model for updating a persona. All fields are optional.
13 properties
RuleType
string
Type of policy rule (ODRL-inspired).
RuleProvenance
object
Provenance information for rule extraction.
4 properties
Persona
object
Domain model for Persona archetype.
18 properties 7 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vijil-agent-environment-api-openapi.yml Raw ↑

Other APIs Vijil publishes across the network.

Vijil agent-configurations API
Vijil agent-import API
Vijil auth API
Vijil custom-harnesses API
Vijil dashboard API
Vijil demographics API
Vijil detections API
Vijil Diamond API
Vijil Dome API
Vijil dome-configs API
Vijil evaluation-results API
Vijil evaluation-summaries API
Where this information came from

This is an independent, third-party profile of Vijil Agent Environment API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.