{"type":"api","title":"Update Interface details","meta":{"id":"/apps/pubhub/media/dna-center-235/0e427c513038595590fc5a0593cb0e208dd78571/2192edf3-d24e-3461-ab8c-12a97b547df4","swagger":"2.0","info":{"description":"Cisco DNA Center Platform v. 2.3.5","version":"2.3.5","title":"Intent API"},"schemes":["https"],"x-parser-conf":{"expand":0,"labelConfig":{"endpoint":"summary"}}},"spec":{"operationId":"updateInterfaceDetails","tags":["Devices"],"summary":"Update Interface details","description":"Add/Update Interface description, VLAN membership, Voice VLAN and change Interface admin status ('UP'/'DOWN') from Request body.","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"request","description":"request","required":true,"schema":{"type":"object","properties":{"description":{"type":"string"},"adminStatus":{"type":"string"},"vlanId":{"type":"integer"},"voiceVlanId":{"type":"integer"}},"$$ref":"#/definitions/UpdateInterfaceDetailsRequest"},"in":"body"},{"name":"Content-Type","description":"","default":"application/json","required":true,"type":"string","in":"header"},{"name":"interfaceUuid","description":"Interface ID","required":true,"type":"string","in":"path"},{"name":"deploymentMode","description":"Preview/Deploy ['Preview' means the configuration is not pushed to the device. 'Deploy' makes the configuration pushed to the device]","required":false,"type":"string","in":"query"}],"responses":{"200":{"description":"The request was successful. The result is contained in the response body.","schema":{"type":"object","properties":{"response":{"type":"object","properties":{"type":{"type":"string"},"properties":{"type":"object","properties":{"taskId":{"type":"object","properties":{"type":{"type":"string"}}},"url":{"type":"object","properties":{"type":{"type":"string"}}}}},"required":{"type":"array","items":{"type":"string"}}}},"version":{"type":"object","properties":{"type":{"type":"string"}}}},"$$ref":"#/definitions/UpdateInterfaceDetailsResponse"}},"204":{"description":"The request was successful, however no content was returned."},"400":{"description":"The client made a request that the server could not understand (for example, the request syntax is incorrect)."},"401":{"description":"The client's authentication credentials included with the request are missing or invalid."},"403":{"description":"The server recognizes the authentication credentials, but the client is not authorized to perform this request."},"415":{"description":"The client sent a request body in a format that the server does not support (for example, XML to a server that only accepts JSON)."},"500":{"description":"The server could not fulfill the request."},"503":{"description":"The server is (temporarily) unavailable."},"504":{"description":"The server did not respond inside time restrictions and timed-out."}},"__originalOperationId":"updateInterfaceDetails","method":"put","path":"/dna/intent/api/v1/interface/{interfaceUuid}"}}