v1

latestOpenAPI 3.1.02026-07-174721.3 KB

Stewardship Actions

Update stewardship status

Updates the stewardship status and logs a state_changed activity entry. Valid target statuses: assessing, active, needs_attention, blocked, inactive. When transitioning to inactive, inactiveReason is required.

patch/stewardships/{id}/status

Path parameters

idinteger required

Stewardship ID.

Request body

status'assessing' | 'active' | 'needs_attention' | 'blocked' | 'inactive' required

inactiveReason'quarterly_cadence_missed' | 'stepped_down' | 'no_longer_critical'

Required when status is inactive.

notesstring

Optional free-text notes for the activity log.

Example request

{
  "actor": {
    "userId": "auth0|abc123",
    "username": "gaspergrom",
    "displayName": "Gašper Grom",
    "avatarUrl": "https://avatars.githubusercontent.com/u/12345"
  }
}

Response

Status updated.

Example response

{
  "stewardship": {
    "id": "42",
    "packageId": "1234",
    "version": 1,
    "statusNote": "Contacted maintainer, no response after 30 days."
  }
}