> 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"}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.indicio.tech/developer/indicio-proven-r/api-reference/settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.