Reference
Integration action reference
Every provider and action supported by the unified integration surface, plus the separate repository-native VCS boundary.
The unified integration domain supports six providers — slack, github,
notion, linear, jira, and figma — plus all for applicable
cross-provider reads. The provider connection and the authenticated user's
access still determine what can be returned.
Use this page when constructing a direct call. For the human workflow, see Connecting GitHub, Slack, and the rest.
Provider values
| Value | Connected product |
|---|---|
slack | Slack |
github | GitHub knowledge/integration data |
notion | Notion |
linear | Linear |
jira | Jira |
figma | Figma |
all | Applicable cross-provider reads |
Action matrix
| Action | Provider | Purpose |
|---|---|---|
status | Any provider | Connection and sync status |
connected | Use all; the action always reads all providers | List connected integrations |
search | Any provider or all | Search provider content |
stats | Any provider or all | Counts and activity statistics |
activity | Any provider or all | Recent provider activity |
contributors | Any provider or all | Contributor activity |
knowledge | Any provider or all | Retrieve provider-backed knowledge |
summary | Any provider or all | Summarize a bounded date range |
channels | slack | List/search channels |
discussions | slack | Retrieve channel threads and discussions |
sync_users | slack | Refresh Slack user mappings |
repos | github | List/search connected repositories |
issues | github, linear, or jira | Query issue records with provider filters |
files | figma | List/search Figma files |
create_page | notion | Create a Notion page |
search_pages | notion | Search Notion pages |
get_page | notion | Read one Notion page |
update_page | notion | Update a Notion page |
create_database | notion | Create a Notion database |
list_databases | notion | List Notion databases |
query_database | notion | Query a database with filters and sorts |
team_activity | Any provider or all, in team mode | Aggregate connected activity for the team |
team_search | Use all, in team mode | Cross-provider team search |
Frequently used fields include query, limit, since, until, days,
and workspace_id, but each action consumes only its compatible subset. The
complete field map below makes those boundaries explicit.
Slack
Slack supports the common read actions plus channels, discussions, and
sync_users. Use search for matching messages and discussions when thread
structure and replies matter. A connected workspace does not grant access to
channels the connected Slack account cannot read.
integration(provider="slack", action="search", query="rate-limit decision")
integration(provider="slack", action="discussions", query="billing")GitHub
GitHub supports the common reads, repos, and issues. Use the separate
vcs domain when you need repository-native detail or mutation: pull request
diffs, comments, checks, reviews, merges, issue creation/updates, commits,
branches, tags, trees, blobs, notifications, links, automations, webhooks, or
repository ingest.
integration(provider="github", action="issues", query="timeout")
vcs(provider="github", action="get_pull_diff", repo_ref="owner/repo", number=42)The integration domain covers connected product knowledge. The VCS domain is the operational repository API.
Notion
Notion has the broadest provider-specific surface:
- Page reads:
search_pages,get_page - Page writes:
create_page,update_page - Database reads:
list_databases,query_database - Database writes:
create_database
Page content is Markdown. Depending on the operation, use page_id,
parent_page_id, parent_database_id, database_id, title, content,
properties, filter, and sorts. Supported content types are
NotionTask, NotionMeeting, NotionWiki, NotionBugReport,
NotionFeature, NotionJournal, and NotionPage.
Writes should identify the intended parent explicitly. Do not infer a database or page from a similarly named search result.
Linear and Jira
Both support common reads and issues.
| Provider | Issue filters |
|---|---|
| Linear | team_id, status, priority, assignee |
| Jira | project_key, status, priority, issue_type, assignee |
Jira issue_type accepts the installation's names, commonly Bug, Story, Task,
or Epic. These integration actions query connected issues; they are not the
same records as ContextStream's native entity(kind="ticket", …) objects.
Figma
Figma supports the common reads plus files. Narrow file listings with
figma_project_id. The schema currently accepts file_key, but no public
integration action consumes it; do not infer a single-file read operation from
that field. Figma is a knowledge/search integration here, not a design-file
editing API.
Team-wide actions
team_activity and team_search require team mode and a team-capable account.
They aggregate only providers and records the caller is authorized to see.
Choosing team mode changes the execution scope; it does not widen the
underlying provider permissions.
Complete input field map
| Fields | Used for |
|---|---|
provider, action | Required routing values |
workspace_id | Optional workspace scope |
query, limit | Search text and result bounds where supported |
days, since, until | Summary, statistics, activity, and team-activity windows |
node_type, max_tokens | Knowledge filtering and summary size |
database_id, page_id, parent_page_id, parent_database_id | Notion object and parent selection |
title, content, properties, description | Notion page/database content and metadata |
filter, sorts | Notion database queries; each sort has property and direction |
event_type, status, priority, has_due_date, tags | Notion page-search filters |
team_id, assignee | Linear issue filters |
project_key, issue_type | Jira issue filters |
figma_project_id | Figma file-list filter |
project_id, file_key | Accepted by the current schema but not consumed by a public action |
Fields omitted by an action are not universal filters merely because the
consolidated schema accepts them. Generate requests from the current
tools/list schema and this action map.
ChatGPT and other clients
ChatGPT is a client surface, not an integration provider value. Connect it
through the supported ChatGPT gateway or custom MCP flow described in
ChatGPT and desktop apps. GitLab and
Bitbucket likewise belong to the separate vcs provider list, not this
integration enum.