Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cisco-crosswork-operations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cisco Crosswork Operations API
version: '1.0'
description: 'Operations tagged operations across 5 of this provider''s published API definitions: cisco-crosswork-coe-l3-openapi.json, cisco-crosswork-coe-l3-state-openapi.json, cisco-crosswork-coe-network-state-openapi.json, cisco-crosswork-coe-oe-operations-openapi.json, cisco-crosswork-coe-sr-operations-openapi.json. Each path carries the servers of the definition it was published in.'
x-provenance:
method: harvested
authored_by: Cisco Crosswork
harvested_by: API Evangelist
harvested_on: '2026-08-19'
first_party: true
note: Published by Cisco. Retrieved unmodified except for this x-provenance block.
provider_published: true
derived_view: Per-tag view of cisco-crosswork-coe-sr-operations-openapi.json, the provider's source document. Operations and schemas are the provider's, unmodified; only the partition is ours.
derived_from: cisco-crosswork-coe-sr-operations-openapi.json
operation_coverage: 4/8
x-evidence:
- type: source
url: https://github.com/CiscoDevNet/crosswork-openapi-spec/blob/master/COE/2.0APIs/sr_operations.swagger.json
- type: raw
url: https://raw.githubusercontent.com/CiscoDevNet/crosswork-openapi-spec/master/COE/2.0APIs/sr_operations.swagger.json
servers:
- url: /crosswork/nbi/optima/v1/restconf
tags:
- name: operations
description: operations resources
paths:
/operations:
servers:
- url: /crosswork/nbi/optima/v1/restconf
get:
tags:
- operations
summary: 'This module defines a model for Layer 3 Unicast
topologies.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust''s Legal Provisions
Relating to IETF Documents
(https://trustee.ietf.org/license-info).
This version of this YANG module is part of
RFC 8346; see the RFC itself for full legal notices.'
description: 'This module defines a model for Layer 3 Unicast
topologies.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust''s Legal Provisions
Relating to IETF Documents
(https://trustee.ietf.org/license-info).
This version of this YANG module is part of
RFC 8346; see the RFC itself for full legal notices.'
operationId: operations_get
responses:
'200':
description: 'This module defines a model for Layer 3 Unicast
topologies.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust''s Legal Provisions
Relating to IETF Documents
(https://trustee.ietf.org/license-info).
This version of this YANG module is part of
RFC 8346; see the RFC itself for full legal notices.'
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-operations:sr-policies-on-interface:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Find all the SR Policies that start from or go through the specified node and interface combo.
operationId: operations_cisco_crosswork_optimization_engine_operations_sr_policies_on_interface_post
parameters:
- $ref: '#/components/parameters/operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-interface-post-input'
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-interface-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-operations:sr-policies-on-node:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Find all the SR Policies that start at, end at, or go through the specified node. An enum is used to specified whether the SR Policy should go through the node, uses the node as a source, uses the node as a destination, or uses the as either a source or destination.
operationId: operations_cisco_crosswork_optimization_engine_operations_sr_policies_on_node_post
parameters:
- $ref: '#/components/parameters/operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-node-post-input'
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-node-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-operations:sr-policy-routes:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Finds all the SR Policies that match the given headend, endpoint, and color filters.
operationId: operations_cisco_crosswork_optimization_engine_operations_sr_policy_routes_post
parameters:
- $ref: '#/components/parameters/operations_cisco-crosswork-optimization-engine-operations_sr-policy-routes-post-input'
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-operations_sr-policy-routes-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-sr-policy-operations:sr-policy-create:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Create operation for SR policies
operationId: operations_cisco_crosswork_optimization_engine_sr_policy_operations_sr_policy_create_post
requestBody:
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-create-post-input'
required: true
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-create-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-sr-policy-operations:sr-policy-modify:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Update operation for SR policies
operationId: operations_cisco_crosswork_optimization_engine_sr_policy_operations_sr_policy_modify_post
requestBody:
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-modify-post-input'
required: true
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-modify-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-sr-policy-operations:sr-policy-delete:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Delete operation for SR policies
operationId: operations_cisco_crosswork_optimization_engine_sr_policy_operations_sr_policy_delete_post
requestBody:
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-delete-post-input'
required: true
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-delete-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
/operations/cisco-crosswork-optimization-engine-sr-policy-operations:sr-policy-dryrun:
servers:
- url: /crosswork/nbi/optima/v1/restconf
post:
tags:
- operations
summary: ''
description: Preview operation for SR policies
operationId: operations_cisco_crosswork_optimization_engine_sr_policy_operations_sr_policy_dryrun_post
requestBody:
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-dryrun-post-input'
required: true
responses:
'201':
description: Created
content:
application/yang-data+json:
schema:
$ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-dryrun-post-output'
'204':
$ref: '#/components/responses/204'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'404':
$ref: '#/components/responses/404'
'405':
$ref: '#/components/responses/405'
'409':
$ref: '#/components/responses/409'
security:
- basicAuth: []
components:
schemas:
operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-node-post-input:
type: object
properties:
input:
type: object
properties:
nodes:
type: array
description: (list)
items:
type: object
properties:
node:
description: The hostname of the node (leaf)
type: string
format: string
filter:
description: The SR policy filters to apply on the node list above (leaf)
type: string
format: enumeration
default: through-nodes
enum:
- through-nodes
- nodes-as-source
- nodes-as-destination
- nodes-as-source-or-destination
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_bwod:
description: Parameters specific to a BWOD SR policy path
type: object
properties:
bandwidth:
description: The desired bandwidth for the SR policy (leaf)
type: number
format: double
bw-path-optimization-objective:
description: The objective to minimize, igp-metric, te-metric or delay (leaf)
type: string
format: enumeration
default: igp-metric
enum:
- igp-metric
- te-metric
- delay
- hop-count
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_dynamic:
description: Parameters specific to a Dynamic SR policy path
type: object
properties:
affinities:
description: (non-presence)
type: object
properties:
include-any:
description: include-any affinity bits combined into an unsigned integer (leaf)
type: integer
format: uint32
include-all:
description: include-any affinity bits combined into an unsigned integer (leaf)
type: integer
format: uint32
exclude-any:
description: include-any affinity bits combined into an unsigned integer (leaf)
type: integer
format: uint32
disjointness:
description: (non-presence)
type: object
properties:
disjointness-type:
description: (leaf)
type: string
format: enumeration
default: node
enum:
- node
- circuit
- srlg
- srlg-node
association-group:
description: Association group (leaf)
type: integer
format: uint32
association-sub-group:
description: Association sub-group (leaf)
type: integer
format: uint32
path-optimization-objective:
description: The objective to minimize, igp-metric, te-metric or delay (leaf)
type: string
format: enumeration
default: igp-metric
enum:
- igp-metric
- te-metric
- delay
- hop-count
protected:
description: Use protected adjacency SIDs in path computation, defaults to true (leaf)
type: string
format: boolean
operations_cisco-crosswork-optimization-engine-operations_sr-policy-routes-post-output:
type: object
properties:
cisco-crosswork-optimization-engine-operations:output:
type: object
properties:
status:
description: Enumeration of the request state (leaf)
type: string
format: enumeration
default: error
enum:
- error
- accepted
- rejected
message:
description: The details of status above (leaf)
type: string
format: string
results:
type: array
description: (list)
items:
type: object
properties:
head-end:
description: The IP address of the SR policy source. (leaf)
type: string
format: union
end-point:
description: The IP address of the SR policy destination. (leaf)
type: string
format: union
color:
description: The color for the SR policy. (leaf)
type: integer
format: uint32
path-computation-status:
description: The IGP path computation status for an SR policy (leaf)
type: string
format: enumeration
default: success
enum:
- success
- failure
path-computation-message:
description: The details of IGP path computation status above (leaf)
type: string
format: string
igp-route:
type: array
description: (list)
items:
type: object
properties:
node:
description: The hostname of the source-node for the interface (leaf)
type: string
format: string
interface:
description: The name of the interface (leaf)
type: string
format: string
interface-use:
description: Route portion using that interface, ranges from 0 to 1 (leaf)
type: number
format: double
operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-node-post-output:
type: object
properties:
cisco-crosswork-optimization-engine-operations:output:
type: object
properties:
status:
description: Enumeration of the request state (leaf)
type: string
format: enumeration
default: error
enum:
- error
- accepted
- rejected
message:
description: The details of status above (leaf)
type: string
format: string
node-sr-policies:
type: array
description: (list)
items:
type: object
properties:
node:
description: The hostname of the node (leaf)
type: string
format: string
message:
description: (leaf)
type: string
format: string
sr-policies:
type: array
description: (list)
items:
type: object
properties:
head-end:
description: The IP address of the SR policy source. (leaf)
type: string
format: union
end-point:
description: The IP address of the SR policy destination. (leaf)
type: string
format: union
color:
description: The color for the SR policy. (leaf)
type: integer
format: uint32
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-dryrun-post-output:
type: object
properties:
cisco-crosswork-optimization-engine-sr-policy-operations:output:
type: object
properties:
state:
description: The result for the policy preview operation (leaf)
type: string
format: enumeration
default: success
enum:
- success
- failure
- degraded
message:
description: The details of state above, for failure or degraded (leaf)
type: string
format: string
igp-route:
type: array
description: (list)
items:
type: object
properties:
node:
description: The hostname of the source-node for the interface (leaf)
type: string
format: string
interface:
description: The name of the interface (leaf)
type: string
format: string
segment-list-hops:
type: array
description: (list)
items:
type: object
properties:
step:
description: The representation of the hop order in the path (leaf)
type: integer
format: uint32
sid:
description: The segment identifier for the hop (leaf)
type: integer
format: uint32
ip-address:
description: The IP address of the hop (leaf)
type: string
format: union
type:
description: The type of the hop (leaf)
type: string
format: enumeration
default: node-ipv4
enum:
- node-ipv4
- adjacency-ipv4
- node-ipv6
- adjacency-ipv6
- unknown
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-create-post-input:
type: object
properties:
input:
type: object
properties:
sr-policies:
type: array
description: (list)
items:
type: object
properties:
head-end:
description: The IP address of the SR policy source (leaf)
type: string
format: union
end-point:
description: The IP address of the SR policy destination (leaf)
type: string
format: union
color:
description: The color for the SR policy (leaf)
type: integer
format: uint32
path-name:
description: The path name of the SR policy (leaf)
type: string
format: string
description:
description: The description of the SR policy (leaf)
type: string
format: string
binding-sid:
description: The binding SID for the SR policy (leaf)
type: integer
format: uint32
profile-id:
description: The profile ID for the SR policy (leaf)
type: integer
format: uint32
sr-policy-path:
description: (non-presence)
type: object
oneOf:
- $ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_explicit'
- $ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_dynamic'
- $ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_bwod'
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-modify-post-input:
type: object
properties:
input:
type: object
properties:
sr-policies:
type: array
description: (list)
items:
type: object
properties:
head-end:
description: The IP address of the SR policy source (leaf)
type: string
format: union
end-point:
description: The IP address of the SR policy destination (leaf)
type: string
format: union
color:
description: The color for the SR policy (leaf)
type: integer
format: uint32
path-name:
description: The path name of the SR policy (leaf)
type: string
format: string
description:
description: The description of the SR policy (leaf)
type: string
format: string
binding-sid:
description: The binding SID for the SR policy (leaf)
type: integer
format: uint32
profile-id:
description: The profile ID for the SR policy (leaf)
type: integer
format: uint32
sr-policy-path:
description: (non-presence)
type: object
oneOf:
- $ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_explicit'
- $ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_dynamic'
- $ref: '#/components/schemas/operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-path_bwod'
operations:
type: object
properties:
ietf-restconf:operations:
type: object
x-yang:
type: operations
description: This resource is a container that provides access to the data-model-specific RPC operations supported by the server. See RESTCONF RFC 8040 for further information.
properties: {}
operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-interface-post-input:
type: object
properties:
input:
type: object
properties:
interfaces:
type: array
description: (list)
items:
type: object
properties:
node:
description: The hostname of the source-node for the interface (leaf)
type: string
format: string
interface:
description: The name of the interface (leaf)
type: string
format: string
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-delete-post-output:
type: object
properties:
cisco-crosswork-optimization-engine-sr-policy-operations:output:
type: object
properties:
results:
type: array
description: (list)
items:
type: object
properties:
head-end:
description: The IP address of the SR policy source (leaf)
type: string
format: union
end-point:
description: The IP address of the SR policy destination (leaf)
type: string
format: union
color:
description: The color for the SR policy (leaf)
type: integer
format: uint32
state:
description: The result for a policy create, update or delete operation (leaf)
type: string
format: enumeration
default: success
enum:
- success
- failure
- degraded
message:
description: The details of state above, for failure and degraded (leaf)
type: string
format: string
operations_cisco-crosswork-optimization-engine-sr-policy-operations_sr-policy-delete-post-input:
type: object
properties:
input:
type: object
properties:
sr-policies:
type: array
description: (list)
items:
type: object
properties:
head-end:
description: The IP address of the SR policy source (leaf)
type: string
format: union
end-point:
description: The IP address of the SR policy destination (leaf)
type: string
format: union
color:
description: The color for the SR policy (leaf)
type: integer
format: uint32
operations_cisco-crosswork-optimization-engine-operations_sr-policies-on-interface-post-output:
type: object
properties:
cisco-crosswork-optimization-engine-operations:output:
type: object
properties:
status:
description: Enumeration of the request state (leaf)
type: string
format: enumeration
default: error
enum:
- error
- accepted
- rejected
message:
description: The details of status above (leaf)
type: string
format: string
interface-sr-policies:
type: array
description: (list)
items:
type: object
properties:
node:
description: The hostname of the source-node for the interface (leaf)
type: string
format: string
interface:
description: The name of the interface (leaf)
type: string
format: string
message:
description: (leaf)
type: string
format: string
sr-policies:
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-crosswork/refs/heads/main/openapi/cisco-crosswork-operations-api-openapi.yml