Service commands: close, open, pause, setCapacity
The Service Verbs close, open, pause, setCapacity as CLI commands, with inputs, result, refusals and an example.
curl -X POST https:API reference
Service.opennpx startup-builder do Service.open --data '{"service":CLI reference
Service.open{
"name": "do",
"arguments": {
"code": "return await $.Service.open({ service:MCP reference
Service.openimport { $ } from 'startup-builder'
const service = await $.Service.open({ service: 'service_Eq1ssq4AOW' })
SDK reference
Service.openReference for Service, one group of Service commands.
Service.close
Close stops a Service taking new Orders for good, while every placed Order runs to its end. Verb page.
npx startup-builder do Service.close --data '<input>' [--try | --send | --do]Emits Service.closed.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
service | Service | required | The Service to close. |
reason | text | required | Why it closes. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
service | Service | required | The closed Service. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
service is missing, or is not a service | invalid-input | Send service as a service, then call it again. | None. |
reason is missing, or is not a text | invalid-input | Send reason as a text, then call it again. | None. |
The Idempotency-Key was sent before with another operation or other input | idempotency-mismatch | Send a new key for new input; reuse a key only to retry the same request. | None. |
Example
npx startup-builder do Service.close --data '{"service":Service.open
Open starts a Service taking new Orders on every published Offer that sells it. Verb page.
npx startup-builder do Service.open --data '<input>' [--try | --send | --do]Emits Service.opened.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
service | Service | required | The Service to open. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
service | Service | required | The Service, now taking new Orders. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
service is missing, or is not a service | invalid-input | Send service as a service, then call it again. | None. |
The Idempotency-Key was sent before with another operation or other input | idempotency-mismatch | Send a new key for new input; reuse a key only to retry the same request. | None. |
Example
npx startup-builder do Service.open --data '{"service":Service.pause
Pause stops a Service taking new Orders until a stated time, while every placed Order runs to its end. Verb page.
npx startup-builder do Service.pause --data '<input>' [--try | --send | --do]Emits Service.paused.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
service | Service | required | The Service to pause. |
reason | text | required | Why it pauses, shown to buyers. |
until | datetime | When it reopens on its own. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
service | Service | required | The paused Service. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
service is missing, or is not a service | invalid-input | Send service as a service, then call it again. | None. |
reason is missing, or is not a text | invalid-input | Send reason as a text, then call it again. | None. |
The Idempotency-Key was sent before with another operation or other input | idempotency-mismatch | Send a new key for new input; reuse a key only to retry the same request. | None. |
Example
npx startup-builder do Service.pause --data '{"service":Service.setCapacity
SetCapacity sets the most work a Service holds in flight, in the unit its intake counts. Verb page.
npx startup-builder do Service.setCapacity --data '<input>' [--try | --send | --do]Emits Service.capacitySet.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
service | Service | required | The Service. |
capacity | integer | required | The most work in flight, in the intake’s unit, such as listings. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
service | Service | required | The Service with its new capacity. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
service is missing, or is not a service | invalid-input | Send service as a service, then call it again. | None. |
capacity is missing, or is not a integer | invalid-input | Send capacity as a integer, then call it again. | None. |
The Idempotency-Key was sent before with another operation or other input | idempotency-mismatch | Send a new key for new input; reuse a key only to retry the same request. | None. |
Example
npx startup-builder do Service.setCapacity --data '{"service":