Skip to main content
To Customer Support To Customer Support

API

All Things API

98 Topics
cbullas
cbullasRetired Webrooter
published in Unity API Forum
Unity API - Open API preview release

As part of making it easier to use the Unity API we have released a preview version of Open API support.  Here are a few details. Unity API users can now start with a documented ‘API library’ instead of having to set everything up from scratch, making it easier to generate code/scripts,  use testing tools and self-educate. Open API is supported by loads of tools. Files in both JSON and YAML for flexibility For more information see https://unityapi.webrootcloudav.com/Docs/en/APIDoc/APIReference#get-openapi-definition Those interested to learn about Open API https://www.openapis.org/ Note this is a public preview release, you will still need to setup access/ refresh token calls, see https://unityapi.webrootcloudav.com/Docs/en/APIDoc/GettingStarted#gettingStarted  Let us know what you think!

8694
ngoknel
Administrator
4 years ago
cbullas
cbullasRetired Webrooter
published in Unity API Forum
Universal Reporter - create customer value add reports for your customers

We have just launched our Universal Reporter tool that's been created by the Integrations team here at Webroot.  This tool allows MSPs to create custom reports that show value to your end customers. We've also made it really easy to be able to schedule and automatically email selected reports to your customers.  The tool uses the concept of templates for reports that are built using Microsoft Excel and PowerShell Scripts. Included are a sample of templates to for you to play with.  We've created our knowledge base to help you get up and running .  Download the Universal Reporter   For the coders / scripters among you check out the new Unity API SDK, PowerShell cmdlet included. It only covers reporting functions in the Unity API at present, but we would love to know what you think about it. Plus no need to worry about access and refresh tokens.   Thanks  

3730
cbullas
4 years ago
JosephRi
JosephRiRetired Webrooter
posted in Unity API Forum
IMPORTANT - Identifying your Application

[h4]IMPORTANT - Identifying your Application[/h4] When using the Unity API you need to specify a valid user agent string for all requests in the corresponding User-Agent request header. The string needs to be made up of one or more name and version pairs separated by a whitespace character (e.g. "MyCustomApplication/1.2.759 ThirdpartyPlatform/1.0.r3"), according to the HTTP/1.1 standard. Please be aware that Webroot reserves the right to reject Unity API requests that do not follow above requirement anytime in the future. Identifying your application is important and enables Webroot to provide a more targeted and streamlined API experience. If you have any questions please do not hesitate to reach out to Webroot support.

2751
O
5 years ago
C
New Voice
chrisroseNew Voice
asked in Unity API Forum
DNS ProtectionPolicy mapping via UnityAPI

Good day,I am working on enabling DNS Protection and setting some of its options using Unity API. I can successfully enable and disable the module using Unity API and I can set the site policy to one that includes DNS Protection on our endpoints, and the network wide DNS Protection Policy for a Static IP. However, I cannot see a way to set the Agent/Endpoint DNS Protection Policy. It does not even seem this is possible with the current set of commands.Am I missing something? Or is this not possible? Might it be an option that will be enabled in the future?Thanks,Chris

674
JonathanB
Webroot Employee
1 month ago
S
New Member
SFCSANew Member
asked in Unity API Forum
Get-UnityAPISkyStatusReportingEndpointUsageSite Failing

Can’t create fully extended data reports. Error every time.

180
S
New Member
2 months ago
J
Fresh Face
Jared.henryFresh Face
asked in Unity API Forum
Unity API: SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)

Starting on October 12th we noticed a rise in API call failures specific to the https://unityapi.webrootcloudav.com/service/api/status/site/{GSMKey} endpoint. The receive the following response: "statusCode: 500,""requestId: '',"error: null,""error_description: ""SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)","AdditionalInformation: {}   

803
aqila
Community Manager
1 year ago
M
Fresh Face
Matthew_LangFresh Face
posted in Unity API Forum
SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)

We have been using the API https://unityapi.webrootcloudav.com/service/api/status/site/{GSMKey} for many months now and it has been working fine until this morning.I have started receiving the following response and was wondering why this woudl suddenly be the case. I am getting the same result from other API calls for the endpoint status. {    "statusCode": 500,    "requestId": ",    "error": null,    "error_description": "SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)",    "AdditionalInformation": {}} 

921
aqila
Community Manager
1 year ago
P
New Member
papabolromeNew Member
posted in Unity API Forum
AgentStatus endpoint no QueryResults

Hello, I need to get my client’s Agentstatus data but the queryresults aren't giving me any results when trying to query it. Am I doing something wrong? Thank you! 

875
J
New Member
1 year ago
R
New Member
rajansajanNew Member
posted in Unity API Forum
Webroot API is not return all the end points

Hi All, I am calling the reports end point and it’s return only 6 endpoints, I have checked I have 7 active endpoints. or is there any way I can call the inactive endpoints using the API.If anybody can help?Thanks,  

984
B
New Member
1 year ago
David-Mee
Webroot Employee
David-MeeWebroot Employee
posted in Carbonite Replication API
Processing deeper logic in Carbonite replication PowerShell scripts: Mirror Start Options

When creating a Carbonite replication job, you have to make some decisions on the Job Options.  Some of these options straight forward decisions, do you want encryption, True or False, others may have to build more logic in the decision.  The next set of examples include how to address some of these in-depth decisions.Mirror Start OptionsThe Mirror Start Options has several different choices when viewed in the console.Mirror Start OptionsHowever, when processing the PowerShell (or REST API) you will need to calculate results based on the enumerated values found in the PowerShell Scripting Guide.  Here is a link to the specific information in case you are interested:https://download.doubletake.com/_download/8.5/8.5.1.0/Docs/PowerShell/PowerShellScriptingGuide.htm#Enumerations/MirrorOperationOptions.htm?Highlight='mirror'%20AND%20'option'in the simple example below, I show the “Import-Csv” PowerShell Cmdlet to read a multi-line .CSV file into a PowerShell object variable ($jobstream).  T

410
David-Mee
Webroot Employee
1 year ago
David-Mee
Webroot Employee
David-MeeWebroot Employee
posted in Carbonite Replication API
Create secured XML for Credentials in PowerShell

If you write PowerShell scripts for testing and want to provide them to clients, but any credentials need to be scrubbed prior to sending them, you can try using an XML Secured Object instead.  The basic concept is to create a script that receives the username and password through the secured prompt in PowerShell and outputs an XML file with the information encrypted.To note this is not a highly secured option and should not be used in any production environment.  This is an example of hiding your password while testing and demoing.Use the Read-Host -AsSecuredString to keep the password hiddencreate a new object using the System.Management.Automation.PSCredential class then use Export-clixml to output it into a Secured XML.  The xml output results in an xml file with a password value of about 460 characters….This XML is only valid on the system it was created ON so, if you copy that secured XML to another system and try to use it, it will not work. To ‘import’ this secured XML into any

9450
David-Mee
Webroot Employee
1 year ago
D
Webroot Employee
dengWebroot Employee
posted in Unity API Forum
Unity API event notification service adoption

Tell us how you are using the new Unity API event notification service.  And what are some of the new events that you like us to publish through this API endpoint? 

380
D
Webroot Employee
2 years ago
D
Webroot Employee
dengWebroot Employee
posted in Unity API Forum
what are some improvement that you want to see in Unity API

please share your thoughts

100
D
Webroot Employee
2 years ago
M
Fresh Face
Matthew_LangFresh Face
asked in Unity API Forum
Error(BLOCKEDPROGRAMS0021)

I have been using ADF to query the endpoint threat history API.https://unityapi.webrootcloudav.com//service/api/console/gsm/xxxxxx/sites/xxxxxxx/threathistoryThis has been working successfully for many weeks. we have been nearing the end of our subscription period and have been granted an extension of 30 days for our license, but now when I query this API I get the following error.Error(BLOCKEDPROGRAMS0021): Users endpoint protection access has expired"I can still get results back from other API’s I call using the same credentials so it seems isolated to the endpoint threat protection historyIs this something to do with this being a temporary license?How can I go about resolving? Many thanks Matt Lang

511
aqila
Community Manager
2 years ago
J
Fresh Face
jseumo2Fresh Face
asked in Unity API Forum
Adding a scope to an access token

Hi, I need to be able to use the notifications endpoints for the Unity API, but I am not sure where to go to add the correct scope for my testing access token. Can anyone direct me? The token already has access to the following scopes: scope": "[\"SkyStatus.Site\",\"SkyStatus.GSM\",\"SkyStatus.Usage\",\"SkyStatus.Reporting\",\"Console.GSM\"]"Thanks

1266
L
New Member
2 years ago
A
New Voice
ArjanNew Voice
posted in Unity API Forum
Restrict API to site

Is it possible to create an API key that has only access to a single site?

803
S
New Member
2 years ago
M
Fresh Face
Matthew_LangFresh Face
asked in Unity API Forum
Endpoint Status GSM Modified since parameter and return result

I am calling the Endpoint Status GSM API using postman and providing a date and time for the modifiedSince parameter. REST API Call belowGET /service/api/status/gsm/{keyCode}?batchSize=1000 &modifiedSince={modifiedSince}I would expect to see the count of records being returned to steadily increment each time I execute this request, since new records or updated records get returned,  but what I am seeing is confusing and I was hoping someone could help clarify.lets say on my first call I want to see all records that were modified since 11am today. I should see (let’s say in this use case) 100 records returned with no continuation token or URI since my batch size is set to max (1000).If I run the exact same query again a few seconds later I should see the same data or maybew 1 or 2 extra records depending on how busy my system is.What I am seeing instead is less records being returned, often along with a continuation token.I never seem to get a consistent result back, at times I see

956
M
Fresh Face
2 years ago
S
Fresh Face
Steven RFresh Face
asked in Unity API Forum
API not decoding password properly

Hi,We are trying to generate an access token for one of our clients using their username and password through the https://unityapi.webrootcloudav.com/auth/token endpoint. However, if the password contains an & symbol, we always receive the error message "Username or password is invalid”.When testing with other accounts and passwords (not containing an & character), things work fine. We double checked and we are sending the password field (as any other field) properly URL encoded. My only guess is that the receiving API server is not decoding these values correctly.Would you be able to confirm this a problem on your end or is there something we need to check again?Thanks for any help.Best regards,Steven

1488
aqila
Community Manager
2 years ago
C
Fresh Face
CSQAFresh Face
asked in Unity API Forum
Adding/removing access for Site Admin via API

I have 2 GSM Console Admins (Super Admins), 1 Site-Admin, and 2 Sites. The 1 Site admin has administrator access to both sites. I want to use the API to update their access to either No Access or View Only. When I use the endpoint “/service/api/console/gsm/{gsmKey}/sites/{siteId}/admins” (with the relevant info filled in), it’ll return a 204 but nothing updates for the Site Admin, their access stays the same.If I attempt to provision either of the GSM Console Admins using the same endpoint and changing their access level to any of the 3 levels available, it’ll work. Judging by this in the API documentation “This API method allows adding existing GSM admins to the list of admins of a site, or modifying access permissions of already set up site admins. To get information about available admins, either query the list of admins on the GSM console (see here) or the list of admins on a site (see here),”, it seems that I should be able to change a site admins access permissions… unless I’m mi

1306
S
Webroot Employee
2 years ago
C
Fresh Face
ctaylorFresh Face
asked in Unity API Forum
Unity API Scope

I am trying to suspend/deactivate sites and keep getting a scope error.I have tried scopes like:Console.GSMConsole.**But I continue to get scope errors for these endpoints. What must I do to acquire the correct scope?https://unityapi.webrootcloudav.com/service/api/console/gsm/{gsmKey}/sites/{siteId}/deactivate{ "statusCode":403, "requestId":"3c329835-981d-495e-875f-50201c49752", "error":"insufficient_scope", "error_description":"Access was denied due to insufficient token scope.", "AdditionalInformation":{}} I can change things in the site without issue but cant suspend/deactivate the site.

1233
C
Fresh Face
2 years ago
N
New Member
nitsrini698New Member
asked in Unity API Forum
Webroot threat intelligence rest api

Hi,      I know Webroot threat intelligence support Rest API for getting threat sources information .But does Webroot threat intelligence support rest API for reporting IP and URL?

2421
mattaldridge
Webroot Employee
2 years ago
P
New Member
PushkarNew Member
posted in Unity API Forum
Users endpoint protection access has expired

'{"statusCode":403,"requestId":"66597b2c-ba7e-4295-83dd-5db4fd0386c8","error":null,"error_description":"Error(LISTDEVICES0008): Users endpoint protection access has expired","AdditionalInformation":{"transname":"LISTDEVICES","languagecode":"EN"}}'II assume that this issue might have caused If the submitted access token does not contain the required scope (see Service Extensions and Scopes) for the requested API call, the server responds with an HTTP 403 (Forbidden) status code and the message "error": "insufficient_scope".  But the error here is null and the scope I passed was ‘*’.It only takes a few seconds to make that request. Span of 300sec is huge for that request, so access token expiration is unlikely to happen. I am not able to understand what `Users endpoint protection access has expired` mean.

431
ngoknel
Administrator
2 years ago
M
New Member
mbrown16037New Member
asked in Unity API Forum
ConnectWise Automate API Broken

I am no longer able to see new clients in my Automate plugin

1282
M
Fresh Face
2 years ago
S
Carbonite Employee
SimonXueCarbonite Employee
posted in Carbonite Endpoint API
Welcome to Carbonite Endpoint API forum

Hi, Carbonite Endpoint is pleased to open this API forum. We want to give our customers a place to discuss, ask questions and share ideas  on how they are using or plan to use the APIs. With Carbonite Endpoint, organizations can better protect valuable data on employee devices, mitigate data loss and data breach, and restore lost data quickly through best-in-class endpoint protection.The API documentations are here: Dashboard  service API:   https://support.carbonite.com/guides/Endpoint/API/EndpointDashboardServiceAPI.htmREST API:https://support.carbonite.com/guides/Endpoint/RestAPI/EndpointRestAPI.htmCarbonite  Endpoint is excited to have  you, and is looking forward to all the  discussions here.  Welcome!

1471
B
New Member
3 years ago
D
Carbonite Employee
dbeelzCarbonite Employee
posted in Carbonite Replication API
Welcome

 Thank you for checking out the Carbonite Replication API community. This space is designed to provide our customers with a place to ask questions about API usage, to share ideas or solutions for how they plan to implement the Replication APIs, and to get inspiration for their next project.Carbonite Replication – which includes Carbonite Migrate and Carbonite Availability – enables organizations to replicate Windows and Linux data, applications, and entire servers from any physical, virtual, or cloud-based environment to the same or different type of environment. This any-to-any data replication capability can be used to easily migrate or protect server workloads between on-premise data centers, from on-premise to cloud, from cloud to cloud, etc.You can find the Carbonite Replication API documentation here:PowerShell Guide:   https://download.doubletake.com/_download/Documentation/PowerShell/PowerShellScriptingGuide.htmREST API Guide:   https://download.doubletake.com/_download/Documen

760
D
Carbonite Employee
3 years ago

Badges

Show all badges

Join the Conversation

Terms & Conditions