UX 2.0 feature profiles for the SD-Routing solution: system, transport and service profiles for routers managed by SD-WAN Manager without the SD-WAN overlay.
{
"openapi": "3.1.0",
"info": {
"title": "Feature Profiles - SD-Routing",
"description": "Feature profiles associated with UX 2.0 configuration\nIncludes API operations for the following:\n Feature Profiles in SD-Routing Solution\n Supporting software-defined routing features and autonomous router management",
"contact": {
"email": "vmanage@cisco.com"
},
"license": {
"name": "Commercial License",
"url": "https://www.cisco.com/c/en/us/solutions/enterprise-networks/sd-wan/index.html"
},
"version": "26.1.0+2026-01-06",
"x-provenance": {
"method": "harvested",
"authored_by": "Cisco Catalyst SD-WAN",
"harvested_by": "API Evangelist",
"harvested_on": "2026-08-19",
"first_party": true,
"provider_published": true,
"source_host": "pubhub.devnetcloud.com",
"note": "4,138 operations across 2,841 paths, published by Cisco as self-contained per-operation OpenAPI 3.1.0 fragments on the DevNet CDN and consolidated here into 13 documents. Ownership verified from info.contact vmanage@cisco.com and the Cisco license URL rather than from the fetch host."
},
"x-evidence": [
{
"type": "source",
"url": "https://pubhub.devnetcloud.com/media/cisco-catalyst-sd-wan-26-1-api-guide/docs/"
},
{
"type": "source",
"url": "https://developer.cisco.com/docs/sdwan/"
}
]
},
"servers": [
{
"url": "/dataservice"
}
],
"tags": [
{
"name": "Configuration - Feature Profile (SD-Routing)"
}
],
"paths": {
"/v1/feature-profile/sd-routing": {
"get": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Get all SD-Routing Feature Profiles",
"operationId": "GetSdroutingFeatureProfiles",
"parameters": [
{
"name": "offset",
"in": "query",
"description": "Pagination offset",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "limit",
"in": "query",
"description": "Pagination limit",
"schema": {
"type": "integer",
"format": "int32",
"default": 0
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"profileId": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"$$ref": "#/components/schemas/CommonCommonDefs_uuidDef"
},
"profileName": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"profileType": {
"type": "string",
"enum": [
"profile"
]
},
"createdBy": {
"type": "string",
"description": "User who last created this.",
"readOnly": true
},
"createdOn": {
"type": "integer",
"description": "Timestamp of creation",
"format": "int64",
"readOnly": true
},
"lastUpdatedBy": {
"type": "string",
"description": "User who last updated this.",
"readOnly": true
},
"lastUpdatedOn": {
"type": "integer",
"description": "Timestamp of last update",
"format": "int64",
"readOnly": true
},
"description": {
"type": "string"
},
"solution": {
"type": "string",
"enum": [
"sd-routing"
]
}
}
},
"$$ref": "#/components/schemas/getListSdRoutingProfilePayload"
},
"examples": {
"get response example": {
"value": [
{
"profileId": "bc99ae4f-0ac3-4a51-95cb-c718953143ce",
"profileName": "cg1_LAN",
"solution": "sd-routing",
"profileType": "profile",
"createdBy": "admin",
"lastUpdatedBy": "admin",
"createdOn": 1701850310222,
"description": "cg1 profile Profile",
"lastUpdatedOn": 1702292120081
}
],
"$$ref": "#/components/examples/getListSdRoutingProfileExample"
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > SD-Routing CLI Add On-read"
}
},
"/v1/feature-profile/sd-routing/cli": {
"post": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Create a SD-Routing CLI Feature Profile",
"operationId": "CreateSdroutingCliFeatureProfile",
"requestBody": {
"description": "SD-Routing CLI Feature Profile",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"description": {
"type": "string"
},
"fromFeatureProfile": {
"type": "object",
"description": "from another feature profile",
"oneOf": [
{
"properties": {
"copy": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"$$ref": "#/components/schemas/CommonCommonDefs_uuidDef"
}
},
"required": [
"copy"
],
"additionalProperties": false
}
],
"$$ref": "#/components/schemas/FeatureprofileCommonPostRequest_fromFeatureProfileDef"
}
},
"required": [
"name",
"description"
],
"additionalProperties": false,
"$$ref": "#/components/schemas/FeatureprofileCommonPostRequest_SchemaPayload"
},
"examples": {
"FeatureProfile-ConfigGroup1-NY": {
"value": {
"name": "FeatureProfile-ConfigGroup1-NY",
"description": "Feature Profile for config group 1 for NY site"
},
"$$ref": "#/components/examples/FeatureprofileCommonPostRequest_FeatureProfile-ConfigGroup1-NY"
},
"FeatureProfile-ConfigGroup1-COPY": {
"value": {
"name": "FeatureProfile-ConfigGroup1-COPY",
"description": "Copy Feature Profile from EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993F99",
"fromFeatureProfile": {
"copy": "EEBE1AaD-DbC6-A9C2-E5F2-a9aFDD993F99"
}
},
"$$ref": "#/components/examples/FeatureprofileCommonPostRequest_FeatureProfile-ConfigGroup1-COPY"
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$$ref": "#/components/schemas/FeatureprofileCommonPostResponse_SchemaPayload"
},
"examples": {
"example_1": {
"value": {
"id": "Cc51Cc8B-e2c3-F701-438F-eE6Fbac38AAB"
},
"$$ref": "#/components/examples/FeatureprofileCommonPostResponse_example_1"
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > SD-Routing CLI Add On-write"
},
"get": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Get all SD-Routing CLI Feature Profiles",
"operationId": "GetSdroutingCliFeatureProfiles",
"parameters": [
{
"name": "offset",
"in": "query",
"description": "Pagination offset",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "limit",
"in": "query",
"description": "Pagination limit",
"schema": {
"type": "integer",
"format": "int32",
"default": 0
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"profileId": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"$$ref": "#/components/schemas/CommonCommonDefs_uuidDef"
},
"profileName": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"profileType": {
"type": "string",
"enum": [
"cli"
]
},
"createdBy": {
"type": "string",
"description": "User who last created this.",
"readOnly": true
},
"createdOn": {
"type": "integer",
"description": "Timestamp of creation",
"format": "int64",
"readOnly": true
},
"lastUpdatedBy": {
"type": "string",
"description": "User who last updated this.",
"readOnly": true
},
"lastUpdatedOn": {
"type": "integer",
"description": "Timestamp of last update",
"format": "int64",
"readOnly": true
},
"description": {
"type": "string"
},
"solution": {
"type": "string",
"enum": [
"sd-routing"
]
}
}
},
"$$ref": "#/components/schemas/getListSdRoutingCliPayload"
},
"examples": {
"get response example": {
"value": [
{
"profileId": "bc99ae4f-0ac3-4a51-95cb-c718953143ce",
"profileName": "cg1_LAN",
"solution": "sd-routing",
"profileType": "cli",
"createdBy": "admin",
"lastUpdatedBy": "admin",
"createdOn": 1701850310222,
"description": "cg1 cli Profile",
"lastUpdatedOn": 1702292120081
}
],
"$$ref": "#/components/examples/getListSdRoutingCliExample"
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > SD-Routing CLI Add On-read"
}
},
"/v1/feature-profile/sd-routing/cli/features": {
"get": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "GetSdroutingFeatureProfilesByFamilyAndType",
"operationId": "Get",
"parameters": [
{
"name": "offset",
"in": "query",
"description": "Pagination offset",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "limit",
"in": "query",
"description": "Pagination limit",
"schema": {
"type": "integer",
"format": "int32",
"default": 0
}
},
{
"name": "featureType",
"in": "query",
"description": "feature type",
"schema": {
"pattern": "^(config|full-config)$",
"type": "string",
"default": "config"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"profileId": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"$$ref": "#/components/schemas/CommonCommonDefs_uuidDef"
},
"profileName": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"profileType": {
"type": "string",
"enum": [
"cli"
]
},
"createdBy": {
"type": "string",
"description": "User who last created this.",
"readOnly": true
},
"createdOn": {
"type": "integer",
"description": "Timestamp of creation",
"format": "int64",
"readOnly": true
},
"lastUpdatedBy": {
"type": "string",
"description": "User who last updated this.",
"readOnly": true
},
"lastUpdatedOn": {
"type": "integer",
"description": "Timestamp of last update",
"format": "int64",
"readOnly": true
},
"description": {
"type": "string"
},
"solution": {
"type": "string",
"enum": [
"sd-routing"
]
}
}
},
"$$ref": "#/components/schemas/getListSdRoutingCliPayload"
},
"examples": {
"get response example": {
"value": [
{
"profileId": "bc99ae4f-0ac3-4a51-95cb-c718953143ce",
"profileName": "cg1_LAN",
"solution": "sd-routing",
"profileType": "cli",
"createdBy": "admin",
"lastUpdatedBy": "admin",
"createdOn": 1701850310222,
"description": "cg1 cli Profile",
"lastUpdatedOn": 1702292120081
}
],
"$$ref": "#/components/examples/getListSdRoutingCliExample"
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > CLI Add On-read"
}
},
"/v1/feature-profile/sd-routing/cli/{cliId}": {
"put": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Edit a SD-Routing CLI Feature Profile",
"operationId": "EditSdroutingCliFeatureProfile",
"parameters": [
{
"name": "cliId",
"in": "path",
"description": "Cli Profile Id",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "SD-Routing CLI Feature Profile",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"description": {
"type": "string"
}
},
"required": [
"name",
"description"
],
"additionalProperties": false,
"$$ref": "#/components/schemas/FeatureprofileCommonPutRequest_SchemaPayload"
},
"examples": {
"FeatureProfile-ConfigGroup1-NY": {
"value": {
"name": "FeatureProfile-ConfigGroup1-NY",
"description": "Feature Profile for config group 1 for NY site"
},
"$$ref": "#/components/examples/FeatureprofileCommonPutRequest_FeatureProfile-ConfigGroup1-NY"
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$$ref": "#/components/schemas/FeatureprofileCommonPutResponse_SchemaPayload"
},
"examples": {
"example_1": {
"value": {
"id": "Cc51Cc8B-e2c3-F701-438F-eE6Fbac38AAB"
},
"$$ref": "#/components/examples/FeatureprofileCommonPutResponse_example_1"
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > SD-Routing CLI Add On-write"
},
"get": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Get a SD-Routing CLI Feature Profile",
"operationId": "GetSdroutingCliFeatureProfile",
"parameters": [
{
"name": "cliId",
"in": "path",
"description": "Cli Profile Id",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"profileId": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"$$ref": "#/components/schemas/CommonCommonDefs_uuidDef"
},
"profileType": {
"type": "string",
"enum": [
"cli"
]
},
"profileName": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"description": {
"type": "string"
},
"solution": {
"type": "string",
"enum": [
"sd-routing"
]
},
"createdBy": {
"type": "string",
"description": "User who last created this.",
"readOnly": true
},
"createdOn": {
"type": "integer",
"description": "Timestamp of creation",
"format": "int64",
"readOnly": true
},
"lastUpdatedBy": {
"type": "string",
"description": "User who last updated this.",
"readOnly": true
},
"lastUpdatedOn": {
"type": "integer",
"description": "Timestamp of last update",
"format": "int64",
"readOnly": true
},
"associatedProfileParcels": {
"type": "array",
"items": {
"type": "object",
"minItems": 0,
"properties": {
"parcelId": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"$$ref": "#/components/schemas/CommonCommonDefs_uuidDef"
},
"parcelType": {
"type": "string"
},
"payload": {
"type": "object"
},
"subparcels": {
"type": "array",
"minItems": 0,
"items": {
"type": "object"
}
}
}
}
}
},
"$$ref": "#/components/schemas/getSingleSdRoutingCliPayload"
},
"examples": {
"get response example": {
"value": {
"profileName": "cg1_LAN",
"lastUpdatedBy": "admin",
"description": "cg1 cli Profile",
"profileParcelCount": 613,
"createdOn": 1701850310222,
"@rid": 3262,
"profileType": "cli",
"solution": "sd-routing",
"createdBy": "admin",
"profileId": "bc99ae4f-0ac3-4a51-95cb-c718953143ce",
"lastUpdatedOn": 1702292120081,
"associatedProfileParcels": []
},
"$$ref": "#/components/examples/getSingleSdRoutingCliExample"
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > SD-Routing CLI Add On-read"
},
"delete": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Delete a SD-Routing CLI Feature Profile",
"operationId": "DeleteSdroutingCliFeatureProfile",
"parameters": [
{
"name": "cliId",
"in": "path",
"description": "Cli Profile Id",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success"
},
"400": {
"description": "Bad Request"
},
"403": {
"description": "Forbidden"
},
"500": {
"description": "Internal Server Error"
}
},
"x-roles-required": "Feature Profile > SD-Routing CLI Add On-write"
}
},
"/v1/feature-profile/sd-routing/cli/{cliId}/config": {
"post": {
"tags": [
"Configuration - Feature Profile (SD-Routing)"
],
"description": "Create a SD-Routing CLI Add-On Feature for CLI Feature Profile",
"operationId": "CreateSdroutingCLIAddOnFeature",
"parameters": [
{
"name": "cliId",
"in": "path",
"description": "Cli Profile ID",
"required": true,
"schema": {
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"type": "string"
}
}
],
"requestBody": {
"description": "SD-Routing CLI Add-On Feature for CLI Feature Profile",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"pattern": "^[^&<>! \"]+$",
"minLength": 1,
"maxLength": 128,
"$$ref": "#/components/schemas/CommonCommonDefs_cgFpPpNameDef"
},
"description": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"config": {
"type": "string"
}
},
"required": [
"config"
],
"additionalProperties": false
}
},
"required": [
"name",
"data"
],
"x-metadata": {
"supportedDeviceTypes": [
"all"
],
"minVManageVersion": "20.15.1"
},
"additionalProperties": false,
"$$ref": "#/components/schemas/ProfileparcelSdRoutingCliConfigPostRequest_SchemaPayload"
},
"examples": {
"CliAddOnFeature": {
"value": {
"name": "CliAddOnFeature",
"data": {
"config": "bfd default-dscp 48\nbfd app-route multiplier 6\nbfd app-route poll-interval 600000"
}
},
"$$ref": "#/components/examples/ProfileparcelSdRoutingCliConfigPostRequest_CliAddOnFeature"
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
}
},
"required": [
"id"
],
"x-metadata": {
"minVManageVersion": "20.15.1"
},
"additionalProperties": false,
"$$ref": "#/components/schemas/ProfileparcelCommonPostResponse_SchemaPayload"
},
"examples": {
"example_1": {
"value": {
"id": "24C3EF06-c09a-DeFa-Ab26-a1cc4Ef0D
# --- truncated at 32 KB (57060 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-catalyst-sdwan/refs/heads/main/openapi/cisco-catalyst-sdwan-feature-profiles-sd-routing-openapi.json