Skip to content

Commit 9866b65

Browse files
authored
fix(atlassian): validate Jira, Confluence, JSM, Bitbucket, Trello against vendor docs (#9950)
* fix(atlassian): validate Jira, Confluence, JSM, Bitbucket, Trello against vendor docs Fixes JSM Assets AQL search returning no objects (legacy request/response shape), adds missing documented params and dropped response fields across the suite, and routes path IDs through safeUrlPathSegment. All changes are additive: no param, subBlock, operation, tool id, or output is removed or retyped. * fix(atlassian): address review findings Keep trailing AQL and CQL order by clauses after scoped filters, honor escaped quotes, reject JSM approvalStatus/organizationId outside their ownership modes, move Trello card outputs into types.ts so the docs render them, and drop the now-unused Confluence COMMENTS_OUTPUT. * fix(atlassian): send Trello update ID lists comma-separated and tighten output types PUT /cards/{id} documents idLabels/idMembers as comma-separated strings. Treat a whitespace-only Jira parent as unset, mark nullable Trello card outputs, document the new Trello types, and type the Confluence search test. * fix(trello): mark every optional card output field nullable * fix(jira): keep explicit assignee ahead of customFields and accept string includeAttachments
1 parent cc012bf commit 9866b65

89 files changed

Lines changed: 3178 additions & 424 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎apps/docs/content/docs/integrations/bitbucket.mdx‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -346,6 +346,9 @@ List repository commits in reverse chronological order
346346
| --------- | ---- | -------- | ----------- |
347347
| `workspaceSlug` | string | Yes | Bitbucket workspace slug or UUID |
348348
| `repoSlug` | string | Yes | Bitbucket repository slug or UUID |
349+
| `include` | array | No | Branches, tags, or commit hashes whose history to include; omit to list commits on every ref |
350+
| `exclude` | array | No | Branches, tags, or commit hashes whose reachable commits to leave out |
351+
| `path` | string | No | Only list commits that changed this file or directory |
349352
| `nextUrl` | string | No | Opaque next-page URL returned by a previous Bitbucket call |
350353
| `pageLen` | number | No | Results per page \(1-100\) |
351354

@@ -602,11 +605,15 @@ List pull requests in a Bitbucket Cloud repository
602605
| ↳ `commitHash` | string | Commit hash |
603606
| ↳ `repositoryUuid` | string | Repository UUID |
604607
| ↳ `repositoryFullName` | string | Repository full name |
608+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
609+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
605610
| ↳ `destination` | object | Destination endpoint |
606611
| ↳ `branchName` | string | Branch name |
607612
| ↳ `commitHash` | string | Commit hash |
608613
| ↳ `repositoryUuid` | string | Repository UUID |
609614
| ↳ `repositoryFullName` | string | Repository full name |
615+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
616+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
610617
| ↳ `mergeCommitHash` | string | Merge commit hash |
611618
| ↳ `commentCount` | number | Comment count |
612619
| ↳ `taskCount` | number | Open task count |
@@ -692,11 +699,15 @@ Get a pull request by repository-scoped ID
692699
| ↳ `commitHash` | string | Commit hash |
693700
| ↳ `repositoryUuid` | string | Repository UUID |
694701
| ↳ `repositoryFullName` | string | Repository full name |
702+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
703+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
695704
| ↳ `destination` | object | Destination endpoint |
696705
| ↳ `branchName` | string | Branch name |
697706
| ↳ `commitHash` | string | Commit hash |
698707
| ↳ `repositoryUuid` | string | Repository UUID |
699708
| ↳ `repositoryFullName` | string | Repository full name |
709+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
710+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
700711
| ↳ `mergeCommitHash` | string | Merge commit hash |
701712
| ↳ `commentCount` | number | Comment count |
702713
| ↳ `taskCount` | number | Open task count |
@@ -788,11 +799,15 @@ Create a pull request between repository branches
788799
| ↳ `commitHash` | string | Commit hash |
789800
| ↳ `repositoryUuid` | string | Repository UUID |
790801
| ↳ `repositoryFullName` | string | Repository full name |
802+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
803+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
791804
| ↳ `destination` | object | Destination endpoint |
792805
| ↳ `branchName` | string | Branch name |
793806
| ↳ `commitHash` | string | Commit hash |
794807
| ↳ `repositoryUuid` | string | Repository UUID |
795808
| ↳ `repositoryFullName` | string | Repository full name |
809+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
810+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
796811
| ↳ `mergeCommitHash` | string | Merge commit hash |
797812
| ↳ `commentCount` | number | Comment count |
798813
| ↳ `taskCount` | number | Open task count |
@@ -884,11 +899,15 @@ Start an asynchronous pull request merge and return a task to poll when needed
884899
| ↳ `commitHash` | string | Commit hash |
885900
| ↳ `repositoryUuid` | string | Repository UUID |
886901
| ↳ `repositoryFullName` | string | Repository full name |
902+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
903+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
887904
| ↳ `destination` | object | Destination endpoint |
888905
| ↳ `branchName` | string | Branch name |
889906
| ↳ `commitHash` | string | Commit hash |
890907
| ↳ `repositoryUuid` | string | Repository UUID |
891908
| ↳ `repositoryFullName` | string | Repository full name |
909+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
910+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
892911
| ↳ `mergeCommitHash` | string | Merge commit hash |
893912
| ↳ `commentCount` | number | Comment count |
894913
| ↳ `taskCount` | number | Open task count |
@@ -977,11 +996,15 @@ Poll the status of an asynchronous pull request merge task
977996
| ↳ `commitHash` | string | Commit hash |
978997
| ↳ `repositoryUuid` | string | Repository UUID |
979998
| ↳ `repositoryFullName` | string | Repository full name |
999+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
1000+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
9801001
| ↳ `destination` | object | Destination endpoint |
9811002
| ↳ `branchName` | string | Branch name |
9821003
| ↳ `commitHash` | string | Commit hash |
9831004
| ↳ `repositoryUuid` | string | Repository UUID |
9841005
| ↳ `repositoryFullName` | string | Repository full name |
1006+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
1007+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
9851008
| ↳ `mergeCommitHash` | string | Merge commit hash |
9861009
| ↳ `commentCount` | number | Comment count |
9871010
| ↳ `taskCount` | number | Open task count |
@@ -1067,11 +1090,15 @@ Decline an open pull request
10671090
| ↳ `commitHash` | string | Commit hash |
10681091
| ↳ `repositoryUuid` | string | Repository UUID |
10691092
| ↳ `repositoryFullName` | string | Repository full name |
1093+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
1094+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
10701095
| ↳ `destination` | object | Destination endpoint |
10711096
| ↳ `branchName` | string | Branch name |
10721097
| ↳ `commitHash` | string | Commit hash |
10731098
| ↳ `repositoryUuid` | string | Repository UUID |
10741099
| ↳ `repositoryFullName` | string | Repository full name |
1100+
| ↳ `mergeStrategies` | array | Merge strategies available when this endpoint is the destination |
1101+
| ↳ `defaultMergeStrategy` | string | Default merge strategy when this endpoint is the destination |
10751102
| ↳ `mergeCommitHash` | string | Merge commit hash |
10761103
| ↳ `commentCount` | number | Comment count |
10771104
| ↳ `taskCount` | number | Open task count |

‎apps/docs/content/docs/integrations/confluence.mdx‎

Lines changed: 45 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -86,13 +86,20 @@ Retrieve content from Confluence pages using the Confluence API.
8686
| Parameter | Type | Description |
8787
| --------- | ---- | ----------- |
8888
| `ts` | string | ISO 8601 timestamp of the operation |
89+
| `labels` | array | Labels on the content \(first 50\) |
90+
| ↳ `id` | string | Unique label identifier |
91+
| ↳ `name` | string | Label name |
92+
| ↳ `prefix` | string | Label prefix/type \(e.g., global, my, team\) |
8993
| `pageId` | string | Confluence page ID |
9094
| `title` | string | Page title |
9195
| `content` | string | Page content with HTML tags stripped |
9296
| `status` | string | Page status \(current, archived, trashed, draft\) |
9397
| `spaceId` | string | ID of the space containing the page |
9498
| `parentId` | string | ID of the parent page |
9599
| `authorId` | string | Account ID of the page author |
100+
| `ownerId` | string | Account ID of the current page owner |
101+
| `lastOwnerId` | string | Account ID of the previous page owner |
102+
| `parentType` | string | Type of the parent content \(e.g., page, whiteboard, database, embed, folder\) |
96103
| `createdAt` | string | ISO 8601 timestamp when the page was created |
97104
| `url` | string | URL to view the page in Confluence |
98105
| `body` | object | Raw page body content in storage format |
@@ -236,7 +243,7 @@ List all pages within a specific Confluence space. Supports pagination and filte
236243
| `spaceId` | string | Yes | The ID of the Confluence space to list pages from |
237244
| `limit` | number | No | Maximum number of pages to return \(default: 50, max: 250\) |
238245
| `status` | string | No | Filter pages by status: current, archived, trashed, or draft |
239-
| `bodyFormat` | string | No | Format for page body content: storage, atlas_doc_format, or view. If not specified, body is not included. |
246+
| `bodyFormat` | string | No | Format for page body content: storage or atlas_doc_format. If not specified, body is not included. |
240247
| `cursor` | string | No | Pagination cursor from previous response to get the next page of results |
241248

242249
#### Output
@@ -251,6 +258,7 @@ List all pages within a specific Confluence space. Supports pagination and filte
251258
| ↳ `spaceId` | string | ID of the space containing the page |
252259
| ↳ `parentId` | string | ID of the parent page \(null if top-level\) |
253260
| ↳ `authorId` | string | Account ID of the page author |
261+
| ↳ `ownerId` | string | Account ID of the current page owner |
254262
| ↳ `createdAt` | string | ISO 8601 timestamp when the page was created |
255263
| ↳ `version` | object | Page version information |
256264
| ↳ `number` | number | Version number |
@@ -509,6 +517,8 @@ Search for content across Confluence pages, blog posts, and other content.
509517
| `domain` | string | Yes | Your Confluence domain \(e.g., yourcompany.atlassian.net\) |
510518
| `query` | string | Yes | Search query string |
511519
| `limit` | number | No | Maximum number of results to return \(default: 25\) |
520+
| `cql` | string | No | Extra CQL clauses ANDed with the text search, e.g. type = page AND space = "ENG" AND lastModified > now\("-7d"\) |
521+
| `cursor` | string | No | Pagination cursor from a previous response \(nextCursor\) |
512522

513523
#### Output
514524

@@ -529,6 +539,8 @@ Search for content across Confluence pages, blog posts, and other content.
529539
| ↳ `name` | string | Space name |
530540
| ↳ `lastModified` | string | ISO 8601 timestamp of last modification |
531541
| ↳ `entityType` | string | Entity type identifier \(e.g., content, space\) |
542+
| `totalSize` | number | Total number of matching results |
543+
| `nextCursor` | string | Cursor for fetching the next page of results |
532544

533545
</ReferenceDetails>
534546

@@ -547,6 +559,7 @@ Search for content within a specific Confluence space. Optionally filter by text
547559
| `query` | string | No | Text search query. If not provided, returns all content in the space. |
548560
| `contentType` | string | No | Filter by content type: page, blogpost, attachment, or comment |
549561
| `limit` | number | No | Maximum number of results to return \(default: 25, max: 250\) |
562+
| `cursor` | string | No | Pagination cursor from a previous response \(nextCursor\) |
550563

551564
#### Output
552565

@@ -569,6 +582,7 @@ Search for content within a specific Confluence space. Optionally filter by text
569582
| ↳ `name` | string | Space name |
570583
| ↳ `lastModified` | string | ISO 8601 timestamp of last modification |
571584
| ↳ `entityType` | string | Entity type identifier \(e.g., content, space\) |
585+
| `nextCursor` | string | Cursor for fetching the next page of results |
572586

573587
</ReferenceDetails>
574588

@@ -623,13 +637,17 @@ Get a specific Confluence blog post by ID, including its content.
623637
| --------- | ---- | -------- | ----------- |
624638
| `domain` | string | Yes | Your Confluence domain \(e.g., yourcompany.atlassian.net\) |
625639
| `blogPostId` | string | Yes | The ID of the blog post to retrieve |
626-
| `bodyFormat` | string | No | Format for blog post body: storage, atlas_doc_format, or view |
640+
| `bodyFormat` | string | No | Format for blog post body: storage, atlas_doc_format, view, or export_view \(default: storage\) |
627641

628642
#### Output
629643

630644
| Parameter | Type | Description |
631645
| --------- | ---- | ----------- |
632646
| `ts` | string | ISO 8601 timestamp of the operation |
647+
| `labels` | array | Labels on the content \(first 50\) |
648+
| ↳ `id` | string | Unique label identifier |
649+
| ↳ `name` | string | Label name |
650+
| ↳ `prefix` | string | Label prefix/type \(e.g., global, my, team\) |
633651
| `id` | string | Blog post ID |
634652
| `title` | string | Blog post title |
635653
| `status` | string | Blog post status |
@@ -716,7 +734,7 @@ List all blog posts within a specific Confluence space.
716734
| `spaceId` | string | Yes | The ID of the Confluence space to list blog posts from |
717735
| `limit` | number | No | Maximum number of blog posts to return \(default: 25, max: 250\) |
718736
| `status` | string | No | Filter by status: current, archived, trashed, or draft |
719-
| `bodyFormat` | string | No | Format for blog post body: storage, atlas_doc_format, or view |
737+
| `bodyFormat` | string | No | Format for blog post body: storage or atlas_doc_format. If not specified, body is not included. |
720738
| `cursor` | string | No | Pagination cursor from previous response |
721739

722740
#### Output
@@ -765,6 +783,7 @@ Add a comment to a Confluence page.
765783
| `domain` | string | Yes | Your Confluence domain \(e.g., yourcompany.atlassian.net\) |
766784
| `pageId` | string | Yes | Confluence page ID to comment on |
767785
| `comment` | string | Yes | Comment text in Confluence storage format |
786+
| `parentCommentId` | string | No | ID of a footer or inline comment to reply to. When set, the comment is posted as a reply in that thread. |
768787

769788
#### Output
770789

@@ -773,6 +792,15 @@ Add a comment to a Confluence page.
773792
| `ts` | string | Timestamp of creation |
774793
| `commentId` | string | Created comment ID |
775794
| `pageId` | string | Page ID |
795+
| `parentCommentId` | string | ID of the parent comment when the comment is a reply |
796+
| `status` | string | Comment status \(e.g., current\) |
797+
| `version` | object | Comment version information |
798+
| ↳ `number` | number | Version number |
799+
| ↳ `message` | string | Version message |
800+
| ↳ `minorEdit` | boolean | Whether this is a minor edit |
801+
| ↳ `authorId` | string | Account ID of the version author |
802+
| ↳ `createdAt` | string | ISO 8601 timestamp of version creation |
803+
| `webUrl` | string | URL to view the comment in Confluence |
776804

777805
</ReferenceDetails>
778806

@@ -789,8 +817,9 @@ List all comments on a Confluence page.
789817
| `domain` | string | Yes | Your Confluence domain \(e.g., yourcompany.atlassian.net\) |
790818
| `pageId` | string | Yes | Confluence page ID to list comments from |
791819
| `limit` | number | No | Maximum number of comments to return \(default: 25\) |
792-
| `bodyFormat` | string | No | Format for the comment body: storage, atlas_doc_format, view, or export_view \(default: storage\) |
820+
| `bodyFormat` | string | No | Format for the comment body: storage or atlas_doc_format \(default: storage\) |
793821
| `cursor` | string | No | Pagination cursor from previous response |
822+
| `commentType` | string | No | Which comments to list: footer \(comments at the bottom of the page\) or inline \(comments attached to highlighted text\). Default: footer |
794823

795824
#### Output
796825

@@ -815,6 +844,11 @@ List all comments on a Confluence page.
815844
| ↳ `minorEdit` | boolean | Whether this is a minor edit |
816845
| ↳ `authorId` | string | Account ID of the version author |
817846
| ↳ `createdAt` | string | ISO 8601 timestamp of version creation |
847+
| ↳ `commentType` | string | Comment type that was listed \(footer or inline\) |
848+
| ↳ `resolutionStatus` | string | Inline comment resolution status \(open, reopened, resolved, dangling\) |
849+
| ↳ `inlineOriginalSelection` | string | Page text the inline comment is attached to |
850+
| ↳ `inlineMarkerRef` | string | Marker reference of the highlighted text for an inline comment |
851+
| ↳ `webUrl` | string | URL to view the comment in Confluence |
818852
| `nextCursor` | string | Cursor for fetching the next page of results |
819853

820854
</ReferenceDetails>
@@ -927,6 +961,8 @@ List all attachments on a Confluence page.
927961
| ↳ `pageId` | string | ID of the page the attachment belongs to |
928962
| ↳ `blogPostId` | string | ID of the blog post the attachment belongs to |
929963
| ↳ `comment` | string | Comment/description of the attachment |
964+
| ↳ `createdAt` | string | ISO 8601 timestamp when the attachment was created |
965+
| ↳ `fileId` | string | Media file ID of the attachment |
930966
| ↳ `version` | object | Attachment version information |
931967
| ↳ `number` | number | Version number |
932968
| ↳ `message` | string | Version message |
@@ -1067,6 +1103,7 @@ Retrieve all pages that have a specific label applied.
10671103
| ↳ `spaceId` | string | ID of the space containing the page |
10681104
| ↳ `parentId` | string | ID of the parent page \(null if top-level\) |
10691105
| ↳ `authorId` | string | Account ID of the page author |
1106+
| ↳ `ownerId` | string | Account ID of the current page owner |
10701107
| ↳ `createdAt` | string | ISO 8601 timestamp when the page was created |
10711108
| ↳ `version` | object | Page version information |
10721109
| ↳ `number` | number | Version number |
@@ -1137,6 +1174,7 @@ Get details about a specific Confluence space.
11371174
| `description` | object | Space description content |
11381175
| ↳ `value` | string | Description text content |
11391176
| ↳ `representation` | string | Content representation format \(e.g., plain, view, storage\) |
1177+
| `spaceOwnerId` | string | Account ID of the space owner |
11401178

11411179
</ReferenceDetails>
11421180

@@ -1258,9 +1296,11 @@ List all Confluence spaces accessible to the user.
12581296
| ↳ `authorId` | string | Account ID of the space creator |
12591297
| ↳ `createdAt` | string | ISO 8601 timestamp when the space was created |
12601298
| ↳ `homepageId` | string | ID of the space homepage |
1261-
| ↳ `description` | object | Space description |
1299+
| ↳ `description` | object | Space description \(plain text\) |
12621300
| ↳ `value` | string | Description text content |
12631301
| ↳ `representation` | string | Content representation format \(e.g., plain, view, storage\) |
1302+
| ↳ `spaceOwnerId` | string | Account ID of the space owner |
1303+
| ↳ `webUrl` | string | URL to view the space in Confluence |
12641304
| `nextCursor` | string | Cursor for fetching the next page of results |
12651305

12661306
</ReferenceDetails>

0 commit comments

Comments
 (0)