> For the complete documentation index, see [llms.txt](https://docs.enclaive.cloud/nitride/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enclaive.cloud/nitride/api/logs.md).

# Logs

## List all logs

> Retrieves a list of all system logs

```json
{"openapi":"3.0.2","info":{"title":"Enclaive auth-ratls API","version":"0.0.0-0"},"servers":[{"url":"http://localhost:8200","description":"Local development server"}],"paths":{"/v1/auth/ratls/logs/":{"get":{"tags":["Logs"],"summary":"List all logs","description":"Retrieves a list of all system logs","operationId":"listLogs","parameters":[{"name":"list","description":"Must be set to 'true' to retrieve the list","in":"query","schema":{"type":"string","enum":["true"]},"required":true}],"responses":{"200":{"description":"Log list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsList_logsResponse"}}}}}}}},"components":{"schemas":{"LogsList_logsResponse":{"type":"object","properties":{"request_id":{"type":"string"},"lease_id":{"type":"string"},"renewable":{"type":"boolean"},"lease_duration":{"type":"integer"},"data":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string","description":"Workload UUID with trailing slash"}}}},"wrap_info":{"type":"null"},"warnings":{"type":"null"},"auth":{"type":"null"}}}}}}
```

## List logs by workload

> Retrieves logs for a specific workload

```json
{"openapi":"3.0.2","info":{"title":"Enclaive auth-ratls API","version":"0.0.0-0"},"servers":[{"url":"http://localhost:8200","description":"Local development server"}],"paths":{"/v1/auth/ratls/logs/{workload}/":{"get":{"tags":["Logs"],"summary":"List logs by workload","description":"Retrieves logs for a specific workload","operationId":"listWorkloadLogs","parameters":[{"name":"list","description":"Must be set to 'true' to retrieve the list","in":"query","schema":{"type":"string","enum":["true"]},"required":true}],"responses":{"200":{"description":"Workload logs retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsList_logsWorkloadResponse"}}}},"400":{"description":"Workload not found"}}}}},"components":{"schemas":{"LogsList_logsWorkloadResponse":{"type":"object","properties":{"request_id":{"type":"string"},"lease_id":{"type":"string"},"renewable":{"type":"boolean"},"lease_duration":{"type":"integer"},"data":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string","description":"RFC3339Nano timestamp and nonce combination"}}}},"wrap_info":{"type":"null"},"warnings":{"type":"null"},"auth":{"type":"null"}}}}}}
```

## Get log entry details

> Retrieves detailed information about a specific log entry

```json
{"openapi":"3.0.2","info":{"title":"Enclaive auth-ratls API","version":"0.0.0-0"},"servers":[{"url":"http://localhost:8200","description":"Local development server"}],"paths":{"/v1/auth/ratls/logs/{workload}/{time}_{nonce}":{"get":{"tags":["Logs"],"summary":"Get log entry details","description":"Retrieves detailed information about a specific log entry","operationId":"getLogEntry","responses":{"200":{"description":"Log entry retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsRead_logsWorkloadTimeNonceResponse"}}}},"400":{"description":"Log entry not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsError_Response"}}}}}}}},"components":{"schemas":{"LogsRead_logsWorkloadTimeNonceResponse":{"type":"object","properties":{"auth":{"type":"object"},"data":{"type":"object","properties":{"nonce":{"type":"string","description":"Noce for the attestation"},"request":{"type":"object","description":"Full request dump (logical.Request)","format":"map","default":{"connection":{}}},"response":{"type":"object","description":"Reduced response dump (logical.Response - Data, Redirect, Warnings, Headers)","format":"map","default":{}},"time":{"type":"string","description":"Time the log was created, as RFC3339Nano"},"workload":{"type":"string","description":"UUID of the workload"}}}}},"LogsError_Response":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}}}}}}
```

## Delete log entry

> Removes a specific log entry

```json
{"openapi":"3.0.2","info":{"title":"Enclaive auth-ratls API","version":"0.0.0-0"},"servers":[{"url":"http://localhost:8200","description":"Local development server"}],"paths":{"/v1/auth/ratls/logs/{workload}/{time}_{nonce}":{"delete":{"tags":["Logs"],"summary":"Delete log entry","description":"Removes a specific log entry","operationId":"deleteLogEntry","responses":{"200":{"description":"Log entry deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsDelete_Response"}}}},"400":{"description":"Log entry not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsDelete_Response"}}}}}}}},"components":{"schemas":{"LogsDelete_Response":{"type":"object","properties":{"request_id":{"type":"string"},"lease_id":{"type":"string"},"renewable":{"type":"boolean"},"lease_duration":{"type":"integer"},"data":{"type":"object"},"wrap_info":{"type":"null"},"warnings":{"type":"null"},"auth":{"type":"null"}}}}}}
```