Execution Engine API

Code Execution Infrastructure

Execute containerized code from your git repositories. Queue jobs, monitor executions, and stream output logs via REST API.

Overview

Execute code from git repositories in isolated Docker containers
Queue-based execution with background workers for reliability
Stream execution output from S3-backed log storage
Ethereum address-based repository ownership
RESTful JSON API for programmatic access

Base URL

https://execution.grep3.com

Architecture

Web API

Express server handling REST endpoints for repos and executions

Workers

Background job processors executing Docker containers

Scheduler

Job orchestration and queue management via Redis

Repositories

GET /repos/:address/all

List all repositories owned by an Ethereum address.

Parameters :address — Ethereum address (checksummed or lowercase)

Response Array of repository objects with id, name, address, created_at

Example

curl https://execution.grep3.com/repos/0xYourAddress/all

GET /repos/:id/get

Get details for a specific repository by ID.

Parameters :id — Repository ID (integer)

Response Repository object with full details

ALL /repos/:id/execute

Trigger execution of a repository. Creates an execution record and queues a Docker job.

Parameters :id — Repository ID (integer)

Response Execution object with id, status, created_at

Example

curl -X POST https://execution.grep3.com/repos/123/execute

Executions

GET /executions/:repoId/all

List all executions for a repository.

Parameters :repoId — Repository ID (integer)

Response Array of execution objects with status, timestamps, stdout_file

GET /executions/:id/get

Get details for a specific execution.

Parameters :id — Execution ID (integer)

Response Execution object with full details including status and output file reference

GET /executions/:id/stdout

Stream the stdout output of an execution. Returns the raw text output from the container.

Parameters :id — Execution ID (integer)

Response Plain text stream of execution output (Content-Type: text/plain)

Example

curl https://execution.grep3.com/executions/456/stdout

# Output:
Building container...
Running script...
Hello from Docker!
Execution complete.

GET /:address/:repoName

Shortcut to stream the latest execution output for a repository by address and name.

Parameters :address — Ethereum address, :repoName — Repository name (with or without .git)

Response Plain text stream of latest execution output

Health

GET /health/check

Health check endpoint for load balancers and monitoring.

Response 204 No Content on success