curl -X POST https://api.trygroundai.com/rover/jobs \
  -H "Authorization: Bearer gnd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"question":"How does auth work?","mode":"fast"}'

Rover API

Rover runs multi-step GitHub research jobs (fast or deep mode) on behalf of your tenant. All routes require API key authentication and are scoped to your account. Prefix: /rover

Create job

POST /rover/jobs

JSON body (simplified):

{
  "question": "Where is OAuth implemented?",
  "repos": ["org/repo"],
  "mode": "fast"
}

mode: fast or deep
repos: optional list of owner/repo strings

Response: 201 with job id and status.

Get job

GET /rover/jobs/{job_id}

List jobs

GET /rover/jobs?page=1&per_page=20

Stream progress (SSE)

GET /rover/jobs/{job_id}/stream

Server-Sent Events; event shapes are defined by the live API. Use this from a browser or SSE-aware client.

Cancel job

DELETE /rover/jobs/{job_id}

Only jobs that are not already completed or failed can be cancelled.

curl -X POST https://api.trygroundai.com/rover/jobs \
  -H "Authorization: Bearer gnd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"question":"How does auth work?","mode":"fast"}'