Integration commands: reconnect, refresh, resume, revoke
The Integration Verbs reconnect, refresh, resume, revoke as CLI commands, with inputs, result, refusals and an example.
Reference for Integration, one group of Integration commands.
Integration.reconnect
Reconnect re-approves an Integration in place, keeping its id and cursor, so nothing re-imports. Verb page.
npx startup-builder do Integration.reconnect --json '<input>' [--try | --send | --do]Emits Integration.reconnected.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The Integration in needsReauth. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
connectUrl | url | required | The approval page; it expires in one hour. |
integration | Integration | required | The Integration, its id and cursor kept. |
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. |
Example
npx startup-builder do Integration.reconnect --json '{"integration":Integration.refresh
Refresh renews an Integration’s outside token before it expires; a refused refresh moves it to needsReauth. Verb page.
npx startup-builder do Integration.refresh --json '<input>' [--try | --send | --do]Emits Integration.refreshed.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The Integration to refresh. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The Integration with a new refreshedAt, or in needsReauth. |
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. |
Example
npx startup-builder do Integration.refresh --json '{"integration":Integration.resume
Resume restarts a paused Integration from its cursor and releases the Actions that waited on it. Verb page.
npx startup-builder do Integration.resume --json '<input>' [--try | --send | --do]Emits Integration.resumed.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The paused Integration. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The Integration, connected. |
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. |
Example
npx startup-builder do Integration.resume --json '{"integration":Integration.revoke
Revoke ends an Integration at once: its token is revoked with the upstream, and every record it brought in stays. Verb page.
npx startup-builder do Integration.revoke --json '<input>' [--try | --send | --do]Emits Integration.revoked.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The Integration to end. |
reason | text | Why, kept on the Integration. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
integration | Integration | required | The Integration, revoked. |
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. |
Example
npx startup-builder do Integration.revoke --json '{"integration":