Registry Token API Reference

Field	Value
Source spec	`registry-token/openapi/v1.json`
OpenAPI version	`3.1.1`
API version	`1.0.0`
Operations	10
Path filter	All paths

Operations

`GET /api/admin/plans`

Lists all plan rules ordered by name.

Property	Value
Operation ID	`ListPlans`
Tags	`Plan Administration`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`

`POST /api/admin/plans`

Creates a new plan rule.

Property	Value
Operation ID	`CreatePlan`
Tags	`Plan Administration`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`201`	Created	`application/json`
`400`	Bad Request	`application/problem+json`
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`
`409`	Conflict	`application/problem+json`

`GET /api/admin/plans/audit`

Gets audit history for plan changes. Optionally filter by plan ID.

Property	Value
Operation ID	`GetPlanAuditHistory`
Tags	`Plan Administration`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required
`page`	`query`	no
`pageSize`	`query`	no
`planId`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`

`POST /api/admin/plans/validate`

Validates a plan rule without saving. Optionally evaluates test scopes.

Property	Value
Operation ID	`ValidatePlan`
Tags	`Plan Administration`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/problem+json`
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`

`GET /api/admin/plans/{planId}`

Gets a plan rule by ID.

Property	Value
Operation ID	`GetPlan`
Tags	`Plan Administration`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`planId`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`
`404`	Not Found	`application/problem+json`

`PUT /api/admin/plans/{planId}`

Updates an existing plan rule. Requires version for optimistic concurrency.

Property	Value
Operation ID	`UpdatePlan`
Tags	`Plan Administration`
Auth	Not declared
Request body	`application/json`

Parameters:

Name	In	Required	Description
`planId`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/problem+json`
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`
`404`	Not Found	`application/problem+json`
`409`	Conflict	`application/problem+json`

`DELETE /api/admin/plans/{planId}`

Deletes a plan rule.

Property	Value
Operation ID	`DeletePlan`
Tags	`Plan Administration`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`planId`	`path`	yes

Responses:

Status	Description	Content types
`204`	No Content	-
`401`	Unauthorized	`application/problem+json`
`403`	Forbidden	`application/problem+json`
`404`	Not Found	`application/problem+json`

`GET /api/v1/buildinfo`

API alias for /buildinfo.json (same payload).

Property	Value
Operation ID	`StellaOpsBuildInfoApi`
Tags	`StellaOps.Registry.TokenService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /buildinfo.json`

Image build provenance (module, gitSha, gitCommitTime, imageBuiltAt, branch) for drift detection.

Property	Value
Operation ID	`StellaOpsBuildInfoFile`
Tags	`StellaOps.Registry.TokenService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /token`

Property	Value
Operation ID	`GetRegistryToken`
Tags	`StellaOps.Registry.TokenService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-
`400`	Bad Request	`application/problem+json`
`403`	Forbidden	`application/problem+json`