Integrations

Browse GraphQL domains.

Queries

OperationDescription
channelReturn a channel binding.
channelAgentsList runtime target agents.
channelsList a project's channels.
connectionsList connections across projects.
connectionStatusReturn connection status.
externalFileReturn external file.
externalFileContentRead external file content.
externalFilesList external files.
integrationReturn an integration.
integrationReadinessCheck whether one integration tool can run now in a project, before a run or to explain why a run was blocked; returns the selected connection, its state and the local blockers from stored metadata only, where a blocked or missing selection is a result and the provider is not contacted.
integrationsList the integrations.
integrationToolsList the integration tools the caller can run in a project to discover tool names and input schemas before a run; returns the complete list in one response when no limit or cursor is sent, or one page with total and page information otherwise.
projectConnectionsList the connections.
projectIntegrationRead the settings of a project for one integration to show or check its scope, allowed tools, configuration, execution mode and connection counts; returns the project integration, with configured false and the defaults when no settings are stored.
projectIntegrationsList project integrations.
salesforceObjectFieldsList the fields of one Salesforce object in the org connected to a project to map or filter its data; returns every field the connected user can see, or one page when a limit or cursor is sent.
salesforceObjectsList the objects of the Salesforce org connected to a project to choose the objects an integration may access; returns every object the connected user can see, or one page when a limit or cursor is sent.
slackChannelsList slack channels.

Mutations

OperationDescription
checkChannelTest channel message delivery.
createChannelConnect a Slack agent.
createConnectSessionCreate connect session.
createExternalFileCreate external file.
createExternalFolderCreate external folder.
deleteChannelDisconnect a channel.
deleteConnectionDelete a connection.
deleteExternalFileDelete external file.
deleteProjectIntegrationReset the settings of a project for one integration to the defaults without touching its connections, also when no settings were stored; every surface returns { ok: true }.
importExternalFileImport external file.
moveExternalFileMove external file.
runIntegrationToolRun one integration tool synchronously by its qualified name, with provider arguments and an optional exact connection; returns the native tool result, where a provider failure or a refusal of the tool layer is a result with isError true, not an error.
updateChannelUpdate a channel binding.
updateExternalFileUpdate external file.
updateProjectIntegrationChange the scope, allowed tools, configuration or execution mode of a project integration by sending only the fields to change, so that an omitted field keeps its stored value; returns the updated project integration.