{"type":"api","title":"Update Customer","meta":{"id":"/apps/pubhub/media/legacy-umbrella-api/bf58de618cbb72dda8f39b0414ce94c0a15cd467/749b3a73-c1a2-3c03-8a59-0be6ab11a602","swagger":"2.0","info":{"title":"Service Providers","version":"1.0.0","description":"Service Providers and Managed Service Providers (MSPs)","contact":{"name":"Cloud Security Developer Community"}},"host":"management.api.umbrella.com","basePath":"/v1","schemes":["https"],"securityDefinitions":{"http":{"type":"basic"}},"security":[{"http":[]}],"x-parser-conf":{"httpBasic":{"username":"","password":""},"overview":{"markdownPath":"legacy/management/service-providers-overview.md"},"meta":{"useProxy":true}}},"spec":{"tags":["Service Providers"],"description":"Update a customer","summary":"Update Customer","operationId":"updateCustomer","parameters":[{"name":"serviceProviderId","type":"integer","description":"The ID of the service provider","in":"path","required":true,"$$ref":"#/parameters/serviceProviderIdParam"},{"name":"customerId","type":"integer","description":"The customer ID","in":"path","required":true,"$$ref":"#/parameters/customerIdParam"},{"schema":{"properties":{"customerName":{"type":"string","description":"The name of the customer's organization","minLength":1,"maxLength":255},"addonRbi":{"type":"string","enum":["0","1","2","3"],"maxLength":1,"description":"Remote Browser Isolation Add-On, which is applicable only for the SIG Essentials or SIG Advantage packages:\n `0` = No selection\n `1` = RBI Isolate Risky\n `2` = RBI Isolate Web Applications\n `3` = RBI Isolate All"},"addonDlp":{"type":"boolean","description":"Data Loss Prevention Add-On (applicable only for SIG E)"},"addonCdfwL7":{"type":"boolean","description":"L7 Cloud Delivered Firewall Solution (applicable only for SIG E)"},"seats":{"type":"integer","minimum":1,"description":"number of users"},"streetAddress":{"type":"string","description":"street address","minLength":1,"maxLength":255},"streetAddress2":{"type":"string","description":"The second street address","minLength":1,"maxLength":255},"city":{"type":"string","description":"city","minLength":1,"maxLength":255},"state":{"type":"string","description":"state","minLength":1,"maxLength":50},"countryCode":{"type":"string","description":"country code","minLength":2,"maxLength":2},"zipCode":{"type":"string","description":"zip code","minLength":1},"packageId":{"type":"integer","description":"| Package Id | Package Name |\n|:----------:|----------------------------------|\n| `252` | Umbrella SIG Advantage |\n| `250` | Umbrella SIG Essentials |\n| `248` | Umbrella DNS Security Advantage |\n| `246` | Umbrella DNS Security Essentials |\n| `202` | Cisco Umbrella for EDU |\n| `171` | Cisco Umbrella for Wireless LAN |\n| `107` | Umbrella Insights |\n| `101` | Umbrella Platform |\n| `99` | Umbrella Professional |\n"},"dealId":{"type":"string","description":"deal id","minLength":1,"maxLength":20},"adminEmails":{"type":"array","description":"array of admin emails","items":{"type":"string","format":"email"}},"ccwDealOwnerEmails":{"type":"array","description":"array of CCW deal owner emails","items":{"type":"string","format":"email"}}},"type":"object","required":["customerName","seats","streetAddress","city","countryCode","packageId","adminEmails"]},"description":"The customer that you want to update","name":"payload","in":"body"}],"responses":{"200":{"description":"Update a customer","schema":{"type":"object","required":["customerId","customerName","packageName","packageId","seats","streetAddress","city","countryCode","adminEmails"],"properties":{"customerId":{"type":"integer","description":"The customer ID"},"customerName":{"type":"string","description":"The customer's organization name"},"licenseType":{"type":"string","description":"The customer's organization license type"},"packageName":{"type":"string","description":"The name of the customer's subscribed package"},"seats":{"type":"integer","minimum":1,"description":"The number of users"},"streetAddress":{"type":"string","description":"The customer's street address"},"streetAddress2":{"type":"string","description":"The second street address for the customer"},"city":{"type":"string","description":"The customer's city"},"state":{"type":"string","description":"The customer's state"},"countryCode":{"type":"string","description":"The customer's country code"},"zipCode":{"type":"string","description":"The customer's zip code"},"packageId":{"type":"integer","description":"The package ID"},"dealId":{"type":"string","description":"The deal ID"},"adminEmails":{"type":"array","description":"The list of admin emails","items":{"type":"string","format":"email"}},"ccwDealOwnerEmails":{"type":"array","description":"The list of CCW deal owner emails","items":{"type":"string","format":"email"}},"createdAt":{"type":"string","format":"date-time","description":"The time when the customer was created. Specify an ISO 8601 timestamp."},"modifiedAt":{"type":"string","format":"date-time","description":"The time when the customer information was last modified. Specify an ISO 8601 timestamp."},"isTrial":{"type":"boolean","default":true,"description":"Specifies whether the customer is a trial with an MSSP with SPLA (MSLA) license"},"addonRbi":{"type":"string","description":"Remote Browser Isolation Add-On, which is applicable only for SIG Essentials or SIG Advantage packages:\n`0` = No selection\n`1` = RBI Isolate Risky\n`2` = RBI Isolate Web Applications\n`3` = RBI Isolate All"},"addonDlp":{"type":"boolean","description":"Data Loss Prevention Add-On (applicable only for SIG E)"},"addonCdfwL7":{"type":"boolean","description":"L7 Cloud Delivered Firewall Solution (applicable only for SIG E)"}},"example":{"customerId":1232353,"customerName":"Cisco","packageName":"Umbrella SIG Essentials","seats":1000,"streetAddress":"123 Customer Way","city":"San Jose","state":"CA","countryCode":"1a","packageId":250,"adminEmails":["company@cisco.com"]},"$$ref":"#/definitions/SpCustomer"}},"400":{"description":"Bad Request","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":400,"description":"the http error code returned"},"error":{"type":"string","example":"Validation Error","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"},"validationErrors":{"type":"object","properties":{"someProperty":{"type":"string","example":"must not be empty","description":"the name of the property failing validation."}}}}},"$$ref":"#/responses/BadRequest"},"401":{"description":"Unauthorized","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":401,"description":"The authorization header is missing or the token is unauthorized"},"error":{"type":"string","example":"Unauthorized","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/Unauthorized"},"403":{"description":"Forbidden","schema":{"type":"object","minProperties":1,"required":["message"],"properties":{"statusCode":{"type":"integer","example":403,"description":"the http error code returned"},"error":{"type":"string","example":"Forbidden, Invalid authentication credentials","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/Forbidden"},"404":{"description":"Not Found","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":404,"description":"the http error code returned"},"error":{"type":"string","example":"Not Found","description":"A resource that is specified in the URL was not found."},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/NotFound"},"500":{"description":"Internal Server Error","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":500,"description":"the http error code returned"},"error":{"type":"string","example":"Internal Server Error","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/ServerError"}},"__originalOperationId":"updateCustomer","consumes":["application/json"],"produces":["application/json"],"security":[{"http":[]}],"method":"put","path":"/serviceproviders/{serviceProviderId}/customers/{customerId}"}}