> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Exclui uma entrada

> Exclui uma entrada gerenciada em tempo de execução por namespace e chave. Quando a autenticação está ativada, este endpoint exige a permissão de escrita do namespace (por exemplo, `system_operational_registry:write`). O sucesso retorna `204 No Content`.



## OpenAPI

````yaml pt/openapi/v3-current/systemplane.yaml delete /system/{namespace}/{key}
openapi: 3.1.0
info:
  title: Lerian Systemplane Admin API
  version: v1.0.0
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  license:
    name: Lerian Studio General License
  description: >-
    A API de administração do Systemplane é o plano de controle de configuração
    em tempo de execução compartilhado que as aplicações Lerian expõem para que
    você inspecione e altere configurações operacionais em um serviço em
    execução — sem reiniciar. Em ambientes financeiros regulados, derrubar um
    serviço para aplicar uma mudança de configuração é ao mesmo tempo um risco
    de conformidade e uma interrupção operacional; o Systemplane permite que
    você ajuste os valores que um serviço suporta com segurança enquanto ele
    continua atendendo ao tráfego.


    Esta superfície não é um serviço autônomo. Cada aplicação monta o mesmo
    conjunto de rotas em seu próprio host e porta HTTP sob um prefixo de caminho
    específico da aplicação — não há host nem porta dedicados ao Systemplane. O
    prefixo canônico documentado aqui é `/system`, mas ele varia por aplicação
    (por exemplo, o Lender o monta sob `/api/v1/systemplane` e os trilhos SFN
    sob `/v1/system`). Substitua o host, a porta e o prefixo da aplicação cuja
    configuração você está gerenciando. Como as rotas são registradas
    programaticamente em vez de emitidas por um gerador de código, elas não
    aparecem na referência de API gerada de cada produto — esta especificação
    documenta a superfície manualmente.


    A configuração é organizada em **namespaces**, cada um contendo entradas
    planas com chaves em string. Trilhos e plugins usam três namespaces
    canônicos — `runtime_config` (botões operacionais como limites de taxa e
    intervalos de workers), `tenant_policy` (objetos de política com escopo de
    tenant) e `operational_registry` (dados de consulta operacional). Algumas
    aplicações registram um único namespace com o nome da aplicação em vez
    disso. O valor de cada entrada é sem tipo na camada de transporte: cada
    chave registrada aceita seu próprio escalar, objeto ou array JSON, validado
    pelo validador do lado do servidor daquela chave.


    A autorização é **negar tudo por padrão**. Quando a autenticação está
    ativada, uma aplicação aplica controle de acesso baseado em papéis por
    namespace: as leituras exigem a permissão de leitura do namespace
    (`system_runtime_config:read`, `system_tenant_policy:read` ou
    `system_operational_registry:read`) e as escritas exigem a permissão de
    escrita correspondente (`system_runtime_config:write`,
    `system_tenant_policy:write` ou `system_operational_registry:write`). As
    strings exatas de permissão podem variar por aplicação. Toda a superfície é
    controlada pela configuração `SYSTEMPLANE_ENABLED`, que fica desativada por
    padrão; quando ela está desativada, a aplicação roda em modo somente
    variáveis de ambiente e essas rotas não são atendidas.


    Uma superfície de catálogo opcional sob o caminho reservado `/-/catalog`
    permite que você descubra quais chaves uma aplicação registra, junto com o
    contrato de escrita de cada chave (tipo, escopo de tenant, política de
    redação, regras de validação e exemplos). Os erros usam um envelope plano
    `{"code": <int>, "title": "<string>", "message": "<string>"}`. As operações
    de mutação retornam `204 No Content` em caso de sucesso.
servers:
  - url: https://{host}
    description: >-
      The Systemplane admin API is served by each Lerian application on its own
      host and port under an application-specific prefix (default `/system`).
      Substitute the host of the application whose runtime configuration you are
      managing.
    variables:
      host:
        default: your-lerian-app.example.com
        description: >-
          The host (and port) of the application that mounts the Systemplane
          admin API.
security:
  - BearerAuth: []
tags:
  - name: Entries
    description: >-
      Lista, lê, grava e exclui as entradas de configuração gerenciadas em tempo
      de execução em um namespace.
  - name: Catalog
    description: >-
      Descubra as chaves que uma aplicação registra e o contrato de escrita
      esperado de cada chave. Opcional por aplicação.
paths:
  /system/{namespace}/{key}:
    delete:
      tags:
        - Entries
      summary: Exclui uma entrada
      description: >-
        Exclui uma entrada gerenciada em tempo de execução por namespace e
        chave. Quando a autenticação está ativada, este endpoint exige a
        permissão de escrita do namespace (por exemplo,
        `system_operational_registry:write`). O sucesso retorna `204 No
        Content`.
      operationId: deleteSystemplaneEntry
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Key'
      responses:
        '204':
          description: The entry was deleted.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - BearerAuth: []
components:
  parameters:
    Namespace:
      name: namespace
      in: path
      required: true
      description: >-
        The Systemplane namespace. Rails and plugins use `runtime_config`,
        `tenant_policy`, or `operational_registry`; some applications register a
        single application-named namespace instead.
      schema:
        type: string
        examples:
          - runtime_config
    Key:
      name: key
      in: path
      required: true
      description: >-
        The registered key within the namespace. Keys are flat, dot-delimited
        identifiers; a key may itself contain `/` segments.
      schema:
        type: string
        examples:
          - tenancy.ispb_organization_bindings
  responses:
    BadRequest:
      description: >-
        The request is caller-correctable — an unknown key, a missing or invalid
        `value`, a value that fails the key's validator, or a request that is
        not valid for the current tenancy mode.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: >-
        Authentication failed, or there is no trusted platform identity on the
        request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: >-
        The authorizer denied the request — the identity lacks the namespace
        permission required for this action, or the surface is deny-all because
        no authorizer is configured.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: The namespace or key does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: An internal fault. Detail is logged, not returned.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ServiceUnavailable:
      description: >-
        The Systemplane store is not started or has been closed — the
        application is not currently able to serve the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      additionalProperties: false
      description: >-
        The flat error envelope returned across the Systemplane admin surface.
        It carries a machine-readable HTTP status code, a short title, and a
        human-readable message; it never returns secret material.
      properties:
        code:
          type: integer
          description: The HTTP status code.
          examples:
            - 403
        title:
          type: string
          description: A short, machine-readable title for the error class.
          examples:
            - forbidden
        message:
          type: string
          description: A human-readable description of what went wrong.
          examples:
            - 'systemplane admin: insufficient permissions: permission denied'
      required:
        - code
        - title
        - message
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        A bearer JWT issued by the platform's Access Manager (plugin-auth /
        lib-auth). Authorization is deny-all by default: the application must be
        configured with an authorizer, and when authentication is enabled it
        enforces per-namespace role-based access control on top of a valid,
        platform-scoped (non-tenant) identity. Machine callers obtain a token
        via the Access Manager client-credentials flow.

````