v1

latestOpenAPI 3.1.02026-07-174721.3 KB
Stewardship Actions

Escalate a stewardship

Transitions the stewardship to escalated status and logs the chosen resolution path in the activity log. Optional free-text notes can be included.

post/stewardships/{id}/escalate

Path parameters

idinteger required

Stewardship ID.

Request body

resolutionPath'right_of_first_refusal' | 'replace_the_dependency' | 'find_vendor_for_lts' | 'consortium_adopts_maintainership' | 'compensating_controls_monitor' | 'namespace_takeover' required
notesstring

Optional free-text notes for the activity log.

Example request

{
  "notes": "Contacted maintainer, no response after 30 days.",
  "actor": {
    "userId": "auth0|abc123",
    "username": "gaspergrom",
    "displayName": "Gašper Grom",
    "avatarUrl": "https://avatars.githubusercontent.com/u/12345"
  }
}

Response

Stewardship escalated.

Example response

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