> 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/identities.md).

# Identities

## Create identity

> Creates a new identity record

```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/identities":{"put":{"tags":["Identities"],"summary":"Create identity","description":"Creates a new identity record","operationId":"createIdentity","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitiesCreate_identitiesRequest"}}}},"responses":{"200":{"description":"Identity created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitiesCreate_identitiesResponse"}}}},"400":{"description":"Invalid request body"}}}}},"components":{"schemas":{"IdentitiesCreate_identitiesRequest":{"type":"object","properties":{"created":{"type":"integer","description":"Creation timestamp, set by the plugin","format":"int64"},"name":{"type":"string","description":"Name of the identity"},"type":{"type":"string","description":"Type of the identity, available: platform, firmware, workload, metadata"},"values":{"type":"object","description":"Values for the identity","format":"map","default":{}}},"required":["created","name","type","values"]},"IdentitiesCreate_identitiesResponse":{"type":"object","properties":{"auth":{"type":"object"},"data":{"type":"object","properties":{"created":{"type":"integer","description":"Creation timestamp, set by the plugin","format":"int64"},"name":{"type":"string","description":"Name of the identity"},"type":{"type":"string","description":"Type of the identity, available: platform, firmware, workload, metadata"},"values":{"type":"object","description":"Values for the identity","format":"map","default":{}}}}}}}}}
```

## List all identities

> Retrieves a list of all identity records

```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/identities/":{"get":{"tags":["Identities"],"summary":"List all identities","description":"Retrieves a list of all identity records","operationId":"listIdentities","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":"Identity list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitiesList_identitiesResponse"}}}}}}}},"components":{"schemas":{"IdentitiesList_identitiesResponse":{"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":"Identity types with trailing slash (e.g., 'platform/', 'firmware/', 'workload/')"}}}},"wrap_info":{"type":"null"},"warnings":{"type":"null"},"auth":{"type":"null"}}}}}}
```

## List identities by type

> Retrieves a list of identities filtered by type

```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/identities/{type}/":{"get":{"tags":["Identities"],"summary":"List identities by type","description":"Retrieves a list of identities filtered by type","operationId":"listIdentitiesByType","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":"Identity list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitiesList_identitiesTypeResponse"}}}}}}}},"components":{"schemas":{"IdentitiesList_identitiesTypeResponse":{"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":"Identity names with trailing slash"}}}},"wrap_info":{"type":"null"},"warnings":{"type":"null"},"auth":{"type":"null"}}}}}}
```

## List identities by type and name

> Retrieves a list of identities filtered by type and name

```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/identities/{type}/{name}/":{"get":{"tags":["Identities"],"summary":"List identities by type and name","description":"Retrieves a list of identities filtered by type and name","operationId":"listIdentitiesByTypeAndName","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":"Identity list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitiesList_identitiesTypeNameResponse"}}}}}}}},"components":{"schemas":{"IdentitiesList_identitiesTypeNameResponse":{"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":"Creation timestamps"}}}},"wrap_info":{"type":"null"},"warnings":{"type":"null"},"auth":{"type":"null"}}}}}}
```

## Get identity details

> Retrieves detailed information about a specific identity

```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/identities/{type}/{name}/{created}":{"get":{"tags":["Identities"],"summary":"Get identity details","description":"Retrieves detailed information about a specific identity","operationId":"getIdentity","responses":{"200":{"description":"Identity details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitiesRead_identitiesTypeNameCreatedResponse"}}}},"400":{"description":"Identity not found"}}}}},"components":{"schemas":{"IdentitiesRead_identitiesTypeNameCreatedResponse":{"type":"object","properties":{"auth":{"type":"object"},"data":{"type":"object","properties":{"created":{"type":"integer","description":"Creation timestamp, set by the plugin","format":"int64"},"name":{"type":"string","description":"Name of the identity"},"type":{"type":"string","description":"Type of the identity, available: platform, firmware, workload, metadata"},"values":{"type":"object","description":"Values for the identity","format":"map","default":{}}}}}}}}}
```

## Delete identity

> Removes a specific identity record

```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/identities/{type}/{name}/{created}":{"delete":{"tags":["Identities"],"summary":"Delete identity","description":"Removes a specific identity record","operationId":"deleteIdentity","responses":{"200":{"description":"Identity deleted successfully"},"400":{"description":"Identity not found"}}}}}}
```


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.enclaive.cloud/nitride/api/identities.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.