# C1 documentation: API Endpoints Secrets

## Secrets

- [Search Audit Events](https://www.c1.ai/docs/api-reference/secrets/search-audit-events.md): SearchAuditEvents returns audit events for a secret owned by the calling user.  Returns sanitized OCSF events (IP addresses stripped for non-admin consumption).
- [Search My Secrets](https://www.c1.ai/docs/api-reference/secrets/search-my-secrets.md): SearchMySecrets returns secrets created by the current user.  Automatically scoped to current user - no user_id filter parameter.
- [Search Secrets Shared With Me](https://www.c1.ai/docs/api-reference/secrets/search-secrets-shared-with-me.md): SearchSecretsSharedWithMe returns secrets shared with the current user.  Automatically scoped to current user - no user_id filter parameter.  INTERNAL secrets only: EXTERNAL secrets are addressed by email and are never  viewable through an authenticated C1 session, so returning them here would  surf…
- [Get](https://www.c1.ai/docs/api-reference/secrets/get.md): Get retrieves a secret's metadata by vault ID.  Creator can always get their own secrets. Admins can get any secret.
- [Delete](https://www.c1.ai/docs/api-reference/secrets/delete.md): Delete soft-deletes a Paper Vault and deletes its content. It never  revokes the credential that may have been stored in the vault.
- [Set Text Content](https://www.c1.ai/docs/api-reference/secrets/set-text-content.md): SetTextContent sets the encrypted content for a text secret.  Client encrypts content using age_recipient from CreateResponse.
- [Get Content](https://www.c1.ai/docs/api-reference/secrets/get-content.md): GetContent retrieves the encrypted secret content for an authorized recipient.  Caller must be in the secret's allowed_user_ids list (for INTERNAL secrets).  Returns content re-encrypted to caller's ephemeral public key.
- [Get By Share Code](https://www.c1.ai/docs/api-reference/secrets/get-by-share-code.md): GetByShareCode retrieves a secret by its human-friendly share code.  Share codes are in XXXX-XXXX-XXXX format and are used in share URLs.
- [Create External](https://www.c1.ai/docs/api-reference/secrets/create-external.md): CreateExternal creates a secret using the requested Age suite.
- [Create Internal](https://www.c1.ai/docs/api-reference/secrets/create-internal.md): CreateInternal creates a secret using the requested Age suite.

## OpenAPI Specs

- [my-source-with-code-samples](https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples)
