Automate Grepr processing with the Grepr REST APIs
The Grepr REST APIs provide programmatic access to create and manage data processing jobs, configure authentication, control rule engines, and monitor job lifecycles. These APIs enable you to automate observability pipelines, integrate Grepr into existing workflows, and build custom applications that process log data at scale. All APIs follow REST conventions, return JSON responses, and require HTTPS authentication.
For documentation of the endpoints in the Grepr REST API, see the OpenAPI 3.0 specification.
Authenticate to Grepr REST APIs
Learn how to obtain and use access tokens for Grepr API authentication. This page covers the OAuth 2.0 client credentials flow using Auth0, including how to request credentials from Grepr support, obtain access tokens, and include Bearer tokens in API requests. The authentication system uses organization-specific client IDs and secrets to generate time-limited access tokens that provide access to all Grepr APIs.
See Authenticate to Grepr REST APIs.
Create and manage Grepr jobs
Comprehensive guide for creating and managing Grepr processing jobs through the REST API. This page covers both synchronous and asynchronous job execution modes, batch and streaming processing types, and how to construct job graphs with vertices and edges. Learn how to submit jobs, poll for status updates, handle job versioning, and implement best practices for production deployments.
See Create and manage jobs with the Grepr REST API.
Track the lifecycle of Grepr jobs
Detailed documentation of job lifecycle management and state transitions for Grepr processing jobs. This page explains the different states that jobs can enter during creation, updates, and deletion, including pending, running, stopped, and failed states. Learn how to monitor job health, understand state diagrams for different job types, and handle job rollbacks and version management.
See Track the lifecycle of jobs with the Grepr REST API.
Use conditions and triggers to control log processing
API documentation for configuring and managing Grepr’s rule engine to dynamically control log processing based on defined conditions and triggers. This page covers how to create event-based triggers, configure conditional actions, and implement automated responses to log events. Use the rule engine to implement incident response workflows, dynamic log filtering, and context-aware processing rules.