GRgrepr
Investigations

Start an investigation

Triggers an agent investigation with optional free-form context and returns the new investigation id. The investigation is queued and runs asynchronously once the agent has a free concurrency slot. With issueId, a person hands the agent that issue, which becomes the investigation's subject and records the handoff in its history.

post/v1/investigations

Request

  • Base URL
    https://docs.grepr.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header GREPR-API-KEY
    • or OpenID Connect (https://grepr-prod.us.auth0.com/.well-known/openid-configuration)

Request body

agentIdstring required

TSID of the agent to investigate.

issueIdstring

When set, hands the agent this issue (its TSID): the run's subject, which its first message holds and whose history records the handoff. Only a person may hand off an issue, and a handoff can't be a continuation. null for a plain run.

nextboolean

With issueId, true to have the agent work on the issue next: the run starts ahead of the agent's other queued runs, without stopping a running one. Allowed only with issueId; null or false for the usual place in the queue.

parentInvestigationIdstring

When set, seeds the new investigation from this parent's journalled transcript — a continuation; the parent must belong to agentId. null for a fresh investigation.

userProvidedContextstring

Free-form context for the agent's first turn, or null.

Response

Investigation queued

investigationIdstring

Changes

No recorded changes to this operation across all 1 revision of this API.