Novu · Capability

Novu API — Environment Variables

Notifications — Environment Variables. 6 operations. Lead operation: List All Variables. Self-contained Naftiko capability covering one Novu business surface.

Novu API — Environment Variables is a Naftiko capability published by Novu, one of 16 capabilities the APIs.io network indexes for this provider. It bundles 6 operations across the GET, POST, PATCH, and DELETE methods rooted at /v1/environment-variables.

The capability includes 3 read-only operations and 3 state-changing operations. Lead operation: Novu List All Variables. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Novu, Notifications, and Environment Variables.

Run with Naftiko NovuNotificationsEnvironment Variables

What You Can Do

GET

Environmentvariablescontroller_listenvironmentvariables — Novu List All Variables

/v1/environment-variables

POST

Environmentvariablescontroller_createenvironmentvariable — Novu Create a Variable

/v1/environment-variables

GET

Environmentvariablescontroller_getenvironmentvariableusage — Novu Retrieve a Variable Usage

/v1/environment-variables/{variableKey}/usage

GET

Environmentvariablescontroller_getenvironmentvariable — Novu Get Environment Variable

/v1/environment-variables/{variableKey}

PATCH

Environmentvariablescontroller_updateenvironmentvariable — Novu Update a Variable

/v1/environment-variables/{variableKey}

DELETE

Environmentvariablescontroller_deleteenvironmentvariable — Novu Delete Environment Variable

/v1/environment-variables/{variableKey}

MCP Tools

list-all-variables

Novu List All Variables

read-only idempotent

create-variable

Novu Create a Variable

retrieve-variable-usage

Novu Retrieve a Variable Usage

read-only idempotent

get-environment-variable

Novu Get Environment Variable

read-only idempotent

update-variable

Novu Update a Variable

idempotent

delete-environment-variable

Novu Delete Environment Variable

idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Novu API — Environment Variables
  description: 'Notifications — Environment Variables. 6 operations. Lead operation: List All Variables. Self-contained Naftiko capability covering one Novu business surface.'
  tags:
  - Novu
  - Notifications
  - Environment Variables
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    NOVU_API_KEY: NOVU_API_KEY
capability:
  consumes:
  - type: http
    namespace: novu-environment-variables
    baseUri: https://api.novu.co
    description: Novu REST API — Environment Variables business capability. Self-contained, no shared references.
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.NOVU_API_KEY}}'
      placement: header
    resources:
    - name: v1-environment-variables
      path: /v1/environment-variables
      operations:
      - name: EnvironmentVariablesController_listEnvironmentVariables
        method: GET
        description: Novu List All Variables
        inputParameters:
        - name: search
          in: query
          type: string
          required: false
          description: Filter variables by key (case-insensitive partial match)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: EnvironmentVariablesController_createEnvironmentVariable
        method: POST
        description: Novu Create a Variable
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body payload
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-environment-variables-variablekey-usage
      path: /v1/environment-variables/{variableKey}/usage
      operations:
      - name: EnvironmentVariablesController_getEnvironmentVariableUsage
        method: GET
        description: Novu Retrieve a Variable Usage
        inputParameters:
        - name: variableKey
          in: path
          type: string
          required: true
          description: The unique key of the environment variable (e.g. BASE_URL)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-environment-variables-variablekey
      path: /v1/environment-variables/{variableKey}
      operations:
      - name: EnvironmentVariablesController_getEnvironmentVariable
        method: GET
        description: Novu Get Environment Variable
        inputParameters:
        - name: variableKey
          in: path
          type: string
          required: true
          description: The unique key of the environment variable (e.g. BASE_URL)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: EnvironmentVariablesController_updateEnvironmentVariable
        method: PATCH
        description: Novu Update a Variable
        inputParameters:
        - name: variableKey
          in: path
          type: string
          required: true
          description: The unique key of the environment variable (e.g. BASE_URL)
        - name: body
          in: body
          type: object
          required: true
          description: Request body payload
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: EnvironmentVariablesController_deleteEnvironmentVariable
        method: DELETE
        description: Novu Delete Environment Variable
        inputParameters:
        - name: variableKey
          in: path
          type: string
          required: true
          description: The unique key of the environment variable (e.g. BASE_URL)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: novu-environment-variables-rest
    port: 8080
    description: REST adapter for Novu API — Environment Variables. One Spectral-compliant resource per consumed operation.
    resources:
    - path: /v1/environment-variables
      name: v1-environment-variables
      description: REST surface for /v1/environment-variables.
      operations:
      - method: GET
        name: EnvironmentVariablesController_listEnvironmentVariables
        description: Novu List All Variables
        call: novu-environment-variables.EnvironmentVariablesController_listEnvironmentVariables
        with:
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: EnvironmentVariablesController_createEnvironmentVariable
        description: Novu Create a Variable
        call: novu-environment-variables.EnvironmentVariablesController_createEnvironmentVariable
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/environment-variables/{variableKey}/usage
      name: v1-environment-variables-variablekey-usage
      description: REST surface for /v1/environment-variables/{variableKey}/usage.
      operations:
      - method: GET
        name: EnvironmentVariablesController_getEnvironmentVariableUsage
        description: Novu Retrieve a Variable Usage
        call: novu-environment-variables.EnvironmentVariablesController_getEnvironmentVariableUsage
        with:
          variableKey: rest.variableKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/environment-variables/{variableKey}
      name: v1-environment-variables-variablekey
      description: REST surface for /v1/environment-variables/{variableKey}.
      operations:
      - method: GET
        name: EnvironmentVariablesController_getEnvironmentVariable
        description: Novu Get Environment Variable
        call: novu-environment-variables.EnvironmentVariablesController_getEnvironmentVariable
        with:
          variableKey: rest.variableKey
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: EnvironmentVariablesController_updateEnvironmentVariable
        description: Novu Update a Variable
        call: novu-environment-variables.EnvironmentVariablesController_updateEnvironmentVariable
        with:
          variableKey: rest.variableKey
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: EnvironmentVariablesController_deleteEnvironmentVariable
        description: Novu Delete Environment Variable
        call: novu-environment-variables.EnvironmentVariablesController_deleteEnvironmentVariable
        with:
          variableKey: rest.variableKey
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: novu-environment-variables-mcp
    port: 9090
    transport: http
    description: MCP adapter for Novu API — Environment Variables. One tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: list-all-variables
      description: Novu List All Variables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: novu-environment-variables.EnvironmentVariablesController_listEnvironmentVariables
      with:
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: create-variable
      description: Novu Create a Variable
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: novu-environment-variables.EnvironmentVariablesController_createEnvironmentVariable
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-variable-usage
      description: Novu Retrieve a Variable Usage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: novu-environment-variables.EnvironmentVariablesController_getEnvironmentVariableUsage
      with:
        variableKey: tools.variableKey
      outputParameters:
      - type: object
        mapping: $.
    - name: get-environment-variable
      description: Novu Get Environment Variable
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: novu-environment-variables.EnvironmentVariablesController_getEnvironmentVariable
      with:
        variableKey: tools.variableKey
      outputParameters:
      - type: object
        mapping: $.
    - name: update-variable
      description: Novu Update a Variable
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: novu-environment-variables.EnvironmentVariablesController_updateEnvironmentVariable
      with:
        variableKey: tools.variableKey
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-environment-variable
      description: Novu Delete Environment Variable
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: novu-environment-variables.EnvironmentVariablesController_deleteEnvironmentVariable
      with:
        variableKey: tools.variableKey
      outputParameters:
      - type: object
        mapping: $.