Integration programs: reconnect, refresh, resume, revoke
The Integration Verbs reconnect, refresh, resume, revoke as MCP do programs, with inputs, result, refusals and an example.
Reference for Integration, one group of Integration programs.
Integration.reconnect
Reconnect re-approves an Integration in place, keeping its id and cursor, so nothing re-imports. Verb page.
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
{
"name": "do",
"arguments": {
"code": "return await $.Integration.reconnect({ integration:Integration.refresh
Refresh renews an Integration’s outside token before it expires; a refused refresh moves it to needsReauth. Verb page.
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
{
"name": "do",
"arguments": {
"code": "return await $.Integration.refresh({ integration:Integration.resume
Resume restarts a paused Integration from its cursor and releases the Actions that waited on it. Verb page.
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
{
"name": "do",
"arguments": {
"code": "return await $.Integration.resume({ 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.
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
{
"name": "do",
"arguments": {
"code": "return await $.Integration.revoke({ integration: