v1

latestOpenAPI 3.1.02026-07-174721.3 KB

Stewardship Actions

Open a package for stewardship

Transitions the stewardship status to open, marking the package as available for claiming. If a stewardship row does not exist yet, one is created. If the stewardship is already open, this is a no-op (idempotent).

post/stewardships/open

Request body

purlstring required

Package URL (must start with pkg:).

Example request

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

Response

Stewardship opened (or already open).

Example response

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