# Verified Digital Agents (VDA) Environments API

**Canonical:** https://apis.io/apis/getvda-ai/getvda-ai-environments-api/  
**Provider:** Verified Digital Agents (VDA) — https://apis.io/providers/getvda-ai/  
**Base URL:** https://witness.getvda.ai  
**Documentation:** https://witness.getvda.ai/docs

Verified Digital Agents (VDA) Environments API is one of 27 APIs that [Verified Digital Agents (VDA)](https://apis.io/providers/getvda-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Environment. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Environments API from Verified Digital Agents (VDA) — 6 operation(s) for environments.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/environments/{env}/governance` | Load a governance set at a ref |
| POST | `/v1/environments/{env}/changes/prepare` | Prepare + evaluate a governance change (diff + Compliance Guard) |
| POST | `/v1/environments/{env}/changes/test` | Run the governance CI test suite on a change |
| GET | `/v1/environments/{env}/pulls/{num}/surface` | Non-engineer approval surface |
| POST | `/v1/environments/{env}/pulls/{num}/decision` | Approve or reject a change (seals hitl_decision, merges on approve) |
| POST | `/v1/environments/{env}/versions/activate` | Build + sign + activate a governance version (sealed to Witness) |

## Machine-readable artifacts (25)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/openapi/getvda-ai-environments-api-openapi.yml
- **Documentation** — https://witness.getvda.ai/docs
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-witness-llms.txt
- **LLMsTxt** — https://witness.getvda.ai/llms.txt
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/mcp/getvda-ai-tool-crosswalk.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/data-model/getvda-ai-data-model.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/sandbox/getvda-ai-sandbox.yml
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-witness-did.json
- **X-ProofOfIntegrity** — https://witness.getvda.ai/proof
- **Documentation** — https://getvda.ai/blocks/hitl.html
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-hitl-did.json
- **Documentation** — https://getvda.ai/blocks/acp.html
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-acp-did.json
- **Documentation** — https://getvda.ai/c2md/generate-compliance-bundle.html
- **APIReference** — https://c2md.getvda.ai/docs
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-c2md-llms.txt
- **LLMsTxt** — https://c2md.getvda.ai/llms.txt
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/scopes/getvda-ai-scopes.yml
- **Documentation** — https://agents.getvda.ai/agents
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-gosce-llms.txt
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-gosce-router-llms.txt
- **X-AgentCatalog** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-ai-catalog.json
- **X-JWKS** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-jwks.json
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-did.json
- **SourceCode** — https://github.com/mikerawsonnz/gosce-agents

## Other Verified Digital Agents (VDA) APIs (12)

- [VDA Onboarding Agent](https://apis.io/apis/getvda-ai/vda-onboarding-agent/)
- [Verified Digital Agents (VDA) Agents API](https://apis.io/apis/getvda-ai/getvda-ai-agents-api/)
- [Verified Digital Agents (VDA) Bundles API](https://apis.io/apis/getvda-ai/getvda-ai-bundles-api/)
- [Verified Digital Agents (VDA) C2MD Edge API](https://apis.io/apis/getvda-ai/getvda-ai-c2md-edge-api/)
- [Verified Digital Agents (VDA) Copilot Studio.yaml API](https://apis.io/apis/getvda-ai/getvda-ai-copilot-studio-yaml-api/)
- [Verified Digital Agents (VDA) Genesis API](https://apis.io/apis/getvda-ai/getvda-ai-genesis-api/)
- [Verified Digital Agents (VDA) GOSCE Portfolio API](https://apis.io/apis/getvda-ai/getvda-ai-gosce-portfolio-api/)
- [Verified Digital Agents (VDA) Governance.md API](https://apis.io/apis/getvda-ai/getvda-ai-governance-md-api/)
- [Verified Digital Agents (VDA) Health API](https://apis.io/apis/getvda-ai/getvda-ai-health-api/)
- [Verified Digital Agents (VDA) Healthz API](https://apis.io/apis/getvda-ai/getvda-ai-healthz-api/)
- [Verified Digital Agents (VDA) Livez API](https://apis.io/apis/getvda-ai/getvda-ai-livez-api/)
- [Verified Digital Agents (VDA) Llms.txt API](https://apis.io/apis/getvda-ai/getvda-ai-llms-txt-api/)

## Tags

Environment

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/getvda-ai/getvda-ai-environments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/getvda-ai/.