# Policy Versions API

Provides access to the policies that are part of a Hyperproof organization.

Version: 1.0

## Servers

Hyperproof US
```
https://api.hyperproof.app/v1/policyversions
```

Hyperproof Gov
```
https://api.hyperproofgov.app/v1/policyversions
```

Hyperproof EU
```
https://api.hyperproof.eu/v1/policyversions
```

## Security

### oauth2

Type: oauth2

## Download OpenAPI description

[Policy Versions API](https://developer.hyperproof.app/_bundle/hyperproof-api/policyversions/policyversions.openapi.yaml)

## Other

### Get Policy Versions

 - [GET /](https://developer.hyperproof.app/hyperproof-api/policyversions/policyversions.openapi/other/get-policy-versions.md): GET /{policyId}

#### Description

Retrieves details of all policy versions linked to a specific policy, including version metadata, content, and associated documents or proof.

### Add Policy Version

 - [POST /](https://developer.hyperproof.app/hyperproof-api/policyversions/policyversions.openapi/other/add-policy-version.md): POST /{policyId}

#### Description

Creates a new version of an existing policy identified by its ID, capturing updated content, metadata, or compliance references.

### Get Policy Version

 - [GET /{versionId}](https://developer.hyperproof.app/hyperproof-api/policyversions/policyversions.openapi/other/get-policy-version.md): GET /{versionId}

#### Description

Retrieves details of a specific policy version by its unique ID, including version metadata, content, and associated documents or proof.

### Update a single policy version

 - [PATCH /{versionId}](https://developer.hyperproof.app/hyperproof-api/policyversions/policyversions.openapi/other/update-policy-version.md): PATCH /{versionId}?policyId={policyId}

#### Description

Updates an existing policy version, allowing modifications to its content, metadata, or associated references.

### Add Policy Version Proof

 - [POST /{versionId}/proof](https://developer.hyperproof.app/hyperproof-api/policyversions/policyversions.openapi/other/add-policy-version-proof.md): POST /{versionId}/proof?policyId={policyId}

#### Description

Adds a proof item to a specific policy version, linking evidence or supporting documentation to demonstrate compliance.

### Add a Policy Version Document

 - [POST /{versionId}/documents](https://developer.hyperproof.app/hyperproof-api/policyversions/policyversions.openapi/other/add-policy-version-document.md): POST /{versionId}/documents?policyId={policyId}

#### Description

Adds a source document to a specific policy version, linking supporting evidence or reference materials to that version.