repository()

Summary

A repository stores ingested data, configures parsers and data retention policies. The repository() GraphQL query returns information about a given repository.

API Stability Long-Term

Syntax

graphql

repository(
      name: String!, includeHidden: Boolean
   ): Repository!

Provide name (required) — the repository name. Select Show Repositories Query below for an example of how to list repository names. Set includeHidden to include hidden repositories. See the Input Parameters section for details.

Returns a non-nullable Repository object. See the Returned Values section for available fields.

Hide Query Example

Show Repositories Query

To get a list of repositories, use the repositories() query like this:

graphql

query {
     repositories
      { id, name }
   }

Example

Raw

graphql

query {
    repository(name: "humio", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}

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" : "query {
    repository(name: \"humio\", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}"
}
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" : "query {
    repository(name: \"humio\", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}"
}
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" : "query { ^
    repository(name: \"humio\", includeHidden: false) ^
  {name, id, type, dataType, dashboards { ^
    id, name, displayName ^
  } } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "query {
    repository(name: \"humio\", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}"
}'
    "$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 = "query {
    repository(name: \"humio\", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}";
$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" : "query {
    repository(name: \"humio\", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}"
}'''

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" : "query {
    repository(name: \"humio\", includeHidden: false)
  {name, id, type, dataType, dashboards {
    id, name, displayName
  } }
}"
}
);


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": {
    "repository": {
      "id": "abc123",
      "name": "humio",
      "dashboards": [
        {
          "id": "def456",
          "name": "Parsers",
          "displayName": "Parsers"
        },
        {
          "id": "ghi789",
          "name": "Request-Response",
          "displayName": "Request-Response"
        },
    ...
    }
  }
}

Input Parameters

Provide name (required) — the repository name. Set includeHidden to true to include a repository even if it is hidden in the UI.

Table: Input Parameters & Datatypes

Parameter	Type	Required	Default	Description
This table contains all input parameters for this query.
name	String!	yes		The name of the repository to query.
includeHidden	Boolean		true	Whether to include a repository in the results even if it is hidden in the UI.

Returned Values

Returns a non-nullable Repository object. The table below lists all fields:

Table: Repository Datatype

Parameter	Type	Required	Stability	Description
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results.
Table last updated: Jun 22, 2026
action(id: string): Action	multiple	yes	`Long-Term`	A saved action. The unique identifier of the action to get. Returns information on the action. See Action.
actions(actionIds: [string]): [Action]	multiple	yes	`Long-Term`	A list of saved actions. The result will only include actions for the specified identifiers. Omit to retrieve all actions. See Action.
aggregateAlert(id: string): AggregateAlert	multiple	yes	`Long-Term`	A saved aggregate alert. The unique identifier of the aggregate alert. See AggregateAlert.
aggregateAlerts	[AggregateAlert]	yes	`Long-Term`	A list of saved aggregate alerts. See AggregateAlert.
alert(id: string): Alert	multiple	yes	`Long-Term`	A saved alert. See Alert.
alerts	[Alert]	yes	`Long-Term`	Saved alerts. See Alert.
allowedViewActions	[ViewAction]	yes	`Long-Term`	Returns all actions the user is allowed to perform on the view. See ViewAction.
archivingConfiguration	ArchivingConfiguration		`Short-Term`	Any archiving configuration. This is a preview parameter and is subject to change. See ArchivingConfiguration.
archivingProvider	string		`Short-Term`	The archiving provider. This is a preview parameter and subject to change.
automaticSearch	boolean	yes	`Long-Term`	Whether to search automatically.
availablePackages(filter: string, tags: [PackageTag], categories: [string]): [PackageRegistrySearchResultItem]	multiple	yes	`Long-Term`	Returns a list of available packages that can be installed. PackageTag is a scalar. See PackageRegistrySearchResultItem for more on it.
awsExternalId	string	yes	`Long-Term`	The AWS External unique identifier used when assuming roles in AWS on behalf of this repository.
cachePolicy	CachePolicy		`Preview`	The cache policy set on the repository. This is a preview and subject to change. See CachePolicy.
compressedByteSize	long	yes	`Long-Term`	Total size of data, measured as the size after compression.
compressedByteSizeOfMerged	long	yes	`Long-Term`	Total size of data, merged parts. Size is measured as the size after compression.
currentTagGroupings	[TagGroupingRule]	yes	`Long-Term`	Tag grouping rules applied on the repository currently. Rules only apply to the tags they denote, and tags without rules do not have any grouping. See TagGroupingRule.
dashboard(id: string): Dashboard	multiple	yes	`Long-Term`	A saved dashboard. See Dashboard.
dashboards	[Dashboard]	yes	`Long-Term`	All dashboards available on the view. See Dashboard.
datasources	[Datasource]	yes	`Long-Term`	Data sources from where data is ingested: specific log files or services sending data to LogScale. See Datasource.
dataType	RepositoryDataType	yes	`Long-Term`	Repository data types are used for controlling the types of data are allowed in the repository. See RepositoryDataType.
defaultQuery	SavedQuery		`Long-Term`	The default saved query for the repository. See SavedQuery.
deletedDate	long		`Long-Term`	The point in time the search domain was marked for deletion.
description	string		`Long-Term`	A description of the repository.
effectiveCachePolicy	CachePolicy	yes	`Preview`	The effective cache policy that will apply to the repository, organization or global default, in order of precedence is: the repository cache policy, if set; the organization cache policy, if set; the global cache policy, if set; or the default cache policy in which no segments are prioritized. Cache policies are a limited feature and subject to change. See CachePolicy.
eventForwardersForSelection	[EventForwarderForSelection]	yes	`Long-Term`	List event forwarders in the organization with only basic information. See EventForwarderForSelection.
eventForwardingRules	[EventForwardingRule]	yes	`Long-Term`	The event forwarding rules configured for the repository. See EventForwardingRule.
fdrFeed(id: string): FdrFeed	multiple	yes	`Long-Term`	The unique identifier of the FDR feed to get. See FdrFeed.
fdrFeedControl(id: string): FdrFeedControl	multiple	yes	`Long-Term`	Administrator control for an FDR feed. Provide the identifier of the FDR feed the administrator is to control. The maxNodes is the maximum number of nodes with which to poll the FDR feed. This feature is a preview and is still being iterated; changes may occur. See FdrFeedControl.
fdrFeedControls	[FdrFeedControl]	yes	`Long-Term`	Administrator controls for FDR feeds. This feature is still being iterated; changes may occur. See FdrFeedControl.
fdrFeeds	[FdrFeed]	yes	`Long-Term`	Saved FDR feeds. See FdrFeed.
fileFieldSearch(fileName: string, fieldName: string, prefixFilter: string, valueFilters: [FileFieldFilterType], fieldsToInclude: [string], maxEntries: integer): [[DictionaryEntryType]]	multiple	yes	`Long-Term`	Searching fields in a file. See FileFieldFilterType and DictionaryEntryType.
files	[File]	yes	`Long-Term`	Any related files. See File.
filterAlert(id: string): FilterAlert	multiple	yes	`Long-Term`	A saved filter alert. See FilterAlert.
filterAlerts	[FilterAlert]	yes	`Long-Term`	Saved filter alerts. See FilterAlert.
gcsArchivingConfiguration	GCSArchivingConfiguration		`Short-Term`	GCS archiving configuration. This is a preview and subject to change. See GCSArchivingConfiguration.
groups	[Group]	yes	`Long-Term`	Groups with assigned roles. See Group.
hasPackageInstalled(packageId: VersionedPackageSpecifier): boolean	multiple	yes	`Long-Term`	Whether the repository has a given package installed. VersionedPackageSpecifier is a scalar.
id	string	yes	`Long-Term`	The unique identifier of the repository.
ingestBlock	datetime		`Long-Term`	The date and time in the future after which ingest for this repository will be re-enabled.
ingestFeed(id: string): IngestFeed	multiple	yes	`Long-Term`	A saved Ingest feed. See IngestFeed.
ingestFeeds(searchFilter: string, typeFilter: [IngestFeeds__Type], sortBy: IngestFeeds__SortBy, orderBy: OrderBy, skip: integer, limit: integer): IngestFeedQueryResultSet!	multiple	yes	`Long-Term`	Saved Ingest feeds. See IngestFeeds__Type, IngestFeeds__SortBy, OrderBy, and IngestFeedQueryResultSet.
ingestListeners	[IngestListener]	yes	`Long-Term`	The ingest listeners configured for this repository (see IngestListener).
ingestSizeBasedRetention	float		`Long-Term`	Retention in gigabytes, based on the size of data when it arrives at LogScale, before parsing and compression. LogScale will keep at most this amount of data.
ingestTokens	[IngestToken]	yes	`Long-Term`	The ingest token used for receiving data into the repository. See IngestToken.
installedPackages	[PackageInstallation]	yes	`Long-Term`	List packages installed on a specific view or repository. See PackageInstallation.
interactions	[ViewInteraction]	yes	`Long-Term`	All interactions defined on the view. See ViewInteraction.
isActionAllowed(action: ViewAction): boolean	multiple	yes	`Long-Term`	Check if the current user is allowed to perform the given action on the view. See ViewAction.
isStarred	boolean	yes	`Long-Term`	Whether the repository is marked with a star.
limit	LimitV2		`Long-Term`	This is the limit attached to the repository. See LimitV2.
maxAutoShardCount	integer		`Long-Term`	The maximum number of auto shards created.
name	RepoOrViewName	yes	`Long-Term`	The name of the repository. RepoOrViewName is a scalar.
packageV2(packageId: VersionedPackageSpecifier): Package2	multiple	yes	`Long-Term`	The returned package information for the specified package. VersionedPackageSpecifier is a scalar. See Package2.
packageVersions(packageId: UnversionedPackageSpecifier): [RegistryPackageVersionInfo]	multiple	yes	`Long-Term`	The available versions of a package. UnversionedPackageSpecifier is a scalar. See RegistryPackageVersionInfo.
parser(parserid: string, name: string): Parser	multiple		`Long-Term`	The parser for the repository. Give either the `parserid` or the `name`. See Parser.
parsers	[Parser]	yes	`Long-Term`	List of parsers used with the repository. See Parser.
permanentlyDeletedAt	long		`Long-Term`	The point in time the search domain will not be restorable.
persistedAggregations(sortBy: PersistedAggregationSortBy, orderBy: OrderBy, skip: integer, limit: integer): PersistedAggregationResultSet	multiple		`Preview`	List of persisted aggregations for repository, with sorting and pagination. See PersistedAggregationSortBy.
recentQueriesV2	[RecentQuery]	yes	`Long-Term`	Any recent queries. See RecentQuery.
redirectQueryAssetLookupTo	SearchDomain		`Preview`	The redirected query asset lookup view used for asset resolution when set. Assets like saved queries and lookup files will be resolved from this view instead of the current view. See SearchDomain.
reposExcludedInSearchLimit	[string]	yes	`Long-Term`	Repositories not part of the search limitation.
resource	string		`Short-Term`	The resource identifier for this search domain.
s3ArchivingArn	string		`Short-Term`	The ARN of the AWS IAM identity that will write to S3 for S3 archiving.
s3ArchivingConfiguration	S3Configuration		`Long-Term`	The configuration for S3 archiving (e.g., bucket name and region). See S3Configuration.
savedQueries	[SavedQuery]	yes	`Long-Term`	Saved queries. See SavedQuery.
savedQuery(id: string): SavedQuery	multiple	yes	`Long-Term`	A saved query. See SavedQuery.
scheduledReport(id: string): ScheduledReport	multiple	yes	`Long-Term`	Saved scheduled report. See ScheduledReport.
scheduledReports	[ScheduledReport]	yes	`Long-Term`	Saved scheduled reports. See ScheduledReport.
scheduledSearch(id: string): ScheduledSearch	multiple	yes	`Long-Term`	A saved scheduled search. See ScheduledSearch.
scheduledSearches	[ScheduledSearch]	yes	`Long-Term`	Saved scheduled searches. See ScheduledSearch.
searchLimitedMs	long		`Long-Term`	Search limit in milliseconds, to which searches should are limited.
secretHandle(id: string): SecretHandle	multiple	yes	`Preview`	A saved secret handle. See SecretHandle.
secretHandles(skip: integer, limit: integer): secretHandleQueryResultSet	multiple	yes	`Preview`	Saved secret handles. See secretHandleQueryResultSet.
starredFields	[string]	yes	`Long-Term`	A list of fields which are marked with a star in the repository.
storageSizeBasedRetention	float		`Long-Term`	Retention in gigabytes, based on the size of data when in storage, after parsing and compression. LogScale will keep at least this amount of data, but as close to this amount as possible.
tags	[string]	yes	`Long-Term`	All tags from all datasources.
timeBasedBackupRetention	float		`Long-Term`	Sets time in days to keep back-ups before they are deleted.
timeBasedRetention	float		`Long-Term`	The maximum time in days to keep data. Older date will be deleted.
timeOfLatestIngest	datetime		`Long-Term`	The timestamp of the latest ingested data, or null if the repository is empty.
type	RepositoryType	yes	`Long-Term`	Repository Types are used for tracking trial status in LogScale Cloud setups. See RepositoryType.
uncompressedByteSize	long	yes	`Long-Term`	Total size the data, measured as the size stored before compression and is thus the size of the internal format, not the data that was ingested.
uncompressedByteSizeOfMerged	long	yes	`Long-Term`	Total size the data, merged parts. Size is measured as the size stored before compression and is thus the size of the internal format, not the data that was ingested.
usageTag	string		`Long-Term`	The usage tag used to group usage summary on repositories.
users	[User]	yes	`Long-Term`	Users who have access to the repository. See User.
usersAndGroups(search: string, skip: integer, limit: integer): UsersAndGroupsSearchResultSet	multiple	yes	`Long-Term`	Users or groups who have access to the repository. See UsersAndGroupsSearchResultSet.
usersV2(search: string, permissionFilter: Permission, skip: integer, limit: integer): Users	multiple	yes	`Short-Term`	Used to search for a user based on search parameters and for a given permission. See Permission and Users.
viewerQueryPrefix	string	yes	`Long-Term`	The query prefix prepended to each search in this domain.

Versions of this Page

GraphQL Queries

GraphQL API

GraphQL Mutations

GraphQL Datatypes

repository()

Summary

Syntax

Example

Input Parameters

Returned Values

Enter search term

GraphQL Queries

GraphQL API

GraphQL Mutations

GraphQL Datatypes

repository()

Summary

Related

Syntax

Example

Input Parameters

Returned Values

Enter search term