Skip to content

chore: update integration docs #399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
adkah merged 1 commit into from
Jan 26, 2026
Merged

chore: update integration docs #399

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
206 changes: 204 additions & 2 deletions snippets/integrations/cards/botpress/linear.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -332,6 +332,50 @@ Available options: `issue`
</Expandable>
</ResponseField>

### Get or Create a Conversation

<span>{"Proactively create a conversation from a bot"}</span>

<ResponseField
name="input"
type="object"
>
<Expandable>
<ResponseField
name="conversation"
type="object"
required
>


<Expandable>
<ResponseField
name="id"
type="string"
required
>
<span>{"The issue ID on Linear"}</span>
</ResponseField>
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField
name="output"
type="object"
>
<Expandable>
<ResponseField
name="conversationId"
type="string"
required
>
<span>{"The Botpress ID of the created conversation"}</span>
</ResponseField>
</Expandable>
</ResponseField>

### Get User Profile

<span>{"Get a user profile from Linear"}</span>
Expand All @@ -344,9 +388,8 @@ Available options: `issue`
<ResponseField
name="linearUserId"
type="string"
required
>
<span>{"The user's ID on Linear. Ex: {{event.payload.linearIds.creatorId}}"}</span>
<span>{"The user's ID on Linear. Ex: {{event.payload.linearIds.creatorId}}. If omitted, returns the current user."}</span>
</ResponseField>
</Expandable>
</ResponseField>
Expand Down Expand Up @@ -700,6 +743,69 @@ Available options: `issue`
</Expandable>
</ResponseField>

### List States

<span>{"List states from Linear"}</span>

<ResponseField
name="input"
type="object"
>
<Expandable>
<ResponseField
name="count"
type="number"
default={10}
>
<span>{"The number of states to return"}</span>
</ResponseField>
<ResponseField
name="startCursor"
type="string"
>
<span>{"The cursor to start from"}</span>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField
name="output"
type="object"
>
<Expandable>
<ResponseField
name="states"
type="array"
required
>
<span>{"The list of states"}</span>

<Expandable title="array item properties">
<ResponseField
name="id"
type="string"
required
>
<span>{"The unique identifier of the entity"}</span>
</ResponseField>
<ResponseField
name="name"
type="string"
required
>
<span>{"The state's name"}</span>
</ResponseField>
</Expandable>
</ResponseField>
<ResponseField
name="nextCursor"
type="string"
>
<span>{"The cursor to fetch the next page"}</span>
</ResponseField>
</Expandable>
</ResponseField>

### List Teams

<span>{"List teams from Linear"}</span>
Expand Down Expand Up @@ -731,6 +837,13 @@ Available options: `issue`
>
<span>{"The unique identifier of the entity"}</span>
</ResponseField>
<ResponseField
name="key"
type="string"
required
>
<span>{"The team's key"}</span>
</ResponseField>
<ResponseField
name="name"
type="string"
Expand Down Expand Up @@ -890,6 +1003,95 @@ Available options: `issue`
This Card has no output.
</ResponseField>

### Resolve Comment

<span>{"Resolve a comment by id"}</span>

<ResponseField
name="input"
type="object"
>
<Expandable>
<ResponseField
name="id"
type="string"
required
>
<span>{"The comment ID"}</span>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField
name="output"
type="object"
>
<Expandable>
<ResponseField
name="success"
type="boolean"
required
>
<span>{"Whether the operation was successful"}</span>
</ResponseField>
</Expandable>
</ResponseField>

### Send Raw GraphQL Query

<span>{"Send a raw GraphQL query to the linear API"}</span>

<ResponseField
name="input"
type="object"
>
<Expandable>
<ResponseField
name="query"
type="string"
required
>
<span>{"The GraphQL query"}</span>
</ResponseField>
<ResponseField
name="parameters"
type="array"
>
<span>{"The query parameters"}</span>

<Expandable title="array item properties">
<ResponseField
name="name"
type="string"
required
>
<span>{"The parameter name"}</span>
</ResponseField>
<ResponseField
name="value"
type="string"
>
<span>{"The parameter value"}</span>
</ResponseField>
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField
name="output"
type="object"
>
<Expandable>
<ResponseField
name="result"
type="string"
>
<span>{"The query result"}</span>
</ResponseField>
</Expandable>
</ResponseField>

### Update Issue

<span>{"Update an issue on Linear"}</span>
Expand Down
141 changes: 141 additions & 0 deletions snippets/integrations/cards/botpress/tally.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
{/* This file is auto-generated. Do not edit directly. */}
{/* vale off */}

Here's a reference for all [Cards](/studio/concepts/cards/introduction) available with the integration:

### List Submissions

<span>{"List all the submissions for a specified form"}</span>

<ResponseField
name="input"
type="object"
>
<Expandable>
<ResponseField
name="formId"
type="string"
required
>
<span>{"Tally form ID"}</span>
</ResponseField>
<ResponseField
name="page"
type="integer"
>
<span>{"Page number for pagination"}</span>
</ResponseField>
<ResponseField
name="filter"
type="enum<string>"
>
<span>{"Filter submissions by status"}</span>

Available options: `all`, `completed`, `partial`
</ResponseField>
<ResponseField
name="startDate"
type="string"
>
<span>{"Start date for filtering submissions"}</span>
</ResponseField>
<ResponseField
name="endDate"
type="string"
>
<span>{"End date for filtering submissions"}</span>
</ResponseField>
<ResponseField
name="afterId"
type="string"
>
<span>{"ID of the submission after which to start listing"}</span>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField
name="output"
type="object"
>
<Expandable>
<ResponseField
name="questions"
type="array"
required
>
<span>{"List of questions"}</span>

<Expandable title="array item properties">
<ResponseField
name="id"
type="string"
required
>
<span>{"Question ID"}</span>
</ResponseField>
<ResponseField
name="type"
type="string"
>
<span>{"Question type"}</span>
</ResponseField>
<ResponseField
name="title"
type="string | null"
>

</ResponseField>
</Expandable>
</ResponseField>
<ResponseField
name="submissions"
type="array"
required
>
<span>{"List of submissions"}</span>

<Expandable title="array item properties">
<ResponseField
name="id"
type="string"
required
>
<span>{"Submission ID"}</span>
</ResponseField>
<ResponseField
name="responses"
type="array"
required
>


<Expandable title="array item properties">
<ResponseField
name="questionId"
type="string"
required
>
<span>{"Question ID"}</span>
</ResponseField>
<ResponseField
name="value"
type="string"
>
<span>{"Response value"}</span>
</ResponseField>
<ResponseField
name="answer"
type="string"
>
<span>{"Response answer"}</span>
</ResponseField>
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>


{/* vale on */}
Loading