openapi: 3.1.0
info:
  title: Kubernetes Core API (v1) ConfigMaps Secrets API
  description: 'The Kubernetes API is served by the kube-apiserver and exposes a uniform,

    versioned REST surface for cluster resources. This OpenAPI is a hand-curated

    subset of the core/v1 group covering the most common workloads — pods,

    namespaces, services, configmaps, secrets, nodes, and persistent volumes.

    Authentication is per-cluster (bearer tokens, client certs, OIDC). The base

    URL is the API server endpoint of a given cluster (no single public base).

    This file is an API Evangelist research artifact for the scalable-services

    topic.

    '
  version: 1.0.0
  contact:
    name: API Evangelist
    url: https://apievangelist.com
servers:
- url: https://kubernetes.default.svc
  description: In-cluster API server
- url: https://{cluster}:6443
  description: External cluster endpoint
  variables:
    cluster:
      default: localhost
      description: Cluster API server hostname
security:
- BearerAuth: []
tags:
- name: Secrets
paths:
  /api/v1/namespaces/{namespace}/secrets:
    parameters:
    - $ref: '#/components/parameters/Namespace'
    get:
      summary: List secrets in a namespace
      operationId: listSecrets
      tags:
      - Secrets
      responses:
        '200':
          description: Secret list.
    post:
      summary: Create a secret
      operationId: createSecret
      tags:
      - Secrets
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Secret created.
components:
  parameters:
    Namespace:
      name: namespace
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: ServiceAccountToken