Skip to main content
POST
Propose a new version of a Library theme for review instead of publishing it (agents use this). Requires --execute.

Body

application/json
dir
string
required

Theme folder holding theme.json (relative to your current directory)

draft
boolean

Save a draft only you and the scope's reviewers see; do not submit

execute
boolean

Confirm the proposal (without it, print the plan and exit 3)

name
string

Display name (default: $extensions.ravi.name, else the slug)

note
string

Note for the reviewers, at most 500 characters

rebase
boolean

With --update: move the proposal onto the version published now (read it first)

scope
string

org, or a Console project slug (default: the known project)

slug
string

Library slug (default: the folder name)

update
string

Replace the content of your open proposal with this number

Response

Success — body conforms to the @Returns schema.

baseVersion
number
required
created
boolean
required
currentVersion
number
required
diagnostics
object[]
required
next
string
required
number
number
required
proposal
object
required
ref
string
required
round
number
required
stale
boolean
required
status
enum<string>
required
Available options:
draft,
proposed,
published,
superseded,
rejected,
withdrawn
success
boolean
required