---
title: "Edit subscription by id"
method: POST
path: "/smartfolder/{id}/edit"
tags: ["Subscriptions"]
---

# Edit subscription by id

`POST /smartfolder/{id}/edit`

## Request

- Base URL: `https://asm.cloud.tenable.com/api/1.0`
- URL: `https://asm.cloud.tenable.com/api/1.0/smartfolder/{id}/edit`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/tenable/apis/attack-surface-management/docs/smartfolder/:id/edit/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string: Name of the folder
  - `description` string: Description of the folder
  - `notifications` object[]
    - `type` 'email' | 'slack' | 'servicenow', required
    - `email` string, email
    - `webhookUrl` string: To be used for Slack integration.
    - `enabled` boolean, required
  - `filters` FilterItem[]: Filters to be applied on assets, consists of FilterItem objects.
    - `column` string: The property to filter on. You can use the [List Asset Properties](ref:getavailablecolumns) endpoint to get a list of possible values.
    - `type` string: The type of filter to apply. Refer to [Robust Filtering](https://docs.tenable.com/attack-surface-management/Content/Topics/Inventory/AssetFilters.htm#Robust_Filtering) for a list of possible filter types.
    - `value` string: The value to filter on. For date-time values, please use the ISO format. For example: "2024-10-21T10:00:00.000Z".
  - `extra` object
    - `columns` string[]
    - `view` string
    - `details` string
    - `exploit_cost` number
    - `fix_cost` number
    - `exploit_likelihood` number
    - `exploitation_duration` number
    - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' | 'INFO'
    - `groupByType` 'id' | 'bd.original_hostname' | 'bd.ip_address'

## Response `200`

OK

- object
  - `affectedRows` integer

## Other responses

- `401`: Unauthorized
- `404`: The specified resource was not found
- `500`: Internal server error

---

[API](https://skmtc.dev/tenable/apis/attack-surface-management.md) - [All operations](https://skmtc.dev/tenable/apis/attack-surface-management/llms.txt) - [OpenAPI document](https://skmtc.dev/tenable/apis/attack-surface-management/revisions/465c06285e48?raw)