> ## Documentation Index > Fetch the complete documentation index at: https://docs.dataraven.io/llms.txt > Use this file to discover all available pages before exploring further. # List Secrets > Get all secrets for a team with pagination. **Required Role:** VIEWER or higher **Security Note:** Credentials are NEVER returned in this endpoint. Only metadata (name, description, type, timestamps) is returned. Query parameters: - q: Search by name (case-insensitive partial match) - secret_type: Filter by provider type (s3, azure_blob, gcs, r2, b2, wasabi, etc.) - sort_by: Field to sort by (name, created_at) - sort_order: Sort direction (asc, desc). Default: desc - page: Page number (default: 1) - limit: Items per page (default: 50, max: 100) Returns paginated list of secrets with metadata. ## OpenAPI ````yaml GET /v1/teams/{team_id}/secrets openapi: 3.1.0 info: title: Data Raven API description: Cloud-to-cloud data transfer platform powered by RClone version: 0.5.0 servers: [] security: [] paths: /v1/teams/{team_id}/secrets: get: tags: - Secrets summary: List Secrets description: >- Get all secrets for a team with pagination. **Required Role:** VIEWER or higher **Security Note:** Credentials are NEVER returned in this endpoint. Only metadata (name, description, type, timestamps) is returned. Query parameters: - q: Search by name (case-insensitive partial match) - secret_type: Filter by provider type (s3, azure_blob, gcs, r2, b2, wasabi, etc.) - sort_by: Field to sort by (name, created_at) - sort_order: Sort direction (asc, desc). Default: desc - page: Page number (default: 1) - limit: Items per page (default: 50, max: 100) Returns paginated list of secrets with metadata. operationId: list_secrets_v1_teams__team_id__secrets_get parameters: - name: team_id in: path required: true schema: type: string format: uuid title: Team Id - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: Search by name (case-insensitive) title: Q description: Search by name (case-insensitive) - name: secret_type in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by provider type (s3, azure_blob, gcs, etc.) title: Secret Type description: Filter by provider type (s3, azure_blob, gcs, etc.) - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 50 title: Limit description: Items per page - name: sort_by in: query required: false schema: anyOf: - enum: - name - created_at type: string - type: 'null' description: 'Field to sort by: name, created_at' title: Sort By description: 'Field to sort by: name, created_at' - name: sort_order in: query required: false schema: anyOf: - $ref: '#/components/schemas/SortOrder' - type: 'null' description: 'Sort order: asc or desc (default: desc)' title: Sort Order description: 'Sort order: asc or desc (default: desc)' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_SecretResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: SortOrder: type: string enum: - asc - desc title: SortOrder description: Sort order for list endpoints. PaginatedResponse_SecretResponse_: properties: data: items: $ref: '#/components/schemas/SecretResponse' type: array title: Data pagination: $ref: '#/components/schemas/PaginationResponse' type: object required: - data - pagination title: PaginatedResponse[SecretResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SecretResponse: properties: id: type: string format: uuid title: Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description secret_type: $ref: '#/components/schemas/LocationType' auth_method: $ref: '#/components/schemas/AuthMethod' created_at: type: string format: date-time title: Created At created_by: type: string format: uuid title: Created By type: object required: - id - name - description - secret_type - auth_method - created_at - created_by title: SecretResponse description: |- Schema for secret metadata response (without credentials). Credentials are NEVER returned in any API response. PaginationResponse: properties: page: type: integer title: Page limit: type: integer title: Limit total: type: integer title: Total total_pages: type: integer title: Total Pages type: object required: - page - limit - total - total_pages title: PaginationResponse description: Pagination metadata in responses. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError LocationType: type: string enum: - s3 - azure_blob - gcs - r2 - b2 - wasabi - railway - oracle_object_storage_s3 - s3_compatible - tigris - digitalocean_spaces - hetzner - rabata title: LocationType description: Cloud storage provider types. AuthMethod: type: string enum: - s3_access_key - r2_access_key - wasabi_access_key - railway_access_key - oracle_object_storage_s3_access_key - s3_compatible_access_key - tigris_access_key - digitalocean_spaces_access_key - hetzner_access_key - rabata_access_key - azure_account_key - azure_sas_url - gcs_service_account - b2_application_key title: AuthMethod description: |- Authentication mechanism identifiers for cloud storage credentials. Each provider may support one or more authentication methods. Explicit names ensure clarity and make it easy to add new methods. securitySchemes: HTTPBearer: type: http scheme: bearer ````