Sign in
In-App Feedback

The current developer's in-app feedback

Process-level messages prepared for the authenticated developer: for each way of working that recurs in their work, what the pattern is, the pieces of work it was observed on, and one thing to try next. Distinct from in-context notes (which say what is wrong in one diff) and from the mentor conversation (which asks rather than tells). Reading a message is what delivers it, so this GET records the delivery.

get/workspaces/{workspaceSlug}/practices/feedback/in-app

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /workspaces/{workspaceSlug}/practices/feedback/in-app
  • Auth: HTTP bearer

Path parameters

workspaceSlugstring required

Workspace slug

Response

In-app messages returned, newest first

bodystring

The message, as Markdown, without the headline and the next step; null once a workspace admin withdrew it

cleanNeededinteger required

Clean pieces of work in a row on the practice that resolve this feedback

closedAtstring date-time

When it stopped being open: the earliest of the work completing its clean run, the developer answering that it is addressed or not applicable, and the practice changing its review rules after it was prepared; null while it is open

closedBy'WORK' | 'DEVELOPER' | 'PRACTICE_CHANGED'

What closed it, for the moment closedAt names; on a tie the work, then the developer, then the practice; null while it is open

groupNamestring

Group display name; null when the practice has none

groupSlugstring

Group the practice sits in; null when the practice has none

headlinestring required

Short headline naming the way of working, never the person

idstring uuid required
nextStepstring

The way of working to try next, on its own; null for feedback prepared without one

practiceNamestring required
practiceSlugstring required

Practice this feedback is about

preparedAtstring date-time required

When the message was composed

readAtstring date-time

When this developer first opened it; null until they have

whatGoodLooksLikestring

What good looks like, in the developer's framing

whyItMattersstring

Why this practice matters, in the developer's framing

withdrawnAtstring date-time

When a workspace admin withdrew it because what it said was wrong; the card then carries only its practice, whose name is the headline, and no message, next step, evidence, progress or closure

Changes

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