LIlinuxfoundation
Stewardship Actions

Update stewardship status

Changed on

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

Request

  • Base URL
    https://cm.lfx.dev/api/v1/akrites
  • URL
    https://cm.lfx.dev/api/v1/akrites/stewardships/{id}/status
  • Auth
    HTTP bearer

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."
  }
}

Changes