> For the complete documentation index, see [llms.txt](https://docs.indicio.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.indicio.tech/developer/indicio-proven-r/api-reference/settings.md).

# Settings

Endpoints for managing settings

## Get all webhook target URLs

> This endpoint retrieves all webhook target URLs.

```json
{"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Settings","description":"Endpoints for managing settings"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/settings/webhook-target-urls":{"get":{"summary":"Get all webhook target URLs","description":"This endpoint retrieves all webhook target URLs.","tags":["Settings"],"responses":{"200":{"description":"A list of webhook target URLs","content":{"application/json":{"schema":{"type":"object","properties":{"webhookTargetUrls":{"type":"array","items":{"type":"object"}}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Set webhook target URLs

> This endpoint allows you to set webhook target URLs.

```json
{"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Settings","description":"Endpoints for managing settings"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/settings/webhook-target-urls":{"put":{"summary":"Set webhook target URLs","description":"This endpoint allows you to set webhook target URLs.","tags":["Settings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"string","format":"uri"}}}}}}},"responses":{"200":{"description":"Webhook target URLs set successfully","content":{"application/json":{"schema":{"type":"object","properties":{"webhookTargetUrls":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Bad request. Invalid parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Get PII settings

> Retrieve the current PII settings for the wallet.

```json
{"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Settings","description":"Endpoints for managing settings"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/settings/pii":{"get":{"summary":"Get PII settings","description":"Retrieve the current PII settings for the wallet.","tags":["Settings"],"responses":{"200":{"description":"PII settings retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"piiRetentionSeconds":{"type":"integer"},"piiRemoveOnApiAccess":{"type":"boolean"}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Set PII settings

> Configure PII (Personally Identifiable Information) settings including retention period and removal on API access.

```json
{"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Settings","description":"Endpoints for managing settings"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/settings/pii":{"post":{"summary":"Set PII settings","description":"Configure PII (Personally Identifiable Information) settings including retention period and removal on API access.","tags":["Settings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["piiRetentionSeconds","piiRemoveOnApiAccess"],"properties":{"piiRetentionSeconds":{"type":"integer","minimum":0,"description":"Number of seconds to retain PII data after a workflow completes. Use 0 to disable automatic removal."},"piiRemoveOnApiAccess":{"type":"boolean","description":"Whether to remove PII data after it has been accessed via API"}}}}}},"responses":{"200":{"description":"PII settings updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"piiRetentionSeconds":{"type":"integer"},"piiRemoveOnApiAccess":{"type":"boolean"}}}}}},"400":{"description":"Bad request. Invalid parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Remove all stored PII

> Manually trigger the removal of all stored PII data for this wallet.

```json
{"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Settings","description":"Endpoints for managing settings"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/settings/pii/remove-all":{"post":{"summary":"Remove all stored PII","description":"Manually trigger the removal of all stored PII data for this wallet.","tags":["Settings"],"responses":{"200":{"description":"PII removal completed","content":{"application/json":{"schema":{"type":"object","properties":{"credentialsTotal":{"type":"integer","description":"Total number of final state credentials checked"},"credentialsCleared":{"type":"integer","description":"Number of credentials cleared"},"credentialFailures":{"type":"integer","description":"Number of credentials failed to clear"},"presentationsTotal":{"type":"integer","description":"Total number of final state presentations checked"},"presentationsCleared":{"type":"integer","description":"Number of presentations cleared"},"presentationFailures":{"type":"integer","description":"Number of presentations failed to clear"}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```