> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-eu-instance.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Secrets Shared With Me

> 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
 surface rows that GetContent then denies.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/search/secrets/shared_with_me
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/search/secrets/shared_with_me:
    post:
      tags:
        - Secrets
      summary: Search Secrets Shared With Me
      description: |-
        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
         surface rows that GetContent then denies.
      operationId: c1.api.secrets.v1.PaperSecretService.SearchSecretsSharedWithMe
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.secrets.v1.PaperSecretServiceSearchSecretsSharedWithMeRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.secrets.v1.PaperSecretServiceSearchResponse
          description: Search response for user's own secrets
      x-codeSamples:
        - lang: go
          label: SearchSecretsSharedWithMe
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.PaperSecret.SearchSecretsSharedWithMe(ctx, nil)\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.PaperSecretServiceSearchResponse != nil {\n        // handle response\n    }\n}"
components:
  schemas:
    c1.api.secrets.v1.PaperSecretServiceSearchSecretsSharedWithMeRequest:
      description: |-
        SearchSecretsSharedWithMe request - for end users viewing secrets others
         shared with them. Automatically scoped to current user.
      properties:
        includeOwn:
          description: >-
            Include secrets the caller created and also shared with themselves.
            Off by
             default so this list stays disjoint from SearchMySecrets.
          type: boolean
        pageSize:
          description: The pageSize field.
          format: int32
          type: integer
        pageToken:
          description: The pageToken field.
          type: string
        query:
          description: Fuzzy search by display name
          type: string
        secretType:
          description: Filter by secret type. Unspecified returns all secret types.
          enum:
            - SECRET_TYPE_UNSPECIFIED
            - SECRET_TYPE_TEXT
            - SECRET_TYPE_FILE
          type: string
          x-speakeasy-unknown-values: allow
        sharingMode:
          description: >-
            Filter by sharing mode. Unspecified returns internal secrets;
            external returns none.
          enum:
            - PAPER_VAULT_SHARING_MODE_UNSPECIFIED
            - PAPER_VAULT_SHARING_MODE_INTERNAL
            - PAPER_VAULT_SHARING_MODE_EXTERNAL
          type: string
          x-speakeasy-unknown-values: allow
        statuses:
          description: Filter by status. Empty returns all statuses.
          items:
            enum:
              - SECRET_STATUS_UNSPECIFIED
              - SECRET_STATUS_ACTIVE
              - SECRET_STATUS_EXPIRED
              - SECRET_STATUS_BURNED
              - SECRET_STATUS_REVOKED
              - SECRET_STATUS_DATA_DELETED
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
      title: Paper Secret Service Search Secrets Shared With Me Request
      type: object
      x-speakeasy-name-override: PaperSecretServiceSearchSecretsSharedWithMeRequest
    c1.api.secrets.v1.PaperSecretServiceSearchResponse:
      description: Search response for user's own secrets
      properties:
        list:
          description: The list field.
          items:
            $ref: '#/components/schemas/c1.api.secrets.v1.PaperSecret'
          type:
            - array
            - 'null'
        nextPageToken:
          description: The nextPageToken field.
          type: string
      title: Paper Secret Service Search Response
      type: object
      x-speakeasy-name-override: PaperSecretServiceSearchResponse
    c1.api.secrets.v1.PaperSecret:
      description: >-
        PaperSecret is the API view of a secret (combines Vault + PaperVault
        fields).
         The vault_id is the primary identifier (Vault.id).
      properties:
        ageSuite:
          description: Exact Age suite used by the stored ciphertext.
          enum:
            - AGE_SUITE_UNSPECIFIED
            - AGE_SUITE_X25519
            - AGE_SUITE_MLKEM768X25519
          type: string
          x-speakeasy-unknown-values: allow
        allowedEmails:
          description: The allowedEmails field.
          items:
            type: string
          type:
            - array
            - 'null'
        allowedUserIds:
          description: Access control
          items:
            type: string
          type:
            - array
            - 'null'
        contentDeleted:
          description: The contentDeleted field.
          type: boolean
        contentExpiresAt:
          format: date-time
          type:
            - string
            - 'null'
        contentReady:
          description: Whether content has been set (text uploaded or file uploaded)
          type: boolean
        contentType:
          description: The contentType field.
          type: string
        createdAt:
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        creatorUserId:
          description: Creator
          type: string
        currentViews:
          description: The currentViews field.
          format: uint32
          type: integer
        deletedAt:
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        displayName:
          description: From Vault
          type: string
        fileSize:
          description: File metadata
          format: int64
          type: string
        filename:
          description: 'For FILE secrets: original filename (sanitized)'
          type: string
        inputFormat:
          description: The inputFormat field.
          enum:
            - SECRET_INPUT_FORMAT_UNSPECIFIED
            - SECRET_INPUT_FORMAT_PLAINTEXT
            - SECRET_INPUT_FORMAT_JSON
            - SECRET_INPUT_FORMAT_YAML
            - SECRET_INPUT_FORMAT_KEY_VALUE
          type: string
          x-speakeasy-unknown-values: allow
        maxViews:
          description: View tracking
          format: uint32
          type: integer
        secretType:
          description: The secretType field.
          enum:
            - SECRET_TYPE_UNSPECIFIED
            - SECRET_TYPE_TEXT
            - SECRET_TYPE_FILE
          type: string
          x-speakeasy-unknown-values: allow
        shareCode:
          description: Human-friendly share code (XXXX-XXXX-XXXX) for shareable URLs
          type: string
        shareUrl:
          description: URL to share with recipients (populated when content_ready is true)
          type: string
        sharingMode:
          description: From PaperVault
          enum:
            - PAPER_VAULT_SHARING_MODE_UNSPECIFIED
            - PAPER_VAULT_SHARING_MODE_INTERNAL
            - PAPER_VAULT_SHARING_MODE_EXTERNAL
          type: string
          x-speakeasy-unknown-values: allow
        status:
          description: Computed status
          enum:
            - SECRET_STATUS_UNSPECIFIED
            - SECRET_STATUS_ACTIVE
            - SECRET_STATUS_EXPIRED
            - SECRET_STATUS_BURNED
            - SECRET_STATUS_REVOKED
            - SECRET_STATUS_DATA_DELETED
          type: string
          x-speakeasy-unknown-values: allow
        updatedAt:
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        vaultId:
          description: Vault.id - primary identifier for the secret
          type: string
      title: Paper Secret
      type: object
      x-speakeasy-name-override: PaperSecret
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````