addActionLabels()

Larger operations often times have so many actions (e.g., webhook, PagerDuty) saved in their LogScale system that it becomes difficult to manage them. By adding labels to actions related to their purpose or areas of responsibility, an administrator can more easily review actions for proper coverage and other factors.

The addActionLabels() mutation is used to add labels to an action. There can be at most ten labels, with a maximum length of sixty characters per label. This mutation returns the updated action if successful — or null with errors, if not.

Adding labels doesn't replace or eliminate ones that are already saved. To remove labels from an action, use the removeActionLabels() mutation.

Hide Query Example

Show Action Labels Query

To get a list of all action labels for all repositories, use the entitiesLabels() query like this:

graphql

query {
     entitiesLabels {
       entityTypes: Action
     }
   }

To get a list of labels for each action, you could execute the repositories():

graphql

query {
     repositories {
       id, name, 
       action { labels }
     }
   }

To manage action labels through the UI, see the Manage Actions section of the main documentation.

Stability Level

Long-Term

Syntax

graphql

addActionLabels(
      input: AddActionLabels!
   ): Action

For the input, you have to give the name of the view or repository, and the unique identifier of the action to which you want to add labels (click on Show Query below). Last, you'll provide within brackets, a comma-separated list of labels.

For the return datatype for this mutation, you can get details on the action, including a list of labels for it. See the Returned Datatype section farther down this page.

Hide Query Example

Show Action Identifiers Query

To get a list of all actions for a repository, use the repository() query like this:

graphql

query {
     repository( name: "humio" )
        { actions { __typename, name, id } }
   }

With these results you can use an action's unique identifier to add labels to it.

Example

Raw

graphql

mutation {
  addActionLabels(
    input: { 
      viewName: "humio",
      id: "abc123",
      labels: [ "act-one",
                "morning-shift" ]
    }
  )
  { displayName, isAllowedToRun }
}

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 {
  addActionLabels(
    input: { 
      viewName: \"humio\",
      id: \"abc123\",
      labels: [ \"act-one\",
                \"morning-shift\" ]
    }
  )
  { displayName, isAllowedToRun }
}"
}
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 {
  addActionLabels(
    input: { 
      viewName: \"humio\",
      id: \"abc123\",
      labels: [ \"act-one\",
                \"morning-shift\" ]
    }
  )
  { displayName, isAllowedToRun }
}"
}
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 { ^
  addActionLabels( ^
    input: {  ^
      viewName: \"humio\", ^
      id: \"abc123\", ^
      labels: [ \"act-one\", ^
                \"morning-shift\" ] ^
    } ^
  ) ^
  { displayName, isAllowedToRun } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  addActionLabels(
    input: { 
      viewName: \"humio\",
      id: \"abc123\",
      labels: [ \"act-one\",
                \"morning-shift\" ]
    }
  )
  { displayName, isAllowedToRun }
}"
}'
    "$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 {
  addActionLabels(
    input: { 
      viewName: \"humio\",
      id: \"abc123\",
      labels: [ \"act-one\",
                \"morning-shift\" ]
    }
  )
  { displayName, isAllowedToRun }
}";
$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 {
  addActionLabels(
    input: { 
      viewName: \"humio\",
      id: \"abc123\",
      labels: [ \"act-one\",
                \"morning-shift\" ]
    }
  )
  { displayName, isAllowedToRun }
}"
}'''

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 {
  addActionLabels(
    input: { 
      viewName: \"humio\",
      id: \"abc123\",
      labels: [ \"act-one\",
                \"morning-shift\" ]
    }
  )
  { displayName, isAllowedToRun }
}"
}
);


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": {
    "addActionLabels": {
      "displayName": "First Action",
      "isAllowedToRun": true
    }
  }
}

Given Datatype

You'll have to give the view or repository name, and the unique identifier of the action to which you want to add labels — and a comma-separated list of labels to add, within brackets. Click on the Show Query link under the Syntax section above for an example of how to get the action identifiers.

Table: AddActionLabels

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: Nov 17, 2025
id	string	yes	`Long-Term`	The unique identifier of the action.
labels	[string]	yes	`Long-Term`	The labels for the action. There can be at most ten labels, each with a maximum length of sixty characters.
viewName	RepoOrViewName	yes	`Long-Term`	The name of the view or repository of the action. RepoOrViewName is a scalar.

Returned Datatype

With the returned datatype, you can get a list of allowed actions, when the action was created and modified last and by whom, and other items. Below is a list of the return parameters from which you can choose. Include the labels parameter so you can see the results of your addition, in case there's one you want to eliminate any or you forgot to add.

Table: Action

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 30, 2025
allowedActions	[AssetAction]	yes	`Short-Term`	A list of allowed asset actions. See AssetAction.
createdInfo	AssetCommitMetadata		`Long-Term`	Metadata related to the creation of the action. See AssetCommitMetadata.
displayName	string	yes	`Long-Term`	The display name of the action.
id	string	yes	`Long-Term`	The unique identifier of the action.
isAllowedToRun	boolean	yes	`Long-Term`	Whether the action is allowed to run. Should be false if this type of action is disabled because of a security policy.
labels	[string]	yes	`Preview`	Labels attached to the action.
modifiedInfo	AssetCommitMetadata		`Long-Term`	Metadata related to the latest modification of the action. See AssetCommitMetadata.
name	string	yes	`Long-Term`	The name of the action.
package	PackageInstallation		`Long-Term`	The package, if any, of which the action is part. See PackageInstallation.
packageId	VersionedPackageSpecifier		`Long-Term`	The unique identifier of the package. See VersionedPackageSpecifier.
requiresOrganizationOwnedQueriesPermissionToEdit	boolean	yes	`Long-Term`	This should be set to true if this action is used by triggers, where the query is run by the organization. If true, then the OrganizationOwnedQueries permission is required to edit the action.
resource	string	yes	`Short-Term`	The resource identifier for the action.
yamlTemplate	YAML	yes	`Long-Term`	A template that can be used to recreate the action. YAML is a scalar.

Versions of this Page

GraphQL Mutations

GraphQL API Stability

GraphQL Queries

GraphQL Datatypes