updatePackageFromRegistryV2()

API Stability Long-Term

The updatePackageFromRegistryV2() GraphQL mutation field may be used to update a package in a specified view in LogScale.

For more information on packages, see the Package Management documentation page.

Syntax

graphql

updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: UpdatePackageFromRegistryInput!
   ): PackageUpdateResult!

Example

Below is an example of how this mutation field might be used:

Raw

graphql

mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: "humio",
       packageId: "humio/insights@0.0.14",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: "Errors",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: "Hosts",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}

Mac OS or Linux (curl)

shell

curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}"
}
EOF

Mac OS or Linux (curl) One-line

shell

curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}"
}
EOF

Windows Cmd and curl

shell

curl -v -X POST $YOUR_LOGSCALE_URL/graphql ^
    -H "Authorization: Bearer $TOKEN" ^
    -H "Content-Type: application/json" ^
    -d @'{"query" : "mutation { ^
  updatePackageFromRegistryV2( ^
     UpdatePackageFromRegistryInput:  ^
      {viewName: \"humio\", ^
       packageId: \"humio/insights@0.0.14\", ^
       conflictResolutions: [ { entityType: Dashboard,  ^
                                entityName: \"Errors\", ^
                                conflictResolution: Ours }, ^
                              { entityType: Dashboard,  ^
                                entityName: \"Hosts\", ^
                                conflictResolution: Ours }], ^
       queryOwnershipType: Organization ^
      } ^
  ) ^
  { package { id } } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}"
}'
    "$YOUR_LOGSCALE_URL/graphql"

Perl

perl

#!/usr/bin/perl

use HTTP::Request;
use LWP;

my $TOKEN = "TOKEN";

my $uri = '$YOUR_LOGSCALE_URL/graphql';

my $query = "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}";
$query =~ s/\n/ /g;
my $json = sprintf('{"query" : "%s"}',$query);
my $req = HTTP::Request->new("POST", $uri );

$req->header("Authorization" => "Bearer $TOKEN");
$req->header("Content-Type" => "application/json");

$req->content( $json );

my $lwp = LWP::UserAgent->new;

my $result = $lwp->request( $req );

print $result->{"_content"},"\n";

Python

python

#! /usr/local/bin/python3

import requests

url = '$YOUR_LOGSCALE_URL/graphql'
mydata = r'''{"query" : "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}"
}'''

resp = requests.post(url,
                     data = mydata,
                     headers = {
   "Authorization" : "Bearer $TOKEN",
   "Content-Type" : "application/json"
}
)

print(resp.text)

Node.js

javascript

const https = require('https');

const data = JSON.stringify(
    {"query" : "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { id } }
}"
}
);


const options = {
  hostname: '$YOUR_LOGSCALE_URL',
  path: 'graphql',
  port: 443,
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length,
    Authorization: 'BEARER ' + process.env.TOKEN,
    'User-Agent': 'Node',
  },
};

const req = https.request(options, (res) => {
  let data = '';
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', (d) => {
    data += d;
  });
  res.on('end', () => {
    console.log(JSON.parse(data).data);
  });
});

req.on('error', (error) => {
  console.error(error);
});

req.write(data);
req.end();

Example Responses

Success (HTTP Response Code 200 OK)

json

{
  "data": {
    "updatePackageFromRegistryV2": {
      "package": {
        "id": "humio/insights@0.0.14"
      }
    }
  }
}

Given Datatype

For the input datatype, you'll have to give the name of the view and the unique identifier of the package you want to update, and how to resolve conflicts. See the table below for more parameters and links to sub-parameters:

Table: UpdatePackageFromRegistryInput

Parameter	Type	Required	Default	Stability	Description
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Mar 28, 2025
conflictResolutions	[ConflictResolutionConfiguration]	yes		`Long-Term`	A list of resolutions to any conflicts encountered. See ConflictResolutionConfiguration.
packageId	VersionedPackageSpecifier	yes		`Long-Term`	The unique identifier for the package. VersionedPackageSpecifier is a scalar.
queryOwnershipType	QueryOwnershipType	yes	User	`Long-Term`	Ownership of the query run by this filter alert. If value is `User`, ownership will be based on the runAsUserId field. See QueryOwnershipType.
viewName	RepoOrViewName	yes		`Long-Term`	The name of the view related to the package. RepoOrViewName is a scalar.

Returned Datatype

This returned datatype, through sub-parameters, provides plenty information on the package, such as templates for its alerts, aggregate alerts, filter alerts, and actions. The table below has a link to the table containing these and other sub-parameters:

Table: PackageUpdateResult

Parameter	Type	Required	Stability	Description
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Sep 27, 2024
package	Package2	yes	`Long-Term`	The package that was updated. See Package2.

Versions of this Page

GraphQL Mutations

GraphQL API Stability

GraphQL Queries

GraphQL Datatypes