@grepr/cli 1.13.0-2632478 → 1.14.3-a181b29

package/build/dist/docs-index/5f394045-3f04-4ee2-8b0e-57cc021bbaf2.txt

@@ -1,47 +0,0 @@
-# Mark a comment as guidance
-
-**PATCH** `/v1/issues/{idOrNumber}/comments/{commentId}`
-
-**Operation ID**: `setCommentGuidance`
-**Summary**: Mark a comment as guidance
-Makes a person's comment guidance, advice agents weigh, or stops it being guidance. People only; an agent's comment can never be guidance.
-
-## Tags
-- Issues
-## Parameters
-
-- **idOrNumber** (required) - path
-  - Type: string
-- **commentId** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `SetCommentGuidanceRequest`
-
-## Responses
-
-### 200
-
-Comment updated
-
-- **Content-Type**: `application/json` / `IssueComment`
-### 400
-
-The comment is an agent's
-
-- **Content-Type**: `application/json` / `IssueErrorResponse`
-### 401
-
-Unauthorized
-
-### 403
-
-Not a person, or no permission to edit the issue
-
-- **Content-Type**: `application/json` / `IssueErrorResponse`
-### 404
-
-Issue or comment not found

package/build/dist/docs-index/6031fc88-d953-4a76-8c09-261bc33e70b7.json

@@ -1 +0,0 @@
-{"docType":"api"}

package/build/dist/docs-index/6031fc88-d953-4a76-8c09-261bc33e70b7.txt

@@ -1,29 +0,0 @@
-# Get a Datadog integration with exceptions
-
-**GET** `/v1/integrations/datadog/{id}/with-exceptions`
-
-**Operation ID**: `getDatadogIntegrationWithExceptions`
-**Summary**: Get a Datadog integration with exceptions
-Get an integration to connect to Datadog with vendor imported exceptions populated.
-
-## Tags
-- Datadog Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 200
-
-Integration retrieved successfully with exceptions
-
-- **Content-Type**: `application/json` / `ReadDatadog`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/6072371e-98e8-4d16-a924-a32560e49c2f.json

@@ -1 +0,0 @@
-{"docType":"schema"}

package/build/dist/docs-index/6072371e-98e8-4d16-a924-a32560e49c2f.txt

@@ -1,14 +0,0 @@
-# CreateSkillRequest
-
-**Type**: `object`
-
-## Properties
-
-- name: displayName (required)
-  type: string
-
-- name: files (required)
-  type: array of `SkillFile`
-
-- name: toolIds (required)
-  type: array of string

package/build/dist/docs-index/60b3f7f6-4428-4be5-8695-7979eb2fb87e.json

@@ -1 +0,0 @@
-{"docType":"api"}

package/build/dist/docs-index/60b3f7f6-4428-4be5-8695-7979eb2fb87e.txt

@@ -1,24 +0,0 @@
-# Delete a GitHub MCP integration
-
-**DELETE** `/v1/integrations/github-mcp/{id}`
-
-**Operation ID**: `delete_8`
-**Summary**: Delete a GitHub MCP integration
-Deletes a GitHub MCP integration. This will delete the associated token as well. No-op if already deleted.
-
-## Tags
-- GitHub MCP Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 204
-
-Integration deleted successfully
-
-### 401
-
-Unauthorized

package/build/dist/docs-index/60dd39b0-7347-4cab-a0fc-a86e70d0d709.json

@@ -1 +0,0 @@
-{"docType":"schema"}

package/build/dist/docs-index/60dd39b0-7347-4cab-a0fc-a86e70d0d709.txt

@@ -1,8 +0,0 @@
-# ItemsCollectionReadS3DataWarehouse
-
-**Type**: `object`
-
-## Properties
-
-- name: items (optional)
-  type: array of `ReadS3DataWarehouse`

package/build/dist/docs-index/60dda800-37b2-46db-9c2b-48ace840c39f.json

@@ -1 +0,0 @@
-{"docType":"doc"}

package/build/dist/docs-index/60dda800-37b2-46db-9c2b-48ace840c39f.txt

@@ -1,248 +0,0 @@
-Learn how to configure how Grepr integrates with observability platforms and storage systems to support data ingestion, processing, and output in your pipelines.
-
-# Configure how Grepr integrates with observability platforms and cloud storage
-
-To support data ingestion and data output for your Grepr pipelines, you connect Grepr to external observability platforms and storage systems. To support these connections, the Grepr platform uses *integrations*. A Grepr integration provides the configuration details to connect to an external system, enabling data exchange between Grepr and that system.
-
-After configuring an integration, you can use it in your Grepr pipelines to create *sources* to ingest data from agents and collectors, such as FluentD or the OpenTelemetry collector, and *sinks* to send data to an observability platform or storage.
-
-You can use the Grepr UI or the REST API to create and manage integrations. To use the UI, see [Manage integrations in the Grepr UI](#manage-integrations-in-ui). To use the API, see the documentation for each [supported integration](#supported-integrations).
-
-## Integration types
-
-The Grepr platform includes the following integration types:
-
-* Observability platform integrations: Connections to monitoring, logging, and APM platforms, such as Datadog, Splunk, New Relic, and Sumo Logic.
-* Cloud storage integrations: Connections to cloud storage. The Grepr data lake uses cloud storage to store your raw data and metadata.
-* AI integrations: Connections that Grepr AI agents use, covering the model providers they reason with, the MCP servers they call, the webhook endpoints that trigger them, and the vector indexes that store their memories. See [Supported AI integrations](#ai-integrations).
-
-Observability platform and cloud storage integrations become the sources and sinks of your pipelines. AI integrations are used by AI agents instead, so they are not selectable as a pipeline source or sink.
-
-## Supported platform and storage integrations \[#supported-integrations]
-
-The Grepr platform includes the following integrations. For details on configuring and using an integration, refer to the linked documentation page. For a complete list of supported integrations, supported functionality, and details on vendor-specific capabilities with some integrations, see [Grepr supported vendor and storage integrations](/integrations/support-matrix).
-
-### Datadog
-
-The Datadog integration connects to the Datadog observability platform and supports sourcing data from several Datadog-compatible collectors and sending processed data to Datadog.
-
-See [Configure Datadog connections with a Grepr integration](/integrations/datadog).
-
-### New Relic
-
-The New Relic integration connects to New Relic's observability platform. Use this integration to create sources that retrieve log data from New Relic collectors and sinks that send processed data to New Relic for monitoring and analysis.
-
-See [Configure New Relic connections with a Grepr integration](/integrations/new-relic).
-
-### Splunk
-
-The Splunk integration provides connectivity to Splunk through Splunk's HTTP Event Collector (HEC) or S2S over HTTP. This integration supports reading data from Splunk collectors and writing data to Splunk indexes.
-
-See [Configure Splunk connections with a Grepr integration](/integrations/splunk).
-
-### Sumo Logic
-
-The Sumo Logic integration connects to Sumo Logic's cloud-based log management and monitoring platform using a Sumo Logic HTTP Source. You can use the integration to create sources that ingest data from Sumo Logic collectors and sinks that send processed data to Sumo Logic.
-
-See [Configure Sumo Logic connections with a Grepr integration](/integrations/sumo-logic).
-
-### OpenTelemetry
-
-The Grepr OpenTelemetry integration lets you ingest logs and Application Performance Monitoring (APM) data into Grepr from a collector that supports the OpenTelemetry Protocol over HTTP, or OTLP/HTTP, process them with a Grepr pipeline, and then send the processed data to any observability vendor that accepts OTLP/HTTP requests.
-
-See [Configure connections to OpenTelemetry compatible platforms](/integrations/open-telemetry).
-
-### Grafana Cloud
-
-You can configure Grepr's OpenTelemetry integration to connect with Grafana Cloud using the OpenTelemetry Protocol (OTLP). Use an OpenTelemetry integration to create sources that ingest data from OTLP-compatible collectors and sinks that send processed log data to Grafana Cloud.
-
-See [Configure Grafana Cloud connections with a Grepr integration](/integrations/grafana).
-
-### Amazon CloudWatch
-
-You can configure Grepr's OpenTelemetry integration to connect with Amazon CloudWatch using the OpenTelemetry Protocol (OTLP). Use an OpenTelemetry integration to create sources that ingest data from OTLP-compatible collectors and sinks that send processed log data to a CloudWatch log group.
-
-See [Configure Amazon CloudWatch connections with a Grepr integration](/integrations/cloudwatch).
-
-### Google Cloud Platform (GCP)
-
-The GCP integration as a source enables you to stream logs from Google Cloud services to Grepr for processing and analysis, and then forward the processed logs to any sink created using a Grepr-supported integration, such as Datadog, Splunk, or New Relic.
-
-See [Google Cloud Platform observability with Grepr](/integrations/gcp).
-
-### Cloud storage
-
-The Grepr data lake uses Amazon S3 to store, manage, and support querying the raw data from your Grepr pipelines. Depending on your requirements, you can choose from two S3 integrations: a Grepr-hosted integration, which uses a Grepr-managed S3 bucket, and an integration that uses an S3 bucket in your account. Both integrations provide secure, managed, and efficient storage for your data, along with an optimized query interface.
-
-To configure the Grepr-hosted integration, you only need to assign a name to the integration. The Grepr platform manages the S3 bucket, including its deployment and configuration.
-
-Using the integration with your own S3 bucket requires that you deploy and configure an S3 bucket in your AWS account, but it provides more control over your data. See [Host a Grepr data lake with the Amazon S3 integration](/integrations/aws-s3).
-
-## Supported AI integrations \[#ai-integrations]
-
-The following integrations support Grepr AI agents. They appear on the **Integrations** page only when AI agents are enabled for your organization. To turn on AI agents, contact <support@grepr.ai>. To learn what AI agents do, see [_](/ai-agents).
-
-### LLM providers
-
-An LLM integration holds the credentials for a large language model provider. Grepr AI agents use generative models for reasoning and embedding models for memories.
-
-See [_](/integrations/llm).
-
-### MCP servers
-
-An MCP integration connects Grepr to a MCP server run by another system, so an agent can call that system's tools during an investigation. You set each integration's server URL, so you can point one at a self-hosted or regional endpoint.
-
-See [_](/integrations/mcp).
-
-### Grepr Agent webhooks
-
-A Grepr Agent integration is a webhook endpoint that turns events from another system, such as an alerting platform or a Kubernetes event forwarder, into AI agent investigations.
-
-See [_](/integrations/grepr-agent-webhooks).
-
-### Vector indexes
-
-A vector index integration stores the search index for agent memory, which is what lets an agent find past investigations that reached a similar conclusion. You create one in the **S3 Vector Index** section of the **Integrations** page.
-
-See [_](/ai-agents/memory#vector-index).
-
-## Manage integrations in the Grepr UI \[#manage-integrations-in-ui]
-
-The **Integrations** page displays your integrations as cards, organized by observability vendor integrations and storage integrations. In each section, cards are ordered by recent activity, with the most active integrations appearing first.
-
-In addition to the integration name and its type, for example, a Datadog integration, if the integration is assigned to one or more teams, the team names appear in the header of the card.
-
-You can get a visual overview of the health and usage of your integrations using the charts included on each integration card. If an integration has recent activity, such as requests received from agents by a vendor integration or the amount of data written to a storage integration, a time-series chart of that activity is shown on the card.
-
-* Observability vendor integrations display requests received from agents over the last 30 minutes, color-coded by HTTP status code.
-
-  * To view more detailed metrics or more details about a pipeline that uses the integration, select it from the **Pipelines** menu.
-
-* Storage integrations display data written to the integration over the last 24 hours, broken down by dataset.
-
-  * To view and query a dataset stored on a storage integration, select it from the **Datasets** menu.
-
-To view more details about the metrics in either chart type, hover over any point in the chart to see a tooltip with the value and timestamp for that point.
-
-### Add an integration
-
-To create an integration, click **Add new** next to the section heading for the type you want to add. To learn how to create and configure specific integrations, see the documentation for each [supported integration](#supported-integrations).
-
-### Edit an integration
-
-To edit an integration, click the three-dot menu on the integration card and select **Edit**. Update the fields in the dialog and click **Save**.
-
-### Delete an integration
-
-To delete an integration, click the three-dot menu on the integration card and select **Delete**. Confirm the deletion in the dialog that appears.
-
-### Identify log events that should bypass aggregation \[#passthrough-estimation]
-
-When you create an integration with an observability vendor that supports *exception parsing*, Grepr automatically parses queries used by monitors, dashboards, or alerts in your observability vendor platform. You can use this list of queries to identify log messages that should be treated as *exceptions* to log reduction in Grepr pipelines. In other words, messages that should bypass aggregation to ensure that critical alerts and dashboards continue to work as expected. To help with identifying exceptions, the Grepr UI displays a *passthrough percentage* estimate for each query. This estimate is the percentage of events, over a configurable time window, that would bypass aggregation.
-
-You can also choose to automatically add and remove exceptions by enabling **Auto-sync exceptions** when you add the integration to your pipelines. To learn more about enabling and using auto-sync when you create or edit a pipeline, see [Prevent aggregation of messages used in your observability platform](/transforms/reducer/exceptions#vendor-exceptions).
-
-If an integration does not support exception parsing, the **Parsed Alerts** button on the integration card is disabled. See [Supported integrations: observability platforms](/integrations/support-matrix#supported-observability-integrations).
-
-To view the log queries parsed from an integration and configure passthrough estimation:
-
-1. On the **Integrations** page, on the card for a vendor integration that supports query parsing, click **Parsed Alerts**.
-
-   The **Parsed alert queries** dialog displays a table with the following columns:
-
-   * **Id**: The unique identifier for this alert.
-   * **Name**: The alert or dashboard name from your vendor.
-   * **Exception Type**: The type of vendor resource the query came from, such as a monitor or dashboard widget.
-   * **Query**: The log query extracted from the alert or dashboard.
-   * **Passthrough %**: The percentage of raw logs in your configured dataset that match this query. This value is displayed only if you've configured passthrough estimation.
-   * **Last Updated**: When the passthrough percentage was last calculated. Hover over the value to see the exact date and time.
-
-   You can filter the table by name or query text and filter by exception type using the multi-select filter in the **Exception Type** column. To manage which columns are visible, click the **Manage columns** icon in the upper-right corner of the table.
-
-2. To configure passthrough estimation and view the percentage of logs that would bypass aggregation for each query, click **Configure Passthrough Estimation**.
-
-   The **Passthrough Estimation Configuration** dialog lists the datasets that pipelines using the integration write to. Each row shows whether passthrough estimation is configured for that dataset and which pipelines use it.
-
-   > When you configure passthrough estimation for a dataset, it applies to all integrations or pipelines that use that dataset as a sink.
-
-3. Expand the row for the dataset you want to configure.
-
-4. Under **Filter Query (Optional)**, select your preferred query syntax and enter a query to filter for logs to include in the estimation analysis. Use this field when your dataset contains logs from multiple sources, and you want Grepr to use only the logs relevant to this integration. Leave this field empty to include all logs in the dataset.
-
-5. In the **Lookback Duration** menu, select the time window for calculating percentages. Options range from 15 minutes to 24 hours. A shorter window scans less data, reducing costs, but may not be representative if your log patterns vary throughout the day. A longer window provides more representative results but increases the cost of the analysis queries.
-
-6. In the **Refresh Period** menu, select how often Grepr recomputes each estimation for this dataset. Options range from 1 hour to 30 days, with a default of 7 days. A shorter period uses more recent logs to calculate estimates, resulting in more up-to-date values, but increases query load on the data lake.
-
-7. In the **Log Limit** field, enter the maximum number of logs to scan per estimation run. The default is 10,000,000. Larger limits provide more representative results, but increase the cost of each estimation query.
-
-8. To save a new configuration, click **Enable**. To save edits to an existing configuration, click **Save changes**.
-
-Grepr's impact estimation cycle runs once an hour for any datasets due for refresh, based on each dataset's **Refresh Period**. New or recently changed queries are included in the next cycle. A first estimate typically appears within an hour, though it might take longer if a large number of queries are queued for processing.
-
-To stop estimating for a dataset, expand its row and click **Disable estimation**. The dataset remains in the list as **Not configured** so you can re-enable estimation later.
-
-### Interpret passthrough percentages
-
-> Although two queries might use the same log events, their estimates will be equal. Additionally, the passthrough rate remains constant and is not the sum of the estimates. For example, if you enable exceptions for two queries that use the same log events, the passthrough rate doesn't double, but remains equal to the rate when only one exception is enabled.
-
-The **Passthrough %** value for a query shows what fraction of your raw logs that alert would require to pass through without aggregation. Use these values to evaluate the impact of adding each alert as a pipeline exception:
-
-A percentage less than 1% is considered low, and an exception should have minimal impact on aggregation efficiency and storage.
-
-You should review carefully any percentage above 1% before creating an exception for the query.
-
-A dash (—) in the **Passthrough %** column indicates that no estimate is available yet, either because passthrough estimation is not configured, or because Grepr hasn't finished calculating the estimate. If passthrough estimation is configured, the first estimate typically appears within an hour, and later refreshes occur based on the dataset's **Refresh Period**.
-
-The **Passthrough Estimation Configuration** dialog also includes the **Recent Activity** table at the bottom. This section shows the most recent log events related to exception parsing, giving you visibility into recent integration activity without leaving the dialog. To view the complete log history for the integration, click **View all logs** to go to the **System Logs** page, pre-filtered to show all activity for the selected integration.
-
-### Configure passthrough estimation from a pipeline
-
-You can also configure passthrough estimation directly from a pipeline. On the pipeline details page, in the left-hand navigation menu, click **Exceptions**. In the **Actions** column for an **Avoid impacting dashboards/alerts** exception, click the **⋯** menu and select **Configure estimations** to open a dialog that includes all datasets configured as sinks for the pipeline. Any configuration changes you make to the dataset apply to every other integration or pipeline that populates that dataset.
-
-To have Grepr recompute impact percentages during the next impact estimation cycle, click the **⋯** menu and select **Reset estimations** to clear the cached impact percentages for the datasets configured as sinks for the pipeline. Use this when you've changed alert queries in your observability vendor and want updated estimates without waiting for the next scheduled refresh.
-
-## Limitations \[#limitations]
-
-Grepr might split log events over 900KB, causing them to lose their original structured format. Each split event includes a common `grepr.splitOriginId` attribute if you need to reconstruct the original message.
-
-## Frequently Asked Questions
-
-### What is a Grepr integration?
-
-A Grepr integration provides the configuration details needed to connect Grepr to an external system, such as an observability platform or cloud storage. Integrations enable data exchange between Grepr and external systems, allowing you to create sources for data ingestion and sinks for data output in your pipelines.
-
-### What types of integrations does Grepr support?
-
-Grepr supports two integration types: observability platform integrations (connections to monitoring, logging, and APM platforms like Datadog, Splunk, New Relic, and Sumo Logic) and cloud storage integrations (connections to cloud storage for the Grepr data lake).
-
-### What is a source in a Grepr pipeline?
-
-A source in a Grepr pipeline is an operator that ingests data from an external system or agent. Sources use integrations to connect to observability platforms or collectors like FluentD or OpenTelemetry to pull data into Grepr for processing.
-
-### What is a sink in a Grepr pipeline?
-
-A sink in a Grepr pipeline is an operator that outputs processed data to an external system. Sinks use integrations to send Grepr-processed logs to observability platforms, data lakes, or other storage systems based on your pipeline configuration.
-
-### Can I use multiple integrations in a single pipeline?
-
-Yes, you can configure pipelines with multiple sources to ingest data from different platforms and multiple sinks to send processed data to different destinations. This flexibility allows you to build complex multi-source, multi-destination data processing workflows.
-
-### Which observability platforms does Grepr support?
-
-Grepr supports integrations with Datadog, Splunk, New Relic, Sumo Logic, Grafana Cloud, and Google Cloud Platform (GCP). Each integration enables different source and sink capabilities depending on the platform's features and capabilities.
-
-### How do I configure a Grepr integration?
-
-To configure an integration, you need to provide connection details specific to your external system, such as API keys, tokens, endpoints, or credentials. The specific steps vary by integration type. Detailed instructions for each integration are available in the platform-specific documentation pages.
-
-### What is the Grepr data lake integration?
-
-The Grepr data lake uses Amazon S3 to store raw log data. You can configure either a Grepr-hosted integration (using a Grepr-managed S3 bucket) where you only provide a name, or an integration with your own AWS account (requiring you to configure and manage the S3 bucket yourself for more control).
-
-### What happens to logs older than 48 hours from external sources?
-
-Grepr might drop incoming data from external integration sources with timestamps older than 48 hours. This limitation helps optimize storage and processing while allowing you to retain raw logs in the data lake for longer-term analysis.
-
-### What happens when a log event is larger than 900KB?
-
-If a log event exceeds 900KB, Grepr might split it into smaller events, which can cause them to lose their original structured format. Each split event includes a common 'grepr.splitOriginId' attribute that you can use to reconstruct the original message from its component parts.

package/build/dist/docs-index/60fef5f6-9cb3-45b0-a462-25690870a4c3.json

@@ -1 +0,0 @@
-{"docType":"schema"}

package/build/dist/docs-index/60fef5f6-9cb3-45b0-a462-25690870a4c3.txt

@@ -1,32 +0,0 @@
-# DatasetEstimationConfig
-
-**Type**: `object`
-
-## Properties
-
-- name: createdAt (optional)
-  type: string
-
-- name: datasetId (optional)
-  type: string
-
-- name: logLimit (required)
-  type: integer
-  description: Maximum number of log messages to scan per estimation run.
-
-- name: lookbackDuration (required)
-  type: string
-  description: Time window of data to scan per estimation run. ISO-8601 duration format.
-
-- name: organizationId (optional)
-  type: string
-
-- name: query (optional)
-  type: `EventPredicate`
-
-- name: refreshPeriod (required)
-  type: string
-  description: How often to recalculate impact percentages. ISO-8601 duration format.
-
-- name: updatedAt (optional)
-  type: string

package/build/dist/docs-index/6116859e-243b-44c0-8de6-e2ba1e19acb8.json

@@ -1 +0,0 @@
-{"docType":"schema"}

package/build/dist/docs-index/6116859e-243b-44c0-8de6-e2ba1e19acb8.txt

@@ -1,22 +0,0 @@
-# AttributeRemappingRule
-
-List of attribute-to-attribute remapping rules. Each rule moves the value from a source attribute path to a target attribute path, removing the source unless the rule's preserveSource flag is set. An optional predicate filter controls when each rule is applied.
-
-**Type**: `object`
-
-## Properties
-
-- name: predicate (optional)
-  type: `EventPredicate`
-
-- name: preserveSource (optional)
-  type: boolean
-  description: When true, the source attribute is preserved (copied) instead of being removed (moved). Defaults to false (source is removed after remapping).
-
-- name: source (required)
-  type: one of: string, array of string
-  description: Source attribute path: a dotted string ("resource.service" is resource → service), or an array of literal keys (["http", "user.agent"]).
-
-- name: target (required)
-  type: one of: string, array of string
-  description: Target attribute path: a dotted string, or an array of literal keys.

package/build/dist/docs-index/6189706b-f883-4521-9cf7-cb1af4b09065.json

@@ -1 +0,0 @@
-{"docType":"api"}

package/build/dist/docs-index/6189706b-f883-4521-9cf7-cb1af4b09065.txt

@@ -1,29 +0,0 @@
-# List the user's chats
-
-**GET** `/v1/chats`
-
-**Operation ID**: `list_1`
-**Summary**: List the user's chats
-Returns one page of the authenticated user's chats within their org, most-recently-updated first. Metadata only (id, title, timestamps); turn content is read per-chat. Page backwards with the response's nextCursor.
-
-## Tags
-- Chats
-## Parameters
-
-- **cursor** (optional) - query
-  - Opaque cursor from a previous page's nextCursor; omit for the first page.
-  - Type: string
-- **pageSize** (optional) - query
-  - Requested page size (1–100); defaults to 20.
-  - Type: integer
-
-## Responses
-
-### 200
-
-Chats retrieved successfully
-
-- **Content-Type**: `application/json` / `ChatList`
-### 401
-
-Unauthorized

package/build/dist/docs-index/618d4f45-f06c-4ff1-9e8f-f902f335dc50.json

@@ -1 +0,0 @@
-{"docType":"doc"}

package/build/dist/docs-index/618d4f45-f06c-4ff1-9e8f-f902f335dc50.txt

@@ -1,153 +0,0 @@
-Learn how to manage your Grepr users with the user management UI.
-
-# Manage users in the Grepr platform
-
-The administrative features in the Grepr platform support managing users in your organization, including viewing users, editing users' and roles' permissions, and removing users. This page describes the user management features available in the Grepr UI, including how to access those features and perform common user management tasks.
-
-You also have full control of users' access to Grepr features by assigning users to roles. You can use built-in organization-level roles, such as Admin, Member, and Reader, or create custom roles with specific permissions.
-
-You can organize users into teams that you create in the user management UI. To learn more about the team features and how to manage teams, see [Manage teams in the Grepr platform](/admin/manage-teams).
-
-You can manage users and roles in the Grepr UI or the REST API. This page describes how to manage users in the UI. To use the API, see the [Users specification](/apis/api-spec#tag/Users) and the [Roles specification](/apis/api-spec#tag/Roles).
-
-> You must have the `view:users` permission to access the user management UI. This permission is granted to organization Admins and team Leaders.
-
-## User roles in the Grepr platform
-
-The Grepr platform includes three built-in organization-level roles:
-
-* Admin: Admins have full access to all organization resources and settings, including user management features.
-* Member: Members have access to view resources, users, and teams, run backfill jobs, and query logs. Members cannot manage users, organization settings, or resources such as integrations or jobs.
-* Reader: Readers have view-only access to all resources and can query logs, but cannot create or edit any resources and cannot run backfill jobs that send data to a vendor integration.
-
-For details on the permissions for these roles, see [Permissions in the Grepr platform](/grepr-platform/permissions).
-
-To learn how to create custom roles with specific permissions, see [Custom roles](#create-custom-roles).
-
-## Access user management features in the UI
-
-To manage users in the Grepr UI:
-
-1. Sign in to the Grepr UI and click your profile icon in the top bar.
-2. In the menu, select **User Management**.
-3. On the **User Management** page, click **Users** in the left pane to display the **Users** pane with a list of all users and information about each user, such as the user's name, email address, role, and teams.
-
-The following sections describe how to perform user management tasks in the UI.
-
-## Add users by invitation
-
-Users are added to your organization when they respond to an emailed *invitation*. To invite a new user:
-
-1. In the **Users** pane, click **Invite new users**.
-
-2. In the **Invite users** dialog:
-
-   * In the **Invite Emails** field, enter one or more email addresses for the users to invite.
-
-   * (Optional) In the **Roles (Optional)** field, select the roles to assign to the invited users.
-
-   * (Optional) To assign a user to one or more teams, click **Add Team Assignment**.
-
-     * In the **Teams** menu, select the team to assign.
-     * In the **Role** menu, select the team role to assign.
-     * To add multiple teams, click **Add Team Assignment** again.
-
-3. Click **Send**.
-
-The **Invitations** table shows information for all pending invitations. From the table, you can delete pending invitations if they're no longer needed. Invitations automatically expire after a set period.
-
-## Edit users
-
-To edit a user's name, email, or roles:
-
-1. In the **Users** pane, find the user you want to edit in the **Users** table.
-2. Click the three-dot menu in the **Actions** column for that user.
-3. Select **Edit**.
-4. In the **Edit User** dialog, update the user's information and click **Save**.
-
-## Remove users
-
-To remove a user:
-
-1. In the **Users** pane, find the user you want to remove in the Users table.
-2. Click the three-dot menu in the **Actions** column for that user.
-3. Select **Delete**.
-4. In the **Confirm Delete** dialog, click **Delete**.
-
-The user is removed from your organization, and their access is revoked.
-
-## Custom roles \[#create-custom-roles]
-
-If you need more control over access than the Admin, Member, and Reader roles provide, you can create custom roles. Custom roles let you define specific permissions for different resources. You can select specific resources for access control, such as jobs, users, teams, integrations, templates, or datasets, and assign only required permissions, such as view, edit, write, create, delete, or all, on those resources.
-
-### Create custom roles
-
-To create a custom role in the UI:
-
-1. On the **User Management** page, click **Roles** in the left pane to display the **Roles** pane.
-
-2. Click **+ Create**.
-
-3. In the **Create Custom Role** dialog:
-
-   * Enter a **Role Name**.
-   * (Optional) Enter a **Description** for the role.
-   * In the **Permissions** section, select the required permissions for each resource.
-
-4. Click **Create Role**.
-
-## User and role management best practices
-
-### Role management
-
-* Use custom roles only if the existing Admin, Member, and Reader roles don't meet your access requirements.
-* Document custom roles by including a role description that clearly explains the permissions it grants.
-* Follow the principle of least privilege and grant users only the access they need.
-* Use clear and descriptive names when you create custom roles.
-
-### Invitations
-
-* To streamline onboarding, when you create an invitation, include team assignments in the invitation.
-* Regularly review and delete old, unaccepted invitations.
-
-## Frequently Asked Questions
-
-### What are the built-in roles in Grepr and what can each role do?
-
-Grepr has three built-in organization-level roles: Admin (full access to all resources and settings including user management), Member (can view resources, users, teams, run backfill jobs, and query logs but cannot manage users or create/edit resources), and Reader (view-only access and log queries; cannot create or edit resources, and cannot run backfill jobs to vendor integrations). These can be supplemented with custom roles for fine-grained access control.
-
-### How do I invite multiple users at once?
-
-In the Invite users dialog, enter multiple email addresses in the Invite Emails field separated by line breaks. You can also optionally assign roles and team memberships to all invited users before sending the invitations.
-
-### Can I assign users to teams during the invitation process?
-
-Yes, when creating an invitation, you can click 'Add Team Assignment' to assign invited users to specific teams with their desired team role (Leader or Member) before they even accept the invitation.
-
-### How long are user invitations valid?
-
-Invitations automatically expire after a set period. You should regularly review the Invitations table and delete old, unaccepted invitations to keep your organization clean.
-
-### What information can I edit about a user?
-
-You can edit a user's name, email address, and roles. You can also modify their organization-level roles and team assignments through the Edit User dialog.
-
-### How do I create a custom role with specific permissions?
-
-Click on the Roles tab in the User Management page, then click '+ Create'. In the Create Custom Role dialog, enter a role name and description, then select the specific permissions needed for each resource type (jobs, users, integrations, etc.).
-
-### Can I edit a custom role after creating it?
-
-Yes, you can edit custom roles to change the permissions they grant. Any changes to a custom role automatically apply to all users assigned to that role.
-
-### What happens when I remove a user from the organization?
-
-Removing a user revokes all their access to the organization. They lose access to all organization-level resources and all team-scoped resources immediately.
-
-### Should I use custom roles or the built-in Admin, Member, and Reader roles?
-
-Use the built-in Admin, Member, and Reader roles when they meet your access requirements. Only create custom roles when you need access control that the built-in roles don't provide, such as read-only access to a specific subset of resources.
-
-### How do I manage user access at scale?
-
-For large organizations, combine organization-level roles with team-based access control. Use teams to scope access to resources, custom roles for fine-grained permissions, and follow the principle of least privilege when assigning access.

package/build/dist/docs-index/61960083-64aa-4ecc-b125-4a59e14e41a4.json

@@ -1 +0,0 @@
-{"docType":"schema"}