GRgrepr
Issues

Record a sighting

Links the calling investigation to the issue once and counts it. A sighting of a fixed or obsolete issue reopens it, and of a Monitoring issue moves it back to In progress, when the investigation started after the issue's last state change. A duplicate's sighting lands on its survivor. Only an agent's investigation can record one.

post/v1/issues/{idOrNumber}/occurrences

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)

Path parameters

idOrNumberstring required

Response

Sighting recorded

closedAtstring date-time

When it closed, or null while open.

confidence'CONFIRMED' | 'LIKELY' | 'UNVERIFIED'

How sure the reporter is that the problem is real.

createdAtstring date-time

When it was filed.

descriptionstring

The current understanding, in markdown, kept current rather than appended to.

duplicateOfstring

The surviving issue, set exactly when resolved as DUPLICATE; null in a response when the reader can't see the survivor.

duplicateOfHiddenboolean

True in a response whose reader can't see the surviving issue.

entitiesobject

The entity:* tags it concerns, the same vocabulary as memory tags, keys in lower case, sorted by key.

expiresAtstring date-time

When the issue stops applying and closes as EXPIRED, or null.

fingerprintstring

An optional free-form key for exact-match search, or null.

firstSeenAtstring date-time

The first sighting, or null before any.

idstring

The issue id.

labelsstring[]

Categories, such as cost, sorted.

lastSeenAtstring date-time

The latest sighting, or when it was filed.

nextStepstring

The concrete next action and who it waits on, or null.

numberinteger

The short per-organization handle, shown as #142.

occurrenceCountinteger

How many investigations sighted it.

priority'P0' | 'P1' | 'P2' | 'P3'

How soon someone should act.

regressedboolean

Whether it reopened on a new sighting after being fixed; cleared on its next close.

resolution'FIXED' | 'DUPLICATE' | 'NOT_A_PROBLEM' | 'IGNORED' | 'OBSOLETE' | 'EXPIRED'

Why it closed; set exactly when state is CLOSED.

revisitAtstring date-time

When someone should check back, or null. Then a Monitoring issue's watcher is started on it, or, with no watcher, it goes back to READY.

state'TRIAGE' | 'READY' | 'IN_PROGRESS' | 'WAITING' | 'MONITORING' | 'CLOSED'

Where the issue is in its lifecycle.

stateChangedAtstring date-time

When the state last changed.

teamIdsstring[]

The teams that may see the issue, sorted.

titlestring

One line naming the problem.

updatedAtstring date-time

When it last changed.

versioninteger

Bumped by every change to a field, the state, an assignment, a lock or the teams.

watchedBystring

The agent watching it in MONITORING: the one that moved it there, started on it again when a sighting comes in or its revisit time passes. Null outside Monitoring.

Changes

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