@devries-cameron20 / t3code Mirror · read-only
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

Mirrored from https://github.com/Camo67/t3code.git

Synced Nov 21, 03:37 UTC

main
graphql 53,680 lines 1.3 MB
Raw
Large file — syntax highlighting disabled.
1 schema {
2 query: Query
3 mutation: Mutation
4 subscription: Subscription
5 }
6
7 "Indicates exactly one field must be supplied and this field must not be `null`."
8 directive @oneOf on INPUT_OBJECT
9
10 """
11 A release returned using a release pipeline access key.
12 """
13 type AccessKeyRelease {
14 """
15 The time at which the release was archived. Null if the release has not been archived.
16 """
17 archivedAt: DateTime
18 """
19 The Git commit SHA associated with the release.
20 """
21 commitSha: String
22 """
23 The time at which the release was completed. Null if the release has not been completed.
24 """
25 completedAt: DateTime
26 """
27 The time at which the release was created.
28 """
29 createdAt: DateTime!
30 """
31 The unique identifier of the release.
32 """
33 id: ID!
34 """
35 The name of the release.
36 """
37 name: String!
38 """
39 The current stage of the release.
40 """
41 stage: AccessKeyReleaseStage!
42 """
43 The URL to the release page in the Linear app.
44 """
45 url: String!
46 """
47 The version identifier for this release. Null if no version has been assigned.
48 """
49 version: String
50 }
51
52 """
53 The result of a release mutation using a release pipeline access key.
54 """
55 type AccessKeyReleasePayload {
56 """
57 The identifier of the last sync operation.
58 """
59 lastSyncId: Float!
60 """
61 The release that was created or updated.
62 """
63 release: AccessKeyRelease!
64 """
65 Whether the operation was successful.
66 """
67 success: Boolean!
68 }
69
70 """
71 A release pipeline returned using a release pipeline access key.
72 """
73 type AccessKeyReleasePipeline {
74 """
75 The unique identifier of the release pipeline.
76 """
77 id: ID!
78 """
79 Glob patterns used to filter commits by changed file path. An empty array means all commits are included.
80 """
81 includePathPatterns: [String!]!
82 }
83
84 """
85 A release stage returned using a release pipeline access key.
86 """
87 type AccessKeyReleaseStage {
88 """
89 The name of the release stage.
90 """
91 name: String!
92 """
93 The type of the release stage.
94 """
95 type: ReleaseStageType!
96 }
97
98 """
99 Activity collection filtering options.
100 """
101 input ActivityCollectionFilter {
102 """
103 Compound filters, all of which need to be matched by the activity.
104 """
105 and: [ActivityCollectionFilter!]
106 """
107 Comparator for the created at date.
108 """
109 createdAt: DateComparator
110 """
111 Filters that needs to be matched by all activities.
112 """
113 every: ActivityFilter
114 """
115 Comparator for the identifier.
116 """
117 id: IDComparator
118 """
119 Comparator for the collection length.
120 """
121 length: NumberComparator
122 """
123 Compound filters, one of which need to be matched by the activity.
124 """
125 or: [ActivityCollectionFilter!]
126 """
127 Filters that needs to be matched by some activities.
128 """
129 some: ActivityFilter
130 """
131 Comparator for the updated at date.
132 """
133 updatedAt: DateComparator
134 """
135 Filters that the activity's user must satisfy.
136 """
137 user: UserFilter
138 }
139
140 """
141 Activity filtering options.
142 """
143 input ActivityFilter {
144 """
145 Compound filters, all of which need to be matched by the activity.
146 """
147 and: [ActivityFilter!]
148 """
149 Comparator for the created at date.
150 """
151 createdAt: DateComparator
152 """
153 Comparator for the identifier.
154 """
155 id: IDComparator
156 """
157 Compound filters, one of which need to be matched by the activity.
158 """
159 or: [ActivityFilter!]
160 """
161 Comparator for the updated at date.
162 """
163 updatedAt: DateComparator
164 """
165 Filters that the activity's user must satisfy.
166 """
167 user: UserFilter
168 }
169
170 """
171 A bot actor representing a non-human entity that performed an action, such as an integration (GitHub, Slack, Zendesk), an AI assistant, or an automated workflow. Bot actors are displayed in activity feeds and history to indicate when changes were made by applications rather than users.
172 """
173 type ActorBot {
174 """
175 A URL pointing to the avatar image representing this bot, typically the integration's logo or icon.
176 """
177 avatarUrl: String
178 """
179 A unique identifier for the bot actor.
180 """
181 id: ID
182 """
183 The display name of the bot.
184 """
185 name: String
186 """
187 A more specific classification within the bot type, providing additional context about the integration or application variant.
188 """
189 subType: String
190 """
191 The source type of the bot, identifying the application or integration (e.g., 'github', 'slack', 'workflow', 'ai').
192 """
193 type: String!
194 """
195 The display name of the external user on behalf of whom the bot acted. Shown when an integration action was triggered by a specific person in the external system.
196 """
197 userDisplayName: String
198 }
199
200 """
201 An activity performed by or directed at an AI coding agent during a session. Activities represent the observable steps of an agent's work, including thoughts, actions (tool calls), responses, prompts from users, errors, and elicitation requests. Each activity belongs to an agent session and is associated with the user who initiated it.
202 """
203 type AgentActivity implements Node {
204 """
205 The agent session this activity belongs to.
206 """
207 agentSession: AgentSession!
208 """
209 The time at which the entity was archived. Null if the entity has not been archived.
210 """
211 archivedAt: DateTime
212 """
213 The content of the activity, which varies by type (thought, action, response, prompt, error, or elicitation).
214 """
215 content: AgentActivityContent!
216 """
217 [Internal] Metadata about user-provided contextual information for this agent activity.
218 """
219 contextualMetadata: JSON
220 """
221 The time at which the entity was created.
222 """
223 createdAt: DateTime!
224 """
225 Whether the activity is ephemeral, and should disappear after the next agent activity.
226 """
227 ephemeral: Boolean!
228 """
229 [Internal] The reason this activity was persisted without being sent to the agent runtime.
230 """
231 executionSkippedReason: AgentActivityExecutionSkippedReason
232 """
233 The unique identifier of the entity.
234 """
235 id: ID!
236 """
237 [Internal] What the turn pushed to its branch, captured in the sandbox at push time. Only set on the activity for a successful push.
238 """
239 pushSummary: AgentActivityPushSummary
240 """
241 [Internal] Whether this activity is queued for later processing. Queued activities are not sent to the agent until the session reaches a terminal state.
242 """
243 queued: Boolean!
244 """
245 [Internal] The time at which the prompt actually entered the conversation. Only set when the prompt did not enter the conversation immediately (i.e., it was queued and later dequeued). Null for prompts that were sent directly and for non-prompt activities.
246 """
247 sentAt: DateTime
248 """
249 An optional modifier that provides additional instructions on how the activity should be interpreted.
250 """
251 signal: AgentActivitySignal
252 """
253 Metadata about this agent activity's signal.
254 """
255 signalMetadata: JSON
256 """
257 The source comment this activity is linked to. Null if the activity was not triggered by a comment.
258 """
259 sourceComment: Comment
260 """
261 Metadata about the external source that created this agent activity.
262 """
263 sourceMetadata: JSON
264 """
265 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
266 been updated after creation.
267 """
268 updatedAt: DateTime!
269 """
270 The user who created this agent activity.
271 """
272 user: User!
273 }
274
275 """
276 Content for an action activity (tool call or action).
277 """
278 type AgentActivityActionContent {
279 """
280 The action being performed.
281 """
282 action: String!
283 """
284 The parameters for the action, e.g. a file path, a keyword, etc.
285 """
286 parameter: String!
287 """
288 The result of the action in Markdown format.
289 """
290 result: String
291 """
292 [Internal] The result content as ProseMirror document.
293 """
294 resultData: JSONObject
295 """
296 The type of activity.
297 """
298 type: AgentActivityType!
299 }
300
301 type AgentActivityConnection {
302 edges: [AgentActivityEdge!]!
303 nodes: [AgentActivity!]!
304 pageInfo: PageInfo!
305 }
306
307 """
308 Content for different types of agent activities.
309 """
310 union AgentActivityContent =
311 | AgentActivityActionContent
312 | AgentActivityElicitationContent
313 | AgentActivityErrorContent
314 | AgentActivityPromptContent
315 | AgentActivityResponseContent
316 | AgentActivityThoughtContent
317
318 """
319 Input for creating an agent activity.
320 """
321 input AgentActivityCreateInput {
322 """
323 The agent session this activity belongs to.
324 """
325 agentSessionId: String!
326 """
327 The content payload of the agent activity. This object is not strictly typed.
328 See https://linear.app/developers/agent-interaction#activity-content-payload for typing details.
329 """
330 content: JSONObject!
331 """
332 [Internal] Metadata about user-provided contextual information for this agent activity.
333 """
334 contextualMetadata: JSONObject
335 """
336 Whether the activity is ephemeral, and should disappear after the next activity. Defaults to false.
337 """
338 ephemeral: Boolean
339 """
340 The identifier in UUID v4 format. If none is provided, the backend will generate one.
341 """
342 id: String
343 """
344 An optional modifier that provides additional instructions on how the activity should be interpreted.
345 """
346 signal: AgentActivitySignal
347 """
348 Metadata about this agent activity's signal.
349 """
350 signalMetadata: JSONObject
351 }
352
353 """
354 [Internal] Input for creating prompt-type agent activities (created by users).
355 """
356 input AgentActivityCreatePromptInput {
357 """
358 The agent session this activity belongs to.
359 """
360 agentSessionId: String!
361 """
362 The content payload of the prompt agent activity.
363 """
364 content: AgentActivityPromptCreateInputContent!
365 """
366 [Internal] Metadata about user-provided contextual information for this agent activity.
367 """
368 contextualMetadata: JSONObject
369 """
370 The identifier in UUID v4 format. If none is provided, the backend will generate one.
371 """
372 id: String
373 """
374 [Internal] If true, the activity is queued and will be sent to the agent when it finishes its current task.
375 """
376 queued: Boolean
377 """
378 An optional modifier that provides additional instructions on how the activity should be interpreted.
379 """
380 signal: AgentActivitySignal
381 """
382 Metadata about this agent activity's signal.
383 """
384 signalMetadata: JSONObject
385 """
386 The comment that contains the content of this activity.
387 """
388 sourceCommentId: String
389 }
390
391 type AgentActivityEdge {
392 """
393 Used in `before` and `after` args
394 """
395 cursor: String!
396 node: AgentActivity!
397 }
398
399 """
400 Content for an elicitation activity.
401 """
402 type AgentActivityElicitationContent {
403 """
404 The elicitation message in Markdown format.
405 """
406 body: String!
407 """
408 [Internal] The elicitation content as ProseMirror document.
409 """
410 bodyData: JSONObject!
411 """
412 The type of activity.
413 """
414 type: AgentActivityType!
415 }
416
417 """
418 Content for an error activity.
419 """
420 type AgentActivityErrorContent {
421 """
422 The error message in Markdown format.
423 """
424 body: String!
425 """
426 [Internal] The error content as ProseMirror document.
427 """
428 bodyData: JSONObject!
429 """
430 A stable reason code for specialized error handling.
431 """
432 reasonCode: String
433 """
434 The type of activity.
435 """
436 type: AgentActivityType!
437 }
438
439 """
440 The reason an agent activity was persisted without being sent to the agent runtime.
441 """
442 enum AgentActivityExecutionSkippedReason {
443 permissionDenied
444 quotaExceeded
445 }
446
447 """
448 Agent activity filtering options.
449 """
450 input AgentActivityFilter {
451 """
452 Comparator for the agent session ID.
453 """
454 agentSessionId: StringComparator
455 """
456 Compound filters, all of which need to be matched by the agent activity.
457 """
458 and: [AgentActivityFilter!]
459 """
460 Comparator for the created at date.
461 """
462 createdAt: DateComparator
463 """
464 Comparator for the identifier.
465 """
466 id: IDComparator
467 """
468 Compound filters, one of which need to be matched by the agent activity.
469 """
470 or: [AgentActivityFilter!]
471 """
472 Filters that the source comment must satisfy.
473 """
474 sourceComment: NullableCommentFilter
475 """
476 Comparator for the agent activity's content type.
477 """
478 type: StringComparator
479 """
480 Comparator for the updated at date.
481 """
482 updatedAt: DateComparator
483 }
484
485 """
486 The result of an agent activity mutation.
487 """
488 type AgentActivityPayload {
489 """
490 The agent activity that was created or updated.
491 """
492 agentActivity: AgentActivity!
493 """
494 The identifier of the last sync operation.
495 """
496 lastSyncId: Float!
497 """
498 Whether the operation was successful.
499 """
500 success: Boolean!
501 }
502
503 """
504 Content for a prompt activity.
505 """
506 type AgentActivityPromptContent {
507 """
508 A message requesting additional information or action from user.
509 """
510 body: String!
511 """
512 [Internal] The prompt content as ProseMirror document.
513 """
514 bodyData: JSONObject!
515 """
516 A short title capturing the intent of the prompt.
517 """
518 title: String
519 """
520 The type of activity.
521 """
522 type: AgentActivityType!
523 }
524
525 """
526 [Internal] Input for creating prompt-type agent activities (created by users).
527 """
528 input AgentActivityPromptCreateInputContent {
529 """
530 A message requesting additional information or action from user in markdown format.
531 """
532 body: String
533 """
534 [Internal] The prompt content as a ProseMirror document.
535 """
536 bodyData: JSON
537 """
538 The type of activity.
539 """
540 type: AgentActivityType! = prompt
541 }
542
543 """
544 [Internal] Diff stats for a single commit a coding agent turn pushed, measured in the sandbox at push time.
545 """
546 type AgentActivityPushCommit {
547 """
548 The number of lines the commit added across the files it touched.
549 """
550 additions: Int!
551 """
552 The number of files the commit changed.
553 """
554 changedFiles: Int!
555 """
556 The number of lines the commit removed across the files it touched.
557 """
558 deletions: Int!
559 """
560 The commit sha.
561 """
562 sha: String!
563 }
564
565 """
566 [Internal] What a coding agent turn pushed to its branch, measured in the sandbox at push time. The range is cumulative within a turn, so a turn that pushes several times reports every commit each time — consumers use the last summary in a turn rather than combining across pushes.
567 """
568 type AgentActivityPushSummary {
569 """
570 Shas of the turn's commits beyond the detailed cap, newest first. Stats aren't captured for these.
571 """
572 additionalCommitShas: [String!]!
573 """
574 The commit the turn started from — the sandbox HEAD when the prompt began.
575 """
576 baseSha: String!
577 """
578 The number of non-merge commits the turn added. Equals the length of commits plus additionalCommitShas.
579 """
580 commitCount: Int!
581 """
582 The turn's non-merge commits with stats, newest first. Capped, so it may hold fewer commits than commitCount reports.
583 """
584 commits: [AgentActivityPushCommit!]!
585 """
586 The commit that was pushed.
587 """
588 headSha: String!
589 }
590
591 """
592 Content for a response activity.
593 """
594 type AgentActivityResponseContent {
595 """
596 The response content in Markdown format.
597 """
598 body: String!
599 """
600 [Internal] The response content as ProseMirror document.
601 """
602 bodyData: JSONObject!
603 """
604 The type of activity.
605 """
606 type: AgentActivityType!
607 }
608
609 """
610 A modifier that provides additional instructions on how the activity should be interpreted.
611 """
612 enum AgentActivitySignal {
613 auth
614 continue
615 select
616 stop
617 }
618
619 """
620 Content for a thought activity.
621 """
622 type AgentActivityThoughtContent {
623 """
624 The thought content in Markdown format.
625 """
626 body: String!
627 """
628 [Internal] The thought content as ProseMirror document.
629 """
630 bodyData: JSONObject!
631 """
632 The type of activity.
633 """
634 type: AgentActivityType!
635 }
636
637 """
638 The type of an agent activity.
639 """
640 enum AgentActivityType {
641 action
642 elicitation
643 error
644 prompt
645 response
646 thought
647 }
648
649 """
650 Payload for an agent activity webhook.
651 """
652 type AgentActivityWebhookPayload {
653 """
654 The ID of the agent session that this activity belongs to.
655 """
656 agentSessionId: String!
657 """
658 The time at which the entity was archived.
659 """
660 archivedAt: String
661 """
662 The content of the agent activity.
663 """
664 content: JSONObject!
665 """
666 The time at which the entity was created.
667 """
668 createdAt: String!
669 """
670 The ID of the entity.
671 """
672 id: String!
673 """
674 An optional modifier that provides additional instructions on how the activity should be interpreted.
675 """
676 signal: String
677 """
678 Metadata about this agent activity's signal.
679 """
680 signalMetadata: JSONObject
681 """
682 The ID of the comment this activity is linked to.
683 """
684 sourceCommentId: String
685 """
686 The time at which the entity was updated.
687 """
688 updatedAt: String!
689 """
690 The user who created this agent activity.
691 """
692 user: UserChildWebhookPayload!
693 """
694 The ID of the user who created this agent activity.
695 """
696 userId: String!
697 }
698
699 """
700 The outcome of retrying a loop run blocked by its trusted-source policy.
701 """
702 type AgentAutomationRetryResolution {
703 """
704 Identifier of the replacement AI conversation. Null when no replacement run was scheduled.
705 """
706 aiConversationId: String
707 """
708 Whether a replacement run was scheduled or the loop could no longer be retried.
709 """
710 status: AgentAutomationRetryResolutionStatus!
711 }
712
713 """
714 The outcome of reconsidering a loop run blocked by its trusted-source policy.
715 """
716 enum AgentAutomationRetryResolutionStatus {
717 notScheduled
718 scheduled
719 }
720
721 """
722 The scope of the usage limit that blocked a loop run: the loop's own limit or the workspace-wide limit.
723 """
724 enum AgentAutomationUsageLimitScope {
725 loop
726 workspace
727 }
728
729 """
730 A session representing an AI coding agent's work on an issue or conversation. Agent sessions track the lifecycle of an agent's engagement, from creation through active work to completion or dismissal. Each session is associated with an agent user (the bot), optionally a human creator, an issue, and a comment thread where the agent posts updates. Sessions contain activities that record the agent's observable steps and can be linked to pull requests created during the work.
731 """
732 type AgentSession implements Node {
733 """
734 Activities associated with this agent session.
735 """
736 activities(
737 """
738 A cursor to be used with first for forward pagination
739 """
740 after: String
741 """
742 A cursor to be used with last for backward pagination.
743 """
744 before: String
745 """
746 Filter returned agent activities.
747 """
748 filter: AgentActivityFilter
749 """
750 The number of items to forward paginate (used with after). Defaults to 50.
751 """
752 first: Int
753 """
754 Should archived resources be included (default: false)
755 """
756 includeArchived: Boolean
757 """
758 The number of items to backward paginate (used with before). Defaults to 50.
759 """
760 last: Int
761 """
762 By which field should the pagination order by. Available options are createdAt (default) and updatedAt.
763 """
764 orderBy: PaginationOrderBy
765 ): AgentActivityConnection!
766 """
767 The agent user that is associated with this agent session.
768 """
769 appUser: User!
770 """
771 The time at which the entity was archived. Null if the entity has not been archived.
772 """
773 archivedAt: DateTime
774 """
775 [Internal] Coding harness metadata for this cloud or local session.
776 """
777 codingHarness: AgentSessionCodingHarness
778 """
779 [Internal] Compact display label for the coding harness model used by this cloud or local session.
780 """
781 codingHarnessModelLabel: String
782 """
783 The comment this agent session is associated with.
784 """
785 comment: Comment
786 """
787 The entity contexts this session is related to, such as issues or projects referenced in direct chat sessions. Used to provide contextual awareness to the agent.
788 """
789 context: JSON!
790 """
791 The time at which the entity was created.
792 """
793 createdAt: DateTime!
794 """
795 The human user responsible for the agent session. Null if the session was initiated via automation or by an agent user, with no responsible human user.
796 """
797 creator: User
798 """
799 The time a user dismissed this agent session. When dismissed, the agent is removed as delegate from the associated issue. Null if the session has not been dismissed.
800 """
801 dismissedAt: DateTime
802 """
803 The user who dismissed the agent session. Automatically set when dismissedAt is updated. Null if the session has not been dismissed.
804 """
805 dismissedBy: User
806 """
807 The time the agent session completed. Null if the session is still in progress or was dismissed before completion.
808 """
809 endedAt: DateTime
810 """
811 The URL of an external agent-hosted page associated with this session.
812 """
813 externalLink: String @deprecated(reason: "Use externalUrls instead.")
814 """
815 External links associated with this session.
816 """
817 externalLinks: [AgentSessionExternalLink!]!
818 """
819 URLs of external resources associated with this session.
820 """
821 externalUrls: JSON! @deprecated(reason: "Use externalLinks instead.")
822 """
823 The unique identifier of the entity.
824 """
825 id: ID!
826 """
827 The issue this agent session is associated with.
828 """
829 issue: Issue
830 """
831 [Internal] How Adaptive selected the model route used by this coding session.
832 """
833 modelSelection: JSON
834 """
835 A dynamically updated plan describing the agent's execution strategy, including steps to be taken and their current status. Updated as the agent progresses through its work. Null if no plan has been set.
836 """
837 plan: JSON
838 """
839 The pull request this agent session is anchored to, when started from a pull request.
840 """
841 pullRequest: PullRequest
842 """
843 [Internal] Pull requests associated with this agent session.
844 """
845 pullRequests(
846 """
847 A cursor to be used with first for forward pagination
848 """
849 after: String
850 """
851 A cursor to be used with last for backward pagination.
852 """
853 before: String
854 """
855 The number of items to forward paginate (used with after). Defaults to 50.
856 """
857 first: Int
858 """
859 Should archived resources be included (default: false)
860 """
861 includeArchived: Boolean
862 """
863 The number of items to backward paginate (used with before). Defaults to 50.
864 """
865 last: Int
866 """
867 By which field should the pagination order by. Available options are createdAt (default) and updatedAt.
868 """
869 orderBy: PaginationOrderBy
870 ): AgentSessionToPullRequestConnection!
871 """
872 The agent session's unique URL slug.
873 """
874 slugId: String!
875 """
876 The comment that this agent session was spawned from, if from a different thread.
877 """
878 sourceComment: Comment
879 """
880 Metadata about the external source that created this agent session.
881 """
882 sourceMetadata: JSON
883 """
884 The time the agent session transitioned to active status and began work. Null if the session has not yet started.
885 """
886 startedAt: DateTime
887 """
888 The current status of the agent session, such as pending, active, stopping, awaiting input, complete, error, or stale.
889 """
890 status: AgentSessionStatus!
891 """
892 The session title, generated automatically or set by the owning OAuth application. Null if no title is set.
893 """
894 summary: String
895 """
896 [DEPRECATED] The type of the agent session.
897 """
898 type: AgentSessionType @deprecated(reason: "This field is slated for removal.")
899 """
900 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
901 been updated after creation.
902 """
903 updatedAt: DateTime!
904 """
905 The URL to the agent session page in the Linear app. Null when no issue is associated.
906 """
907 url: String
908 """
909 [Internal] Legacy live working-tree diff metadata. Null when the sandbox is in sync.
910 """
911 workspaceDiff: JSON @deprecated(reason: "Use the session's Diff model instead.")
912 """
913 [Internal] Legacy per-file metadata for the agent session's live working-tree diff.
914 """
915 workspaceDiffFiles(
916 """
917 The diff content hash from workspaceDiff.
918 """
919 contentHash: String!
920 ): [AgentSessionWorkspaceDiffFile!] @deprecated(reason: "Use Diff.files instead.")
921 }
922
923 """
924 [Internal] Coding harness metadata for a cloud or local coding session.
925 """
926 type AgentSessionCodingHarness {
927 """
928 The coding harness or local target used by the session.
929 """
930 harness: String!
931 """
932 Compact display label for the model used by the session.
933 """
934 modelLabel: String!
935 }
936
937 type AgentSessionConnection {
938 edges: [AgentSessionEdge!]!
939 nodes: [AgentSession!]!
940 pageInfo: PageInfo!
941 }
942
943 """
944 [Internal] Input for creating an agent session on behalf of the current user.
945 """
946 input AgentSessionCreateInput {
947 """
948 The app user (agent) to create a session for.
949 """
950 appUserId: String!
951 """
952 [Internal] No longer supported.
953 """
954 context: JSONObject
955 """
956 The identifier in UUID v4 format. If none is provided, the backend will generate one.
957 """
958 id: String
959 """
960 The issue that this session will be associated with. Can be a UUID or issue identifier (e.g., 'LIN-123').
961 """
962 issueId: String
963 }
964
965 """
966 Input for creating an agent session on a root comment.
967 """
968 input AgentSessionCreateOnComment {
969 """
970 The root comment that this session will be associated with.
971 """
972 commentId: String!
973 """
974 The URL of an external agent-hosted page associated with this session.
975 """
976 externalLink: String
977 """
978 URLs of external resources associated with this session.
979 """
980 externalUrls: [AgentSessionExternalUrlInput!]
981 }
982
983 """
984 Input for creating an agent session on an issue.
985 """
986 input AgentSessionCreateOnIssue {
987 """
988 The URL of an external agent-hosted page associated with this session.
989 """
990 externalLink: String
991 """
992 URLs of external resources associated with this session.
993 """
994 externalUrls: [AgentSessionExternalUrlInput!]
995 """
996 The issue that this session will be associated with. Can be a UUID or issue identifier (e.g., 'LIN-123').
997 """
998 issueId: String!
999 }
1000
1001 type AgentSessionEdge {
1002 """
1003 Used in `before` and `after` args
1004 """
1005 cursor: String!
1006 node: AgentSession!
1007 }
1008
1009 """
1010 Payload for agent session webhook events.
1011 """
1012 type AgentSessionEventWebhookPayload {
1013 """
1014 The type of action that triggered the webhook.
1015 """
1016 action: String!
1017 """
1018 The agent activity that was created.
1019 """
1020 agentActivity: AgentActivityWebhookPayload
1021 """
1022 The agent session that the event belongs to.
1023 """
1024 agentSession: AgentSessionWebhookPayload!
1025 """
1026 ID of the app user the agent session belongs to.
1027 """
1028 appUserId: String!
1029 """
1030 The time the payload was created.
1031 """
1032 createdAt: DateTime!
1033 """
1034 Guidance to inform the agent's behavior, which comes from configuration at the level of the workspace, parent teams, and/or current team for this session. The nearest team-specific guidance should take highest precendence.
1035 """
1036 guidance: [GuidanceRuleWebhookPayload!]
1037 """
1038 ID of the OAuth client the app user is tied to.
1039 """
1040 oauthClientId: String!
1041 """
1042 ID of the organization for which the webhook belongs to.
1043 """
1044 organizationId: String!
1045 """
1046 The previous comments in the thread before this agent was mentioned and the session was initiated, if any. Present only for `created` events where the session was initiated by mentioning the agent in a child comment of a thread.
1047 """
1048 previousComments: [CommentChildWebhookPayload!]
1049 """
1050 A formatted prompt string containing the relevant context for the agent session, including issue details, comments, and guidance. Present only for `created` events.
1051 """
1052 promptContext: String
1053 """
1054 The type of resource.
1055 """
1056 type: String!
1057 """
1058 The ID of the webhook that sent this event.
1059 """
1060 webhookId: String!
1061 """
1062 Unix timestamp in milliseconds when the webhook was sent.
1063 """
1064 webhookTimestamp: Float!
1065 }
1066
1067 """
1068 An external link associated with an agent session.
1069 """
1070 type AgentSessionExternalLink {
1071 """
1072 Label for the link.
1073 """
1074 label: String!
1075 """
1076 The URL of the external resource.
1077 """
1078 url: String!
1079 }
1080
1081 """
1082 Input for an external URL associated with an agent session.
1083 """
1084 input AgentSessionExternalUrlInput {
1085 """
1086 Label for the URL.
1087 """
1088 label: String!
1089 """
1090 The URL of the external resource.
1091 """
1092 url: String!
1093 }
1094
1095 type AgentSessionPayload {
1096 """
1097 The agent session that was created or updated.
1098 """
1099 agentSession: AgentSession!
1100 """
1101 The identifier of the last sync operation.
1102 """
1103 lastSyncId: Float!
1104 """
1105 Whether the operation was successful.
1106 """
1107 success: Boolean!
1108 }
1109
1110 """
1111 The status of an agent session.
1112 """
1113 enum AgentSessionStatus {
1114 active
1115 awaitingInput
1116 complete
1117 error
1118 pending
1119 stale
1120 stopping
1121 }
1122
1123 """
1124 A link between an agent session and a pull request created or associated during that session. This join entity tracks which pull requests were produced by or connected to a coding agent's work session, and handles backfilling links when pull requests are synced after the agent has already recorded the URL.
1125 """
1126 type AgentSessionToPullRequest implements Node {
1127 """
1128 The agent session that the pull request is associated with.
1129 """
1130 agentSession: AgentSession!
1131 """
1132 The time at which the entity was archived. Null if the entity has not been archived.
1133 """
1134 archivedAt: DateTime
1135 """
1136 The time at which the entity was created.
1137 """
1138 createdAt: DateTime!
1139 """
1140 The unique identifier of the entity.
1141 """
1142 id: ID!
1143 """
1144 The pull request that the agent session is associated with.
1145 """
1146 pullRequest: PullRequest!
1147 """
1148 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
1149 been updated after creation.
1150 """
1151 updatedAt: DateTime!
1152 }
1153
1154 type AgentSessionToPullRequestConnection {
1155 edges: [AgentSessionToPullRequestEdge!]!
1156 nodes: [AgentSessionToPullRequest!]!
1157 pageInfo: PageInfo!
1158 }
1159
1160 type AgentSessionToPullRequestEdge {
1161 """
1162 Used in `before` and `after` args
1163 """
1164 cursor: String!
1165 node: AgentSessionToPullRequest!
1166 }
1167
1168 """
1169 [DEPRECATED] The type of an agent session.
1170 """
1171 enum AgentSessionType {
1172 commentThread
1173 }
1174
1175 """
1176 Input for updating the external URLs of an agent session.
1177 """
1178 input AgentSessionUpdateExternalUrlInput {
1179 """
1180 URLs of external resources to be added to this session.
1181 """
1182 addedExternalUrls: [AgentSessionExternalUrlInput!]
1183 """
1184 The URL of an external agent-hosted page associated with this session.
1185 """
1186 externalLink: String
1187 """
1188 URLs of external resources associated with this session. Replaces existing URLs.
1189 """
1190 externalUrls: [AgentSessionExternalUrlInput!]
1191 """
1192 URLs to be removed from this session.
1193 """
1194 removedExternalUrls: [String!]
1195 }
1196
1197 """
1198 Input for updating an agent session.
1199 """
1200 input AgentSessionUpdateInput {
1201 """
1202 URLs of external resources to be added to this session. Only updatable by the OAuth application that owns the session.
1203 """
1204 addedExternalUrls: [AgentSessionExternalUrlInput!]
1205 """
1206 [Internal] The time at which the agent session was dismissed. Set to null to un-dismiss. Only updatable by internal clients.
1207 """
1208 dismissedAt: DateTime
1209 """
1210 The URL of an external agent-hosted page associated with this session. Only updatable by the OAuth application that owns the session.
1211 """
1212 externalLink: String
1213 """
1214 URLs of external resources associated with this session. Replaces existing URLs. Only updatable by the OAuth application that owns the session. If supplied, addedExternalUrls and removedExternalUrls are ignored.
1215 """
1216 externalUrls: [AgentSessionExternalUrlInput!]
1217 """
1218 A dynamically updated list of the agent's execution strategy. Only updatable by the OAuth application that owns the session.
1219 """
1220 plan: JSONObject
1221 """
1222 URLs to be removed from this session. Only updatable by the OAuth application that owns the session.
1223 """
1224 removedExternalUrls: [String!]
1225 """
1226 The session title, displayed as its summary. Must contain 1 to 255 characters, including a non-whitespace character, with no line breaks or NUL bytes. Set to null to clear it and allow automatic title generation. Updating only this field does not acknowledge the session. Only updatable by the OAuth application that owns the session.
1227 """
1228 summary: String
1229 """
1230 [Internal] User-specific state for the agent session. Only updatable by internal clients.
1231 """
1232 userState: [AgentSessionUserStateInput!]
1233 }
1234
1235 input AgentSessionUserStateInput {
1236 """
1237 The time at which the user most recently viewed the session.
1238 """
1239 lastReadAt: DateTime
1240 """
1241 The ID of the user this state belongs to.
1242 """
1243 userId: String!
1244 }
1245
1246 """
1247 Payload for an agent session webhook.
1248 """
1249 type AgentSessionWebhookPayload {
1250 """
1251 The ID of the agent that the agent session belongs to.
1252 """
1253 appUserId: String!
1254 """
1255 The time at which the entity was archived.
1256 """
1257 archivedAt: String
1258 """
1259 The root comment of the thread this agent session is attached to.
1260 """
1261 comment: CommentChildWebhookPayload
1262 """
1263 The ID of the root comment of the thread this agent session is attached to.
1264 """
1265 commentId: String
1266 """
1267 The time at which the entity was created.
1268 """
1269 createdAt: String!
1270 """
1271 The human user responsible for the agent session. Unset if the session was initiated via automation or by an agent user, with no responsible human user.
1272 """
1273 creator: UserChildWebhookPayload
1274 """
1275 The ID of the human user responsible for the agent session. Unset if the session was initiated via automation or by an agent user, with no responsible human user.
1276 """
1277 creatorId: String
1278 """
1279 The time the agent session ended.
1280 """
1281 endedAt: String
1282 """
1283 The ID of the entity.
1284 """
1285 id: String!
1286 """
1287 The issue this agent session is associated with.
1288 """
1289 issue: IssueWithDescriptionChildWebhookPayload
1290 """
1291 The ID of the issue this agent session is associated with.
1292 """
1293 issueId: String
1294 """
1295 The ID of the organization that the agent session belongs to.
1296 """
1297 organizationId: String!
1298 """
1299 The ID of the comment that this agent session was spawned from, if from a different thread.
1300 """
1301 sourceCommentId: String
1302 """
1303 Metadata about the external source that created this agent session.
1304 """
1305 sourceMetadata: JSONObject
1306 """
1307 The time the agent session started working.
1308 """
1309 startedAt: String
1310 """
1311 The current status of the agent session.
1312 """
1313 status: String!
1314 """
1315 A summary of the activities in this session.
1316 """
1317 summary: String
1318 """
1319 The type of the agent session.
1320 """
1321 type: String!
1322 """
1323 The time at which the entity was updated.
1324 """
1325 updatedAt: String!
1326 """
1327 The URL of the agent session.
1328 """
1329 url: String
1330 }
1331
1332 """
1333 [Internal] One changed file in a coding agent's live working-tree diff.
1334 """
1335 type AgentSessionWorkspaceDiffFile {
1336 """
1337 Lines added in this file.
1338 """
1339 additions: Int!
1340 """
1341 Lines removed in this file.
1342 """
1343 deletions: Int!
1344 """
1345 Previous path, when the file was renamed or copied.
1346 """
1347 oldPath: String
1348 """
1349 Path of the changed file (the new path, for renames).
1350 """
1351 path: String!
1352 """
1353 Kind of change: added, modified, deleted, renamed, copied, type_changed, unmerged, unknown.
1354 """
1355 state: String!
1356 }
1357
1358 """
1359 A user-defined skill that can be saved and reused in conversations with the Linear Agent. Skills can be private to a user or shared with a team.
1360 """
1361 type AgentSkill implements Node {
1362 """
1363 The time at which the entity was archived. Null if the entity has not been archived.
1364 """
1365 archivedAt: DateTime
1366 """
1367 The skill instructions in markdown format.
1368 """
1369 body: String!
1370 """
1371 The skill's color. Null if no color is set.
1372 """
1373 color: String
1374 """
1375 The time at which the entity was created.
1376 """
1377 createdAt: DateTime!
1378 """
1379 The user who created the skill.
1380 """
1381 creator: User!
1382 """
1383 The skill's description. Null if no description has been generated.
1384 """
1385 description: String
1386 """
1387 The icon of the skill. Null if no icon is set.
1388 """
1389 icon: String
1390 """
1391 The unique identifier of the entity.
1392 """
1393 id: ID!
1394 """
1395 The parent-team skill this skill was inherited from. Null if the skill is not inherited.
1396 """
1397 inheritedFrom: AgentSkill
1398 """
1399 The user who last updated the skill. Null if unknown.
1400 """
1401 lastUpdatedBy: User
1402 """
1403 The time the skill was last used by anyone in the workspace. Null if it has never been used.
1404 """
1405 lastUsedAt: DateTime
1406 """
1407 The user who owns the skill.
1408 """
1409 owner: User!
1410 """
1411 The number of times the skill was used by anyone in the workspace in the last 30 days.
1412 """
1413 recentUsageCount: Float!
1414 """
1415 Whether the skill is shared with everyone in the workspace. When false, only the owner can use the skill.
1416 """
1417 shared: Boolean!
1418 """
1419 The skill's unique URL slug.
1420 """
1421 slugId: String!
1422 """
1423 The identifier of the team this skill is shared with.
1424 """
1425 teamId: String
1426 """
1427 The skill's title.
1428 """
1429 title: String!
1430 """
1431 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
1432 been updated after creation.
1433 """
1434 updatedAt: DateTime!
1435 }
1436
1437 type AgentSkillConnection {
1438 edges: [AgentSkillEdge!]!
1439 nodes: [AgentSkill!]!
1440 pageInfo: PageInfo!
1441 }
1442
1443 """
1444 Input for creating an agent skill.
1445 """
1446 input AgentSkillCreateInput {
1447 """
1448 The skill instructions in markdown format.
1449 """
1450 body: String!
1451 """
1452 The color of the skill icon.
1453 """
1454 color: String
1455 """
1456 The icon of the skill.
1457 """
1458 icon: String
1459 """
1460 The identifier in UUID v4 format. If none is provided, the backend will generate one.
1461 """
1462 id: String
1463 """
1464 The team to associate the skill with.
1465 """
1466 teamId: String
1467 """
1468 The title of the skill.
1469 """
1470 title: String
1471 }
1472
1473 type AgentSkillEdge {
1474 """
1475 Used in `before` and `after` args
1476 """
1477 cursor: String!
1478 node: AgentSkill!
1479 }
1480
1481 """
1482 Agent skill filtering options.
1483 """
1484 input AgentSkillFilter {
1485 """
1486 Compound filters, all of which need to be matched by the agent skill.
1487 """
1488 and: [AgentSkillFilter!]
1489 """
1490 Comparator for the created at date.
1491 """
1492 createdAt: DateComparator
1493 """
1494 Comparator for the identifier.
1495 """
1496 id: IDComparator
1497 """
1498 Compound filters, one of which need to be matched by the agent skill.
1499 """
1500 or: [AgentSkillFilter!]
1501 """
1502 Comparator for the skill owner's user ID.
1503 """
1504 ownerId: IDComparator
1505 """
1506 Comparator for whether the skill is shared with the workspace.
1507 """
1508 shared: BooleanComparator
1509 """
1510 Filters that the skill's team must satisfy.
1511 """
1512 team: NullableTeamFilter
1513 """
1514 Comparator for the updated at date.
1515 """
1516 updatedAt: DateComparator
1517 }
1518
1519 """
1520 The result of an agent skill mutation.
1521 """
1522 type AgentSkillPayload {
1523 """
1524 The agent skill that was created or updated.
1525 """
1526 agentSkill: AgentSkill!
1527 """
1528 The identifier of the last sync operation.
1529 """
1530 lastSyncId: Float!
1531 """
1532 Whether the operation was successful.
1533 """
1534 success: Boolean!
1535 }
1536
1537 """
1538 Input for updating an agent skill.
1539 """
1540 input AgentSkillUpdateInput {
1541 """
1542 The skill instructions in markdown format.
1543 """
1544 body: String
1545 """
1546 The color of the skill icon.
1547 """
1548 color: String
1549 """
1550 The icon of the skill.
1551 """
1552 icon: String
1553 """
1554 The team to associate the skill with.
1555 """
1556 teamId: String
1557 """
1558 The title of the skill.
1559 """
1560 title: String
1561 }
1562
1563 """
1564 [Internal] A conversation between a user and the Linear AI assistant. Each conversation tracks the full thread state, context references (issues, projects, documents, etc.), and conversation parts (prompts, text responses, tool calls, widgets). Conversations can originate from direct chat, issue comments, Slack threads, Microsoft Teams, or automated workflows.
1565 """
1566 type AiConversation implements Node {
1567 """
1568 The time at which the entity was archived. Null if the entity has not been archived.
1569 """
1570 archivedAt: DateTime
1571 """
1572 The client platform from which this conversation was initiated, such as web, desktop, or mobile.
1573 """
1574 clientPlatform: AiConversationClientPlatform
1575 """
1576 The entity contexts this conversation is related to, such as issues, projects, or documents that provide context for the AI assistant.
1577 """
1578 context: JSONObject!
1579 """
1580 The time at which the entity was created.
1581 """
1582 createdAt: DateTime!
1583 """
1584 [Internal] The live diff that owns this conversation. Ownership moves to the review on promotion.
1585 """
1586 diff: Diff
1587 """
1588 [Internal] The document this shared conversation is attached to. Null if the conversation is private.
1589 """
1590 document: Document
1591 """
1592 [Internal] The log ID of the AI response.
1593 """
1594 evalLogId: String
1595 """
1596 The unique identifier of the entity.
1597 """
1598 id: ID!
1599 """
1600 The source from which this conversation was initiated, such as direct chat, an issue comment, a Slack thread, Microsoft Teams, or a workflow automation.
1601 """
1602 initialSource: AiConversationInitialSource!
1603 """
1604 [Internal] The initiative this shared conversation is attached to. Null if the conversation is private.
1605 """
1606 initiative: Initiative
1607 """
1608 [Internal] The issue this shared conversation is attached to. Null if the conversation is private.
1609 """
1610 issue: Issue
1611 """
1612 The iteration ID when this conversation is part of an agentic workflow. Used to track multi-step workflow executions. Null for non-workflow conversations.
1613 """
1614 iterationId: String
1615 """
1616 [Internal] The Loop execution that created this conversation.
1617 """
1618 loopExecution: LoopExecution
1619 """
1620 The ordered sequence of conversation parts (prompts, text responses, reasoning steps, tool calls, errors, and widgets) that make up this conversation's visible history.
1621 """
1622 parts: [AiConversationPart!]
1623 """
1624 [Internal] The project this shared conversation is attached to. Null if the conversation is private.
1625 """
1626 project: Project
1627 """
1628 [Internal] The pull request this shared conversation is attached to. Null if the conversation is private.
1629 """
1630 pullRequest: PullRequest
1631 """
1632 The time when the current user marked the conversation as read. Null if the user hasn't read the conversation.
1633 """
1634 readAt: DateTime
1635 """
1636 [Internal] The published loop edited by this private setup conversation.
1637 """
1638 setupWorkflowDefinition: WorkflowDefinition
1639 """
1640 The conversation's unique URL slug.
1641 """
1642 slugId: String!
1643 """
1644 The materialized conversation-level processing summary used by list and gating surfaces. Assistant response lifecycle is recorded on its turn.
1645 """
1646 status: AiConversationStatus!
1647 """
1648 [Internal] Users subscribed to this run.
1649 """
1650 subscriberIds: [String!]
1651 """
1652 A summary of the conversation.
1653 """
1654 summary: String
1655 """
1656 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
1657 been updated after creation.
1658 """
1659 updatedAt: DateTime!
1660 """
1661 The user who the conversation belongs to.
1662 """
1663 user: User
1664 """
1665 [Internal] User-specific state for the AI conversation, including per-user read state.
1666 """
1667 userState: [AiConversationUserState!]!
1668 """
1669 [Internal] The cron workflow definition that created this conversation.
1670 """
1671 workflowCronJobDefinition: WorkflowCronJobDefinition
1672 """
1673 [Internal] The workflow definition that created this conversation.
1674 """
1675 workflowDefinition: WorkflowDefinition
1676 }
1677
1678 """
1679 The kind of acknowledgement the agent expresses when it has nothing meaningful to reply.
1680 """
1681 enum AiConversationAckKind {
1682 done
1683 ignored
1684 skipped
1685 waiting
1686 }
1687
1688 """
1689 A silent acknowledgement emitted by the agent in place of a generated reply.
1690 """
1691 type AiConversationAckPart implements AiConversationBasePart {
1692 """
1693 The ID of the part.
1694 """
1695 id: String!
1696 """
1697 The kind of acknowledgement the agent expressed.
1698 """
1699 kind: AiConversationAckKind!
1700 """
1701 The metadata of the part.
1702 """
1703 metadata: AiConversationPartMetadata!
1704 """
1705 [Internal] A one-line, third-person summary of the action the agent completed. Null when the agent acknowledged without describing an action.
1706 """
1707 summary: String
1708 """
1709 The type of the part.
1710 """
1711 type: AiConversationPartType!
1712 }
1713
1714 """
1715 A base part in an AI conversation.
1716 """
1717 interface AiConversationBasePart {
1718 """
1719 The ID of the part.
1720 """
1721 id: String!
1722 """
1723 The metadata of the part.
1724 """
1725 metadata: AiConversationPartMetadata!
1726 """
1727 The type of the part.
1728 """
1729 type: AiConversationPartType!
1730 }
1731
1732 interface AiConversationBaseToolCall {
1733 displayInfo: AiConversationToolDisplayInfo!
1734 """
1735 The name of the tool that was called.
1736 """
1737 name: AiConversationTool!
1738 """
1739 The arguments of the tool call.
1740 """
1741 rawArgs: JSON
1742 """
1743 The result of the tool call.
1744 """
1745 rawResult: JSON
1746 }
1747
1748 interface AiConversationBaseWidget {
1749 """
1750 Display information for the widget, including ProseMirror and Markdown representations.
1751 """
1752 displayInfo: AiConversationWidgetDisplayInfo
1753 """
1754 The name of the widget.
1755 """
1756 name: AiConversationWidgetName!
1757 """
1758 The arguments of the widget.
1759 """
1760 rawArgs: JSON
1761 }
1762
1763 type AiConversationBashToolCall implements AiConversationBaseToolCall {
1764 """
1765 The arguments to the tool call.
1766 """
1767 args: AiConversationBashToolCallArgs
1768 displayInfo: AiConversationToolDisplayInfo!
1769 """
1770 The name of the tool that was called.
1771 """
1772 name: AiConversationTool!
1773 """
1774 The arguments of the tool call.
1775 """
1776 rawArgs: JSON
1777 """
1778 The result of the tool call.
1779 """
1780 rawResult: JSON
1781 }
1782
1783 type AiConversationBashToolCallArgs {
1784 command: String!
1785 }
1786
1787 """
1788 The client platform from which an AI conversation was initiated.
1789 """
1790 enum AiConversationClientPlatform {
1791 desktop
1792 mobile
1793 web
1794 }
1795
1796 type AiConversationCodeIntelligenceToolCall implements AiConversationBaseToolCall {
1797 """
1798 The arguments to the tool call.
1799 """
1800 args: AiConversationCodeIntelligenceToolCallArgs
1801 displayInfo: AiConversationToolDisplayInfo!
1802 """
1803 The name of the tool that was called.
1804 """
1805 name: AiConversationTool!
1806 """
1807 The arguments of the tool call.
1808 """
1809 rawArgs: JSON
1810 """
1811 The result of the tool call.
1812 """
1813 rawResult: JSON
1814 }
1815
1816 type AiConversationCodeIntelligenceToolCallArgs {
1817 question: String!
1818 }
1819
1820 type AiConversationCodeModeToolCall implements AiConversationBaseToolCall {
1821 """
1822 The arguments to the tool call.
1823 """
1824 args: AiConversationCodeModeToolCallArgs
1825 displayInfo: AiConversationToolDisplayInfo!
1826 """
1827 The name of the tool that was called.
1828 """
1829 name: AiConversationTool!
1830 """
1831 The arguments of the tool call.
1832 """
1833 rawArgs: JSON
1834 """
1835 The result of the tool call.
1836 """
1837 rawResult: JSON
1838 }
1839
1840 type AiConversationCodeModeToolCallArgs {
1841 description: String!
1842 }
1843
1844 """
1845 The response recorded for a confirmation elicitation.
1846 """
1847 type AiConversationConfirmationElicitationResponseData {
1848 """
1849 True when the user confirmed the action.
1850 """
1851 confirmed: Boolean!
1852 """
1853 The kind of elicitation that was answered.
1854 """
1855 kind: AiConversationElicitationKind!
1856 }
1857
1858 type AiConversationContactSupportToolCall implements AiConversationBaseToolCall {
1859 displayInfo: AiConversationToolDisplayInfo!
1860 """
1861 The name of the tool that was called.
1862 """
1863 name: AiConversationTool!
1864 """
1865 The arguments of the tool call.
1866 """
1867 rawArgs: JSON
1868 """
1869 The result of the tool call.
1870 """
1871 rawResult: JSON
1872 }
1873
1874 type AiConversationCreateAgentChatToolCall implements AiConversationBaseToolCall {
1875 """
1876 The arguments to the tool call.
1877 """
1878 args: JSONObject
1879 displayInfo: AiConversationToolDisplayInfo!
1880 """
1881 The name of the tool that was called.
1882 """
1883 name: AiConversationTool!
1884 """
1885 The arguments of the tool call.
1886 """
1887 rawArgs: JSON
1888 """
1889 The result of the tool call.
1890 """
1891 rawResult: JSON
1892 """
1893 The result of the tool call.
1894 """
1895 result: AiConversationCreateAgentChatToolCallResult
1896 }
1897
1898 type AiConversationCreateAgentChatToolCallResult {
1899 conversationId: String!
1900 }
1901
1902 type AiConversationCreateEntityToolCall implements AiConversationBaseToolCall {
1903 """
1904 The arguments to the tool call.
1905 """
1906 args: AiConversationCreateEntityToolCallArgs
1907 displayInfo: AiConversationToolDisplayInfo!
1908 """
1909 The name of the tool that was called.
1910 """
1911 name: AiConversationTool!
1912 """
1913 The arguments of the tool call.
1914 """
1915 rawArgs: JSON
1916 """
1917 The result of the tool call.
1918 """
1919 rawResult: JSON
1920 """
1921 The result of the tool call.
1922 """
1923 result: AiConversationCreateEntityToolCallResult
1924 }
1925
1926 type AiConversationCreateEntityToolCallArgs {
1927 count: Float
1928 type: String!
1929 }
1930
1931 type AiConversationCreateEntityToolCallResult {
1932 createdEntities: [AiConversationCreateEntityToolCallResultCreatedEntities!]
1933 startedAgentSessions: [AiConversationSearchEntitiesToolCallResultEntities!]
1934 }
1935
1936 type AiConversationCreateEntityToolCallResultCreatedEntities {
1937 id: String!
1938 label: String
1939 parent: AiConversationSearchEntitiesToolCallResultEntities
1940 type: String!
1941 }
1942
1943 type AiConversationCreateSandboxToolCall implements AiConversationBaseToolCall {
1944 """
1945 The arguments to the tool call.
1946 """
1947 args: AiConversationCreateSandboxToolCallArgs
1948 displayInfo: AiConversationToolDisplayInfo!
1949 """
1950 The name of the tool that was called.
1951 """
1952 name: AiConversationTool!
1953 """
1954 The arguments of the tool call.
1955 """
1956 rawArgs: JSON
1957 """
1958 The result of the tool call.
1959 """
1960 rawResult: JSON
1961 }
1962
1963 type AiConversationCreateSandboxToolCallArgs {
1964 repository: String
1965 }
1966
1967 type AiConversationDeleteEntityToolCall implements AiConversationBaseToolCall {
1968 """
1969 The arguments to the tool call.
1970 """
1971 args: AiConversationDeleteEntityToolCallArgs
1972 displayInfo: AiConversationToolDisplayInfo!
1973 """
1974 The name of the tool that was called.
1975 """
1976 name: AiConversationTool!
1977 """
1978 The arguments of the tool call.
1979 """
1980 rawArgs: JSON
1981 """
1982 The result of the tool call.
1983 """
1984 rawResult: JSON
1985 """
1986 The result of the tool call.
1987 """
1988 result: AiConversationDeleteEntityToolCallResult
1989 }
1990
1991 type AiConversationDeleteEntityToolCallArgs {
1992 entity: AiConversationSearchEntitiesToolCallResultEntities!
1993 }
1994
1995 type AiConversationDeleteEntityToolCallResult {
1996 deletedEntities: [AiConversationCreateEntityToolCallResultCreatedEntities!]
1997 }
1998
1999 """
2000 The kind of input an AI conversation elicitation asks for.
2001 """
2002 enum AiConversationElicitationKind {
2003 confirmation
2004 entitySelection
2005 integrationConnection
2006 mcpServerConnection
2007 multipleChoice
2008 }
2009
2010 """
2011 A selectable option shown in an AI conversation elicitation.
2012 """
2013 type AiConversationElicitationOption {
2014 """
2015 The short label shown for the option.
2016 """
2017 label: String!
2018 """
2019 The user prompt rendered to the agent when this option is selected. Null when selecting the option only dismisses the elicitation without replying.
2020 """
2021 prompt: String
2022 }
2023
2024 """
2025 A structured request for user input shown with an AI conversation.
2026 """
2027 type AiConversationElicitationPart implements AiConversationBasePart {
2028 """
2029 Entity type for entity selection.
2030 """
2031 entityType: String
2032 """
2033 The ID of the part.
2034 """
2035 id: String!
2036 """
2037 The existing MCP integration to reconnect. Null when creating a new connection.
2038 """
2039 integrationId: String
2040 """
2041 The service of the integration to connect. Null for other elicitation kinds.
2042 """
2043 integrationService: IntegrationService
2044 """
2045 The kind of input this elicitation asks for.
2046 """
2047 kind: AiConversationElicitationKind!
2048 """
2049 The metadata of the part.
2050 """
2051 metadata: AiConversationPartMetadata!
2052 """
2053 The selectable actions for multiple-choice and confirmation elicitations.
2054 """
2055 options: [AiConversationElicitationOption!]!
2056 """
2057 The requested owner of the MCP server connection. Null for other elicitation kinds.
2058 """
2059 scope: AiConversationMcpServerConnectionScope
2060 """
2061 Whether to select one or multiple entities.
2062 """
2063 selection: String
2064 """
2065 The MCP server URL for a new connection. Null for reconnects and other elicitation kinds.
2066 """
2067 serverUrl: String
2068 """
2069 Suggested entity identifiers.
2070 """
2071 suggestedEntityIds: [String!]
2072 """
2073 The optional title shown above the elicitation choices.
2074 """
2075 title: String
2076 """
2077 The type of the part.
2078 """
2079 type: AiConversationPartType!
2080 }
2081
2082 """
2083 The kind-specific data recorded when a user answers an AI conversation elicitation.
2084 """
2085 union AiConversationElicitationResponseData =
2086 | AiConversationConfirmationElicitationResponseData
2087 | AiConversationEntitySelectionElicitationResponseData
2088 | AiConversationIntegrationConnectionElicitationResponseData
2089 | AiConversationMcpServerConnectionElicitationResponseData
2090 | AiConversationMultipleChoiceElicitationResponseData
2091
2092 """
2093 A structured user response to an elicitation in an AI conversation.
2094 """
2095 type AiConversationElicitationResponsePart implements AiConversationBasePart {
2096 """
2097 Additional user-authored commentary submitted with the response. For a response batch, only the first response contains it. Null when none was provided.
2098 """
2099 bodyData: JSONObject
2100 """
2101 The kind-specific response data.
2102 """
2103 data: AiConversationElicitationResponseData!
2104 """
2105 The identifier of the elicitation that was answered.
2106 """
2107 elicitationId: String!
2108 """
2109 The ID of the part.
2110 """
2111 id: String!
2112 """
2113 The metadata of the part.
2114 """
2115 metadata: AiConversationPartMetadata!
2116 """
2117 The type of the part.
2118 """
2119 type: AiConversationPartType!
2120 """
2121 The user who answered the elicitation.
2122 """
2123 user: User
2124 }
2125
2126 type AiConversationEntityCardWidget implements AiConversationBaseWidget {
2127 """
2128 The arguments to the widget.
2129 """
2130 args: AiConversationEntityCardWidgetArgs
2131 """
2132 Display information for the widget, including ProseMirror and Markdown representations.
2133 """
2134 displayInfo: AiConversationWidgetDisplayInfo
2135 """
2136 The name of the widget.
2137 """
2138 name: AiConversationWidgetName!
2139 """
2140 The arguments of the widget.
2141 """
2142 rawArgs: JSON
2143 }
2144
2145 type AiConversationEntityCardWidgetArgs {
2146 """
2147 The action performed on the entity (leave empty if just found)
2148 """
2149 action: AiConversationEntityCardWidgetArgsAction
2150 """
2151 A concise summary shown on specialized entity cards. Leave empty unless specifically instructed.
2152 """
2153 actionSummary: String
2154 """
2155 The UUID of the entity to display
2156 """
2157 id: String!
2158 """
2159 @deprecated Optional note to display about the entity
2160 """
2161 note: String @deprecated(reason: "Optional note to display about the entity")
2162 """
2163 [Internal] Snapshot data for the widget.
2164 """
2165 snapshot: JSONObject
2166 """
2167 [Internal] The entity type
2168 """
2169 type: AiConversationEntityCardWidgetArgsType!
2170 }
2171
2172 """
2173 The action performed on the entity (leave empty if just found)
2174 """
2175 enum AiConversationEntityCardWidgetArgsAction {
2176 created
2177 updated
2178 }
2179
2180 """
2181 [Internal] The entity type
2182 """
2183 enum AiConversationEntityCardWidgetArgsType {
2184 AgentSession
2185 AiConversation
2186 AiPrompt
2187 AiPromptRules
2188 CustomView
2189 Customer
2190 CustomerNeed
2191 Dashboard
2192 Document
2193 Draft
2194 Initiative
2195 InitiativeUpdate
2196 Issue
2197 IssueDraft
2198 Meeting
2199 Project
2200 ProjectDraft
2201 ProjectMilestone
2202 ProjectUpdate
2203 PullRequest
2204 Release
2205 ReleaseNote
2206 ReleasePipeline
2207 Team
2208 Template
2209 WorkflowDefinition
2210 }
2211
2212 type AiConversationEntityListWidget implements AiConversationBaseWidget {
2213 """
2214 The arguments to the widget.
2215 """
2216 args: AiConversationEntityListWidgetArgs
2217 """
2218 Display information for the widget, including ProseMirror and Markdown representations.
2219 """
2220 displayInfo: AiConversationWidgetDisplayInfo
2221 """
2222 The name of the widget.
2223 """
2224 name: AiConversationWidgetName!
2225 """
2226 The arguments of the widget.
2227 """
2228 rawArgs: JSON
2229 }
2230
2231 type AiConversationEntityListWidgetArgs {
2232 """
2233 The action performed on the entities (leave empty if just found)
2234 """
2235 action: AiConversationEntityListWidgetArgsAction
2236 """
2237 Total number of entities in the list
2238 """
2239 count: Float
2240 entities: [AiConversationEntityListWidgetArgsEntities!]!
2241 }
2242
2243 """
2244 The action performed on the entities (leave empty if just found)
2245 """
2246 enum AiConversationEntityListWidgetArgsAction {
2247 created
2248 updated
2249 }
2250
2251 type AiConversationEntityListWidgetArgsEntities {
2252 """
2253 Entity UUID
2254 """
2255 id: String!
2256 """
2257 @deprecated Optional note to display about the entity
2258 """
2259 note: String @deprecated(reason: "Optional note to display about the entity")
2260 """
2261 [Internal] Snapshot data for the widget.
2262 """
2263 snapshot: JSONObject
2264 """
2265 [Internal] The entity type
2266 """
2267 type: AiConversationEntityListWidgetArgsEntitiesType!
2268 }
2269
2270 """
2271 [Internal] The entity type
2272 """
2273 enum AiConversationEntityListWidgetArgsEntitiesType {
2274 AgentSession
2275 AiPrompt
2276 AiPromptRules
2277 CustomView
2278 Customer
2279 CustomerNeed
2280 Dashboard
2281 Document
2282 Initiative
2283 InitiativeUpdate
2284 Issue
2285 IssueDraft
2286 Project
2287 ProjectDraft
2288 ProjectMilestone
2289 ProjectUpdate
2290 PullRequest
2291 Release
2292 ReleaseNote
2293 ReleasePipeline
2294 Team
2295 Template
2296 WorkflowDefinition
2297 }
2298
2299 """
2300 Selected entities in an entity selection elicitation.
2301 """
2302 type AiConversationEntitySelectionElicitationResponseData {
2303 kind: AiConversationElicitationKind!
2304 selectedEntityIds: [String!]!
2305 }
2306
2307 """
2308 An error part in an AI conversation.
2309 """
2310 type AiConversationErrorPart implements AiConversationBasePart {
2311 """
2312 The category of the error. Absent for errors without a specific category, which default to unknown.
2313 """
2314 errorType: AiConversationErrorType
2315 """
2316 The ID of the part.
2317 """
2318 id: String!
2319 """
2320 The user-facing error message for the failed AI response.
2321 """
2322 message: String!
2323 """
2324 The metadata of the part.
2325 """
2326 metadata: AiConversationPartMetadata!
2327 """
2328 The outcome of retrying this error's loop run. Null when the run has not been reconsidered.
2329 """
2330 retryResolution: AgentAutomationRetryResolution
2331 """
2332 The type of the part.
2333 """
2334 type: AiConversationPartType!
2335 """
2336 The time when the breached usage limit resets, as an ISO 8601 string. Null when unknown or for other error categories.
2337 """
2338 usageLimitResetsAt: String
2339 """
2340 The scope of the breached limit for usage-limit errors. Null for other error categories.
2341 """
2342 usageLimitScope: AgentAutomationUsageLimitScope
2343 }
2344
2345 """
2346 The category of an error part in an AI conversation.
2347 """
2348 enum AiConversationErrorType {
2349 billing
2350 unknown
2351 untrustedSources
2352 usageLimit
2353 }
2354
2355 """
2356 An event part in an AI conversation.
2357 """
2358 type AiConversationEventPart implements AiConversationBasePart {
2359 """
2360 The Markdown body of the event part.
2361 """
2362 body: String!
2363 """
2364 The data of the event part.
2365 """
2366 bodyData: JSONObject!
2367 """
2368 The ID of the part.
2369 """
2370 id: String!
2371 """
2372 The metadata of the part.
2373 """
2374 metadata: AiConversationPartMetadata!
2375 """
2376 The ID of the subscription to resolve when this event is delivered.
2377 """
2378 subscriptionId: String
2379 """
2380 The type of the part.
2381 """
2382 type: AiConversationPartType!
2383 }
2384
2385 type AiConversationGetMicrosoftTeamsConversationHistoryToolCall implements AiConversationBaseToolCall {
2386 displayInfo: AiConversationToolDisplayInfo!
2387 """
2388 The name of the tool that was called.
2389 """
2390 name: AiConversationTool!
2391 """
2392 The arguments of the tool call.
2393 """
2394 rawArgs: JSON
2395 """
2396 The result of the tool call.
2397 """
2398 rawResult: JSON
2399 }
2400
2401 type AiConversationGetPullRequestCheckLogsToolCall implements AiConversationBaseToolCall {
2402 """
2403 The arguments to the tool call.
2404 """
2405 args: AiConversationGetPullRequestCheckLogsToolCallArgs
2406 displayInfo: AiConversationToolDisplayInfo!
2407 """
2408 The name of the tool that was called.
2409 """
2410 name: AiConversationTool!
2411 """
2412 The arguments of the tool call.
2413 """
2414 rawArgs: JSON
2415 """
2416 The result of the tool call.
2417 """
2418 rawResult: JSON
2419 }
2420
2421 type AiConversationGetPullRequestCheckLogsToolCallArgs {
2422 checkName: String!
2423 entity: AiConversationSearchEntitiesToolCallResultEntities!
2424 workflowName: String
2425 }
2426
2427 type AiConversationGetPullRequestDiffToolCall implements AiConversationBaseToolCall {
2428 """
2429 The arguments to the tool call.
2430 """
2431 args: AiConversationGetPullRequestDiffToolCallArgs
2432 displayInfo: AiConversationToolDisplayInfo!
2433 """
2434 The name of the tool that was called.
2435 """
2436 name: AiConversationTool!
2437 """
2438 The arguments of the tool call.
2439 """
2440 rawArgs: JSON
2441 """
2442 The result of the tool call.
2443 """
2444 rawResult: JSON
2445 }
2446
2447 type AiConversationGetPullRequestDiffToolCallArgs {
2448 entity: AiConversationSearchEntitiesToolCallResultEntities!
2449 }
2450
2451 type AiConversationGetPullRequestFileToolCall implements AiConversationBaseToolCall {
2452 """
2453 The arguments to the tool call.
2454 """
2455 args: AiConversationGetPullRequestFileToolCallArgs
2456 displayInfo: AiConversationToolDisplayInfo!
2457 """
2458 The name of the tool that was called.
2459 """
2460 name: AiConversationTool!
2461 """
2462 The arguments of the tool call.
2463 """
2464 rawArgs: JSON
2465 """
2466 The result of the tool call.
2467 """
2468 rawResult: JSON
2469 }
2470
2471 type AiConversationGetPullRequestFileToolCallArgs {
2472 entity: AiConversationSearchEntitiesToolCallResultEntities!
2473 path: String!
2474 }
2475
2476 type AiConversationGetSlackConversationHistoryToolCall implements AiConversationBaseToolCall {
2477 """
2478 The arguments to the tool call.
2479 """
2480 args: AiConversationGetSlackConversationHistoryToolCallArgs
2481 displayInfo: AiConversationToolDisplayInfo!
2482 """
2483 The name of the tool that was called.
2484 """
2485 name: AiConversationTool!
2486 """
2487 The arguments of the tool call.
2488 """
2489 rawArgs: JSON
2490 """
2491 The result of the tool call.
2492 """
2493 rawResult: JSON
2494 """
2495 The result of the tool call.
2496 """
2497 result: AiConversationGetSlackConversationHistoryToolCallResult
2498 }
2499
2500 type AiConversationGetSlackConversationHistoryToolCallArgs {
2501 channel: String
2502 targetType: AiConversationGetSlackConversationHistoryToolCallArgsTargetType
2503 }
2504
2505 enum AiConversationGetSlackConversationHistoryToolCallArgsTargetType {
2506 channel
2507 thread
2508 }
2509
2510 type AiConversationGetSlackConversationHistoryToolCallResult {
2511 conversationUrl: String
2512 error: String
2513 hasMore: Boolean
2514 messageCount: Float
2515 }
2516
2517 type AiConversationHandoffToCodingSessionToolCall implements AiConversationBaseToolCall {
2518 """
2519 The arguments to the tool call.
2520 """
2521 args: AiConversationHandoffToCodingSessionToolCallArgs
2522 displayInfo: AiConversationToolDisplayInfo!
2523 """
2524 The name of the tool that was called.
2525 """
2526 name: AiConversationTool!
2527 """
2528 The arguments of the tool call.
2529 """
2530 rawArgs: JSON
2531 """
2532 The result of the tool call.
2533 """
2534 rawResult: JSON
2535 }
2536
2537 type AiConversationHandoffToCodingSessionToolCallArgs {
2538 entity: AiConversationSearchEntitiesToolCallResultEntities!
2539 instructions: String
2540 }
2541
2542 """
2543 The initial source of an AI conversation.
2544 """
2545 enum AiConversationInitialSource {
2546 comment
2547 directChat
2548 entityChat
2549 mcp
2550 microsoftTeams
2551 onboarding
2552 pullRequestComment
2553 slack
2554 subAgent
2555 workflow
2556 }
2557
2558 """
2559 The integration connected to a Loop and its current run by a conversation.
2560 """
2561 type AiConversationIntegrationConnectionElicitationResponseData {
2562 """
2563 The identifier of the integration that was connected.
2564 """
2565 integrationId: String!
2566 """
2567 The kind of elicitation that was answered.
2568 """
2569 kind: AiConversationElicitationKind!
2570 }
2571
2572 type AiConversationInvokeMcpToolToolCall implements AiConversationBaseToolCall {
2573 """
2574 The arguments to the tool call.
2575 """
2576 args: AiConversationInvokeMcpToolToolCallArgs
2577 displayInfo: AiConversationToolDisplayInfo!
2578 """
2579 The name of the tool that was called.
2580 """
2581 name: AiConversationTool!
2582 """
2583 The arguments of the tool call.
2584 """
2585 rawArgs: JSON
2586 """
2587 The result of the tool call.
2588 """
2589 rawResult: JSON
2590 }
2591
2592 type AiConversationInvokeMcpToolToolCallArgs {
2593 server: AiConversationInvokeMcpToolToolCallArgsServer!
2594 tool: AiConversationInvokeMcpToolToolCallArgsTool!
2595 }
2596
2597 type AiConversationInvokeMcpToolToolCallArgsServer {
2598 integrationId: String!
2599 name: String!
2600 title: String
2601 }
2602
2603 type AiConversationInvokeMcpToolToolCallArgsTool {
2604 name: String!
2605 title: String
2606 }
2607
2608 type AiConversationListCodingSessionsToolCall implements AiConversationBaseToolCall {
2609 """
2610 The arguments to the tool call.
2611 """
2612 args: AiConversationListCodingSessionsToolCallArgs
2613 displayInfo: AiConversationToolDisplayInfo!
2614 """
2615 The name of the tool that was called.
2616 """
2617 name: AiConversationTool!
2618 """
2619 The arguments of the tool call.
2620 """
2621 rawArgs: JSON
2622 """
2623 The result of the tool call.
2624 """
2625 rawResult: JSON
2626 """
2627 The result of the tool call.
2628 """
2629 result: AiConversationListCodingSessionsToolCallResult
2630 }
2631
2632 type AiConversationListCodingSessionsToolCallArgs {
2633 includeDismissed: Boolean
2634 }
2635
2636 type AiConversationListCodingSessionsToolCallResult {
2637 agentSessions: [AiConversationListCodingSessionsToolCallResultAgentSessions!]!
2638 entities: [AiConversationSearchEntitiesToolCallResultEntities!]
2639 }
2640
2641 type AiConversationListCodingSessionsToolCallResultAgentSessions {
2642 id: String!
2643 pullRequests: [AiConversationSearchEntitiesToolCallResultEntities!]
2644 type: String!
2645 }
2646
2647 """
2648 The integration connected by an MCP server connection elicitation.
2649 """
2650 type AiConversationMcpServerConnectionElicitationResponseData {
2651 """
2652 The identifier of the MCP server integration that was connected.
2653 """
2654 integrationId: String!
2655 """
2656 The kind of elicitation that was answered.
2657 """
2658 kind: AiConversationElicitationKind!
2659 }
2660
2661 """
2662 The owner scope for an MCP server connection requested in an AI conversation.
2663 """
2664 type AiConversationMcpServerConnectionScope {
2665 """
2666 The identifier of the team that will own the connection. Null for other scope types.
2667 """
2668 teamId: String
2669 """
2670 The type of owner that will receive the MCP server connection.
2671 """
2672 type: AiConversationMcpServerConnectionScopeType!
2673 """
2674 The identifier of the Loop draft that will own the connection. Null for other scope types.
2675 """
2676 workflowDefinitionDraftId: String
2677 """
2678 The identifier of the Loop that will own the connection. Null for other scope types.
2679 """
2680 workflowDefinitionId: String
2681 }
2682
2683 """
2684 The owner scope for an MCP server connection requested in an AI conversation.
2685 """
2686 enum AiConversationMcpServerConnectionScopeType {
2687 team
2688 user
2689 workflowDefinition
2690 workflowDefinitionDraft
2691 }
2692
2693 type AiConversationMemoryToolCall implements AiConversationBaseToolCall {
2694 """
2695 The arguments to the tool call.
2696 """
2697 args: AiConversationMemoryToolCallArgs
2698 displayInfo: AiConversationToolDisplayInfo!
2699 """
2700 The name of the tool that was called.
2701 """
2702 name: AiConversationTool!
2703 """
2704 The arguments of the tool call.
2705 """
2706 rawArgs: JSON
2707 """
2708 The result of the tool call.
2709 """
2710 rawResult: JSON
2711 }
2712
2713 type AiConversationMemoryToolCallArgs {
2714 action: AiConversationMemoryToolCallArgsAction!
2715 name: String
2716 }
2717
2718 enum AiConversationMemoryToolCallArgsAction {
2719 delete
2720 list
2721 read
2722 save
2723 }
2724
2725 type AiConversationMessageSubagentToolCall implements AiConversationBaseToolCall {
2726 """
2727 The arguments to the tool call.
2728 """
2729 args: AiConversationMessageSubagentToolCallArgs
2730 displayInfo: AiConversationToolDisplayInfo!
2731 """
2732 The name of the tool that was called.
2733 """
2734 name: AiConversationTool!
2735 """
2736 The arguments of the tool call.
2737 """
2738 rawArgs: JSON
2739 """
2740 The result of the tool call.
2741 """
2742 rawResult: JSON
2743 """
2744 The result of the tool call.
2745 """
2746 result: AiConversationMessageSubagentToolCallResult
2747 }
2748
2749 type AiConversationMessageSubagentToolCallArgs {
2750 conversationId: String!
2751 prompt: String!
2752 wait: Boolean
2753 }
2754
2755 type AiConversationMessageSubagentToolCallResult {
2756 turnId: String!
2757 }
2758
2759 """
2760 The selected option in a multiple-choice AI conversation elicitation.
2761 """
2762 type AiConversationMultipleChoiceElicitationResponseData {
2763 """
2764 The kind of elicitation that was answered.
2765 """
2766 kind: AiConversationElicitationKind!
2767 """
2768 The zero-based index of the selected option.
2769 """
2770 selectedOptionIndex: Int!
2771 }
2772
2773 type AiConversationNavigateToPageToolCall implements AiConversationBaseToolCall {
2774 """
2775 The arguments to the tool call.
2776 """
2777 args: AiConversationNavigateToPageToolCallArgs
2778 displayInfo: AiConversationToolDisplayInfo!
2779 """
2780 The name of the tool that was called.
2781 """
2782 name: AiConversationTool!
2783 """
2784 The arguments of the tool call.
2785 """
2786 rawArgs: JSON
2787 """
2788 The result of the tool call.
2789 """
2790 rawResult: JSON
2791 """
2792 The result of the tool call.
2793 """
2794 result: AiConversationNavigateToPageToolCallResult
2795 }
2796
2797 type AiConversationNavigateToPageToolCallArgs {
2798 entities: [AiConversationNavigateToPageToolCallArgsEntities!]!
2799 }
2800
2801 type AiConversationNavigateToPageToolCallArgsEntities {
2802 entityType: String!
2803 uuid: String!
2804 }
2805
2806 type AiConversationNavigateToPageToolCallResult {
2807 urls: [String!]!
2808 }
2809
2810 type AiConversationNotifyUsersToolCall implements AiConversationBaseToolCall {
2811 """
2812 The arguments to the tool call.
2813 """
2814 args: AiConversationNotifyUsersToolCallArgs
2815 displayInfo: AiConversationToolDisplayInfo!
2816 """
2817 The name of the tool that was called.
2818 """
2819 name: AiConversationTool!
2820 """
2821 The arguments of the tool call.
2822 """
2823 rawArgs: JSON
2824 """
2825 The result of the tool call.
2826 """
2827 rawResult: JSON
2828 """
2829 The result of the tool call.
2830 """
2831 result: AiConversationNotifyUsersToolCallResult
2832 }
2833
2834 type AiConversationNotifyUsersToolCallArgs {
2835 message: String
2836 summary: String
2837 userIds: [String!]!
2838 }
2839
2840 type AiConversationNotifyUsersToolCallResult {
2841 notifiedUserIds: [String!]
2842 skippedUserIds: [String!]
2843 }
2844
2845 """
2846 A part in an AI conversation.
2847 """
2848 union AiConversationPart =
2849 | AiConversationAckPart
2850 | AiConversationElicitationPart
2851 | AiConversationElicitationResponsePart
2852 | AiConversationErrorPart
2853 | AiConversationEventPart
2854 | AiConversationPromptPart
2855 | AiConversationReasoningPart
2856 | AiConversationTextPart
2857 | AiConversationToolCallPart
2858 | AiConversationWidgetPart
2859
2860 """
2861 Metadata about a part in an AI conversation.
2862 """
2863 type AiConversationPartMetadata {
2864 """
2865 The time when the part ended, as an ISO 8601 string.
2866 """
2867 endedAt: String
2868 """
2869 The eval log ID of the part.
2870 """
2871 evalLogId: String
2872 """
2873 AI feedback state for this part.
2874 """
2875 feedback: JSONObject
2876 """
2877 The phase during which the part was generated.
2878 """
2879 phase: AiConversationPartPhase
2880 """
2881 The time when the part started, as an ISO 8601 string.
2882 """
2883 startedAt: String
2884 """
2885 The turn ID of the part.
2886 """
2887 turnId: String!
2888 }
2889
2890 """
2891 The phase during which a conversation part was generated.
2892 """
2893 enum AiConversationPartPhase {
2894 answer
2895 commentary
2896 }
2897
2898 """
2899 The type of a part in an AI conversation.
2900 """
2901 enum AiConversationPartType {
2902 ack
2903 elicitation
2904 elicitationResponse
2905 error
2906 event
2907 prompt
2908 reasoning
2909 text
2910 toolCall
2911 widget
2912 widgetPlaceholder
2913 }
2914
2915 type AiConversationPatchSettingsToolCall implements AiConversationBaseToolCall {
2916 """
2917 The arguments to the tool call.
2918 """
2919 args: AiConversationPatchSettingsToolCallArgs
2920 displayInfo: AiConversationToolDisplayInfo!
2921 """
2922 The name of the tool that was called.
2923 """
2924 name: AiConversationTool!
2925 """
2926 The arguments of the tool call.
2927 """
2928 rawArgs: JSON
2929 """
2930 The result of the tool call.
2931 """
2932 rawResult: JSON
2933 }
2934
2935 type AiConversationPatchSettingsToolCallArgs {
2936 ids: [String!]!
2937 }
2938
2939 type AiConversationPostChatMessageToolCall implements AiConversationBaseToolCall {
2940 """
2941 The arguments to the tool call.
2942 """
2943 args: AiConversationPostChatMessageToolCallArgs
2944 displayInfo: AiConversationToolDisplayInfo!
2945 """
2946 The name of the tool that was called.
2947 """
2948 name: AiConversationTool!
2949 """
2950 The arguments of the tool call.
2951 """
2952 rawArgs: JSON
2953 """
2954 The result of the tool call.
2955 """
2956 rawResult: JSON
2957 """
2958 The result of the tool call.
2959 """
2960 result: AiConversationPostChatMessageToolCallResult
2961 }
2962
2963 type AiConversationPostChatMessageToolCallArgs {
2964 channel: String
2965 isReply: Boolean
2966 platform: AiConversationPostChatMessageToolCallArgsPlatform!
2967 recipient: String
2968 recipientId: String
2969 }
2970
2971 enum AiConversationPostChatMessageToolCallArgsPlatform {
2972 microsoftTeams
2973 slack
2974 }
2975
2976 type AiConversationPostChatMessageToolCallResult {
2977 conversationUrl: String
2978 destination: AiConversationPostChatMessageToolCallResultDestination
2979 error: String
2980 message: String
2981 posted: Boolean!
2982 }
2983
2984 type AiConversationPostChatMessageToolCallResultDestination {
2985 channelId: String!
2986 integrationId: String!
2987 messageId: String!
2988 threadId: String!
2989 }
2990
2991 type AiConversationPromptCodingSessionToolCall implements AiConversationBaseToolCall {
2992 """
2993 The arguments to the tool call.
2994 """
2995 args: AiConversationPromptCodingSessionToolCallArgs
2996 displayInfo: AiConversationToolDisplayInfo!
2997 """
2998 The name of the tool that was called.
2999 """
3000 name: AiConversationTool!
3001 """
3002 The arguments of the tool call.
3003 """
3004 rawArgs: JSON
3005 """
3006 The result of the tool call.
3007 """
3008 rawResult: JSON
3009 """
3010 The result of the tool call.
3011 """
3012 result: AiConversationPromptCodingSessionToolCallResult
3013 }
3014
3015 type AiConversationPromptCodingSessionToolCallArgs {
3016 prompt: String!
3017 queued: Boolean
3018 }
3019
3020 type AiConversationPromptCodingSessionToolCallResult {
3021 agentSession: AiConversationSearchEntitiesToolCallResultEntities!
3022 created: Boolean
3023 entities: [AiConversationSearchEntitiesToolCallResultEntities!]
3024 pullRequests: [AiConversationSearchEntitiesToolCallResultEntities!]
3025 quotaBlocked: Boolean
3026 }
3027
3028 """
3029 A prompt part in an AI conversation.
3030 """
3031 type AiConversationPromptPart implements AiConversationBasePart {
3032 """
3033 The Markdown body of the prompt part.
3034 """
3035 body: String!
3036 """
3037 The data of the prompt part.
3038 """
3039 bodyData: JSONObject!
3040 """
3041 The ID of the part.
3042 """
3043 id: String!
3044 """
3045 The metadata of the part.
3046 """
3047 metadata: AiConversationPartMetadata!
3048 """
3049 The type of the part.
3050 """
3051 type: AiConversationPartType!
3052 """
3053 The user who created the prompt part.
3054 """
3055 user: User
3056 }
3057
3058 type AiConversationQueryActivityToolCall implements AiConversationBaseToolCall {
3059 """
3060 The arguments to the tool call.
3061 """
3062 args: AiConversationQueryActivityToolCallArgs
3063 displayInfo: AiConversationToolDisplayInfo!
3064 """
3065 The name of the tool that was called.
3066 """
3067 name: AiConversationTool!
3068 """
3069 The arguments of the tool call.
3070 """
3071 rawArgs: JSON
3072 """
3073 The result of the tool call.
3074 """
3075 rawResult: JSON
3076 }
3077
3078 type AiConversationQueryActivityToolCallArgs {
3079 entities: [AiConversationSearchEntitiesToolCallResultEntities!]
3080 }
3081
3082 type AiConversationQueryUpdatesToolCall implements AiConversationBaseToolCall {
3083 """
3084 The arguments to the tool call.
3085 """
3086 args: AiConversationQueryUpdatesToolCallArgs
3087 displayInfo: AiConversationToolDisplayInfo!
3088 """
3089 The name of the tool that was called.
3090 """
3091 name: AiConversationTool!
3092 """
3093 The arguments of the tool call.
3094 """
3095 rawArgs: JSON
3096 """
3097 The result of the tool call.
3098 """
3099 rawResult: JSON
3100 }
3101
3102 type AiConversationQueryUpdatesToolCallArgs {
3103 entity: AiConversationSearchEntitiesToolCallResultEntities
3104 updateType: AiConversationQueryUpdatesToolCallArgsUpdateType!
3105 }
3106
3107 enum AiConversationQueryUpdatesToolCallArgsUpdateType {
3108 InitiativeUpdate
3109 ProjectUpdate
3110 }
3111
3112 type AiConversationQueryViewToolCall implements AiConversationBaseToolCall {
3113 """
3114 The arguments to the tool call.
3115 """
3116 args: AiConversationQueryViewToolCallArgs
3117 displayInfo: AiConversationToolDisplayInfo!
3118 """
3119 The name of the tool that was called.
3120 """
3121 name: AiConversationTool!
3122 """
3123 The arguments of the tool call.
3124 """
3125 rawArgs: JSON
3126 """
3127 The result of the tool call.
3128 """
3129 rawResult: JSON
3130 }
3131
3132 type AiConversationQueryViewToolCallArgs {
3133 filter: String
3134 mode: AiConversationQueryViewToolCallArgsMode!
3135 view: AiConversationQueryViewToolCallArgsView!
3136 }
3137
3138 enum AiConversationQueryViewToolCallArgsMode {
3139 insight
3140 list
3141 }
3142
3143 type AiConversationQueryViewToolCallArgsView {
3144 group: AiConversationSearchEntitiesToolCallResultEntities
3145 predefinedView: String
3146 type: String!
3147 }
3148
3149 type AiConversationReadFileToolCall implements AiConversationBaseToolCall {
3150 """
3151 The arguments to the tool call.
3152 """
3153 args: AiConversationReadFileToolCallArgs
3154 displayInfo: AiConversationToolDisplayInfo!
3155 """
3156 The name of the tool that was called.
3157 """
3158 name: AiConversationTool!
3159 """
3160 The arguments of the tool call.
3161 """
3162 rawArgs: JSON
3163 """
3164 The result of the tool call.
3165 """
3166 rawResult: JSON
3167 }
3168
3169 type AiConversationReadFileToolCallArgs {
3170 assetUrl: String
3171 mode: AiConversationReadFileToolCallArgsMode
3172 name: String
3173 query: String
3174 }
3175
3176 enum AiConversationReadFileToolCallArgsMode {
3177 read
3178 search
3179 }
3180
3181 type AiConversationReadSandboxFileToolCall implements AiConversationBaseToolCall {
3182 """
3183 The arguments to the tool call.
3184 """
3185 args: AiConversationReadSandboxFileToolCallArgs
3186 displayInfo: AiConversationToolDisplayInfo!
3187 """
3188 The name of the tool that was called.
3189 """
3190 name: AiConversationTool!
3191 """
3192 The arguments of the tool call.
3193 """
3194 rawArgs: JSON
3195 """
3196 The result of the tool call.
3197 """
3198 rawResult: JSON
3199 }
3200
3201 type AiConversationReadSandboxFileToolCallArgs {
3202 path: String!
3203 }
3204
3205 type AiConversationReadSettingToolCall implements AiConversationBaseToolCall {
3206 """
3207 The arguments to the tool call.
3208 """
3209 args: AiConversationReadSettingToolCallArgs
3210 displayInfo: AiConversationToolDisplayInfo!
3211 """
3212 The name of the tool that was called.
3213 """
3214 name: AiConversationTool!
3215 """
3216 The arguments of the tool call.
3217 """
3218 rawArgs: JSON
3219 """
3220 The result of the tool call.
3221 """
3222 rawResult: JSON
3223 }
3224
3225 type AiConversationReadSettingToolCallArgs {
3226 id: String!
3227 }
3228
3229 """
3230 A reasoning part in an AI conversation.
3231 """
3232 type AiConversationReasoningPart implements AiConversationBasePart {
3233 """
3234 The Markdown body of the reasoning part.
3235 """
3236 body: String!
3237 """
3238 The data of the reasoning part.
3239 """
3240 bodyData: JSONObject!
3241 """
3242 The ID of the part.
3243 """
3244 id: String!
3245 """
3246 The metadata of the part.
3247 """
3248 metadata: AiConversationPartMetadata!
3249 """
3250 The title of the reasoning part.
3251 """
3252 title: String
3253 """
3254 The type of the part.
3255 """
3256 type: AiConversationPartType!
3257 }
3258
3259 type AiConversationRemoveSpendLimitToolCall implements AiConversationBaseToolCall {
3260 """
3261 The arguments to the tool call.
3262 """
3263 args: AiConversationRemoveSpendLimitToolCallArgs
3264 displayInfo: AiConversationToolDisplayInfo!
3265 """
3266 The name of the tool that was called.
3267 """
3268 name: AiConversationTool!
3269 """
3270 The arguments of the tool call.
3271 """
3272 rawArgs: JSON
3273 """
3274 The result of the tool call.
3275 """
3276 rawResult: JSON
3277 }
3278
3279 type AiConversationRemoveSpendLimitToolCallArgs {
3280 summary: String
3281 }
3282
3283 type AiConversationRenameAgentChatToolCall implements AiConversationBaseToolCall {
3284 """
3285 The arguments to the tool call.
3286 """
3287 args: AiConversationRenameAgentChatToolCallArgs
3288 displayInfo: AiConversationToolDisplayInfo!
3289 """
3290 The name of the tool that was called.
3291 """
3292 name: AiConversationTool!
3293 """
3294 The arguments of the tool call.
3295 """
3296 rawArgs: JSON
3297 """
3298 The result of the tool call.
3299 """
3300 rawResult: JSON
3301 }
3302
3303 type AiConversationRenameAgentChatToolCallArgs {
3304 name: String!
3305 }
3306
3307 type AiConversationRerunPullRequestReviewToolCall implements AiConversationBaseToolCall {
3308 """
3309 The arguments to the tool call.
3310 """
3311 args: AiConversationRerunPullRequestReviewToolCallArgs
3312 displayInfo: AiConversationToolDisplayInfo!
3313 """
3314 The name of the tool that was called.
3315 """
3316 name: AiConversationTool!
3317 """
3318 The arguments of the tool call.
3319 """
3320 rawArgs: JSON
3321 """
3322 The result of the tool call.
3323 """
3324 rawResult: JSON
3325 }
3326
3327 type AiConversationRerunPullRequestReviewToolCallArgs {
3328 entity: AiConversationSearchEntitiesToolCallResultEntities!
3329 }
3330
3331 type AiConversationResearchToolCall implements AiConversationBaseToolCall {
3332 """
3333 The arguments to the tool call.
3334 """
3335 args: AiConversationResearchToolCallArgs
3336 displayInfo: AiConversationToolDisplayInfo!
3337 """
3338 The name of the tool that was called.
3339 """
3340 name: AiConversationTool!
3341 """
3342 The arguments of the tool call.
3343 """
3344 rawArgs: JSON
3345 """
3346 The result of the tool call.
3347 """
3348 rawResult: JSON
3349 """
3350 The result of the tool call.
3351 """
3352 result: AiConversationResearchToolCallResult
3353 }
3354
3355 type AiConversationResearchToolCallArgs {
3356 context: String!
3357 query: String!
3358 subjects: [AiConversationSearchEntitiesToolCallResultEntities!]
3359 }
3360
3361 type AiConversationResearchToolCallResult {
3362 progressId: String
3363 }
3364
3365 type AiConversationRestoreEntityToolCall implements AiConversationBaseToolCall {
3366 """
3367 The arguments to the tool call.
3368 """
3369 args: AiConversationRestoreEntityToolCallArgs
3370 displayInfo: AiConversationToolDisplayInfo!
3371 """
3372 The name of the tool that was called.
3373 """
3374 name: AiConversationTool!
3375 """
3376 The arguments of the tool call.
3377 """
3378 rawArgs: JSON
3379 """
3380 The result of the tool call.
3381 """
3382 rawResult: JSON
3383 """
3384 The result of the tool call.
3385 """
3386 result: AiConversationRestoreEntityToolCallResult
3387 }
3388
3389 type AiConversationRestoreEntityToolCallArgs {
3390 entity: AiConversationSearchEntitiesToolCallResultEntities!
3391 }
3392
3393 type AiConversationRestoreEntityToolCallResult {
3394 restoredEntities: [AiConversationCreateEntityToolCallResultCreatedEntities!]
3395 }
3396
3397 type AiConversationRetrieveEntitiesToolCall implements AiConversationBaseToolCall {
3398 """
3399 The arguments to the tool call.
3400 """
3401 args: AiConversationRetrieveEntitiesToolCallArgs
3402 displayInfo: AiConversationToolDisplayInfo!
3403 """
3404 The name of the tool that was called.
3405 """
3406 name: AiConversationTool!
3407 """
3408 The arguments of the tool call.
3409 """
3410 rawArgs: JSON
3411 """
3412 The result of the tool call.
3413 """
3414 rawResult: JSON
3415 }
3416
3417 type AiConversationRetrieveEntitiesToolCallArgs {
3418 entities: [AiConversationSearchEntitiesToolCallResultEntities!]!
3419 }
3420
3421 type AiConversationRetryPullRequestCheckToolCall implements AiConversationBaseToolCall {
3422 """
3423 The arguments to the tool call.
3424 """
3425 args: AiConversationRetryPullRequestCheckToolCallArgs
3426 displayInfo: AiConversationToolDisplayInfo!
3427 """
3428 The name of the tool that was called.
3429 """
3430 name: AiConversationTool!
3431 """
3432 The arguments of the tool call.
3433 """
3434 rawArgs: JSON
3435 """
3436 The result of the tool call.
3437 """
3438 rawResult: JSON
3439 }
3440
3441 type AiConversationRetryPullRequestCheckToolCallArgs {
3442 checkName: String!
3443 entity: AiConversationSearchEntitiesToolCallResultEntities!
3444 workflowName: String
3445 }
3446
3447 type AiConversationRunLoopToolCall implements AiConversationBaseToolCall {
3448 """
3449 The arguments to the tool call.
3450 """
3451 args: AiConversationRunLoopToolCallArgs
3452 displayInfo: AiConversationToolDisplayInfo!
3453 """
3454 The name of the tool that was called.
3455 """
3456 name: AiConversationTool!
3457 """
3458 The arguments of the tool call.
3459 """
3460 rawArgs: JSON
3461 """
3462 The result of the tool call.
3463 """
3464 rawResult: JSON
3465 """
3466 The result of the tool call.
3467 """
3468 result: AiConversationRunLoopToolCallResult
3469 }
3470
3471 type AiConversationRunLoopToolCallArgs {
3472 workflowDefinitionId: String!
3473 }
3474
3475 type AiConversationRunLoopToolCallResult {
3476 conversationId: String!
3477 createdEntities: [AiConversationCreateEntityToolCallResultCreatedEntities!]
3478 url: String!
3479 }
3480
3481 type AiConversationSandboxGitHistoryToolCall implements AiConversationBaseToolCall {
3482 """
3483 The arguments to the tool call.
3484 """
3485 args: AiConversationSandboxGitHistoryToolCallArgs
3486 displayInfo: AiConversationToolDisplayInfo!
3487 """
3488 The name of the tool that was called.
3489 """
3490 name: AiConversationTool!
3491 """
3492 The arguments of the tool call.
3493 """
3494 rawArgs: JSON
3495 """
3496 The result of the tool call.
3497 """
3498 rawResult: JSON
3499 }
3500
3501 type AiConversationSandboxGitHistoryToolCallArgs {
3502 operation: AiConversationSandboxGitHistoryToolCallArgsOperation!
3503 paths: [String!]
3504 }
3505
3506 enum AiConversationSandboxGitHistoryToolCallArgsOperation {
3507 blame
3508 log
3509 search
3510 show
3511 }
3512
3513 type AiConversationSearchChatChannelsToolCall implements AiConversationBaseToolCall {
3514 """
3515 The arguments to the tool call.
3516 """
3517 args: AiConversationSearchChatChannelsToolCallArgs
3518 displayInfo: AiConversationToolDisplayInfo!
3519 """
3520 The name of the tool that was called.
3521 """
3522 name: AiConversationTool!
3523 """
3524 The arguments of the tool call.
3525 """
3526 rawArgs: JSON
3527 """
3528 The result of the tool call.
3529 """
3530 rawResult: JSON
3531 """
3532 The result of the tool call.
3533 """
3534 result: AiConversationSearchChatChannelsToolCallResult
3535 }
3536
3537 type AiConversationSearchChatChannelsToolCallArgs {
3538 filter: String!
3539 platform: AiConversationPostChatMessageToolCallArgsPlatform!
3540 }
3541
3542 type AiConversationSearchChatChannelsToolCallResult {
3543 totalCount: Float!
3544 }
3545
3546 type AiConversationSearchDocumentationToolCall implements AiConversationBaseToolCall {
3547 displayInfo: AiConversationToolDisplayInfo!
3548 """
3549 The name of the tool that was called.
3550 """
3551 name: AiConversationTool!
3552 """
3553 The arguments of the tool call.
3554 """
3555 rawArgs: JSON
3556 """
3557 The result of the tool call.
3558 """
3559 rawResult: JSON
3560 }
3561
3562 type AiConversationSearchEntitiesToolCall implements AiConversationBaseToolCall {
3563 """
3564 The arguments to the tool call.
3565 """
3566 args: AiConversationSearchEntitiesToolCallArgs
3567 displayInfo: AiConversationToolDisplayInfo!
3568 """
3569 The name of the tool that was called.
3570 """
3571 name: AiConversationTool!
3572 """
3573 The arguments of the tool call.
3574 """
3575 rawArgs: JSON
3576 """
3577 The result of the tool call.
3578 """
3579 rawResult: JSON
3580 """
3581 The result of the tool call.
3582 """
3583 result: AiConversationSearchEntitiesToolCallResult
3584 }
3585
3586 type AiConversationSearchEntitiesToolCallArgs {
3587 queries: [String!]!
3588 type: String
3589 }
3590
3591 type AiConversationSearchEntitiesToolCallResult {
3592 entities: [AiConversationSearchEntitiesToolCallResultEntities!]!
3593 }
3594
3595 type AiConversationSearchEntitiesToolCallResultEntities {
3596 id: String!
3597 type: String!
3598 }
3599
3600 type AiConversationSearchSettingsToolCall implements AiConversationBaseToolCall {
3601 """
3602 The arguments to the tool call.
3603 """
3604 args: AiConversationSearchSettingsToolCallArgs
3605 displayInfo: AiConversationToolDisplayInfo!
3606 """
3607 The name of the tool that was called.
3608 """
3609 name: AiConversationTool!
3610 """
3611 The arguments of the tool call.
3612 """
3613 rawArgs: JSON
3614 """
3615 The result of the tool call.
3616 """
3617 rawResult: JSON
3618 }
3619
3620 type AiConversationSearchSettingsToolCallArgs {
3621 parentId: String
3622 query: String
3623 }
3624
3625 type AiConversationSetSpendLimitToolCall implements AiConversationBaseToolCall {
3626 """
3627 The arguments to the tool call.
3628 """
3629 args: AiConversationSetSpendLimitToolCallArgs
3630 displayInfo: AiConversationToolDisplayInfo!
3631 """
3632 The name of the tool that was called.
3633 """
3634 name: AiConversationTool!
3635 """
3636 The arguments of the tool call.
3637 """
3638 rawArgs: JSON
3639 """
3640 The result of the tool call.
3641 """
3642 rawResult: JSON
3643 }
3644
3645 type AiConversationSetSpendLimitToolCallArgs {
3646 summary: String
3647 }
3648
3649 type AiConversationSettingWidget implements AiConversationBaseWidget {
3650 """
3651 The arguments to the widget.
3652 """
3653 args: AiConversationSettingWidgetArgs
3654 """
3655 Display information for the widget, including ProseMirror and Markdown representations.
3656 """
3657 displayInfo: AiConversationWidgetDisplayInfo
3658 """
3659 The name of the widget.
3660 """
3661 name: AiConversationWidgetName!
3662 """
3663 The arguments of the widget.
3664 """
3665 rawArgs: JSON
3666 }
3667
3668 type AiConversationSettingWidgetArgs {
3669 """
3670 The stable semantic setting ID returned by SearchSettings
3671 """
3672 id: String!
3673 """
3674 The settings target when the setting scope does not imply it
3675 """
3676 target: AiConversationSettingWidgetArgsTarget
3677 }
3678
3679 type AiConversationSettingWidgetArgsTarget {
3680 """
3681 The settings target UUID, when the scope does not imply it
3682 """
3683 id: String
3684 """
3685 The settings target entity type
3686 """
3687 type: String!
3688 }
3689
3690 type AiConversationSpawnSubagentToolCall implements AiConversationBaseToolCall {
3691 """
3692 The arguments to the tool call.
3693 """
3694 args: AiConversationSpawnSubagentToolCallArgs
3695 displayInfo: AiConversationToolDisplayInfo!
3696 """
3697 The name of the tool that was called.
3698 """
3699 name: AiConversationTool!
3700 """
3701 The arguments of the tool call.
3702 """
3703 rawArgs: JSON
3704 """
3705 The result of the tool call.
3706 """
3707 rawResult: JSON
3708 """
3709 The result of the tool call.
3710 """
3711 result: AiConversationSpawnSubagentToolCallResult
3712 }
3713
3714 type AiConversationSpawnSubagentToolCallArgs {
3715 description: String!
3716 }
3717
3718 type AiConversationSpawnSubagentToolCallResult {
3719 conversationId: String!
3720 }
3721
3722 type AiConversationStartCodingSessionToolCall implements AiConversationBaseToolCall {
3723 """
3724 The arguments to the tool call.
3725 """
3726 args: AiConversationStartCodingSessionToolCallArgs
3727 displayInfo: AiConversationToolDisplayInfo!
3728 """
3729 The name of the tool that was called.
3730 """
3731 name: AiConversationTool!
3732 """
3733 The arguments of the tool call.
3734 """
3735 rawArgs: JSON
3736 """
3737 The result of the tool call.
3738 """
3739 rawResult: JSON
3740 """
3741 The result of the tool call.
3742 """
3743 result: AiConversationStartCodingSessionToolCallResult
3744 }
3745
3746 type AiConversationStartCodingSessionToolCallArgs {
3747 prompt: String!
3748 }
3749
3750 type AiConversationStartCodingSessionToolCallResult {
3751 agentSession: AiConversationSearchEntitiesToolCallResultEntities!
3752 entities: [AiConversationSearchEntitiesToolCallResultEntities!]
3753 pullRequests: [AiConversationSearchEntitiesToolCallResultEntities!]
3754 }
3755
3756 """
3757 The status of an AI conversation.
3758 """
3759 enum AiConversationStatus {
3760 active
3761 awaitingInput
3762 complete
3763 error
3764 pending
3765 waiting
3766 }
3767
3768 type AiConversationSubscribeToEventToolCall implements AiConversationBaseToolCall {
3769 """
3770 The arguments to the tool call.
3771 """
3772 args: AiConversationSubscribeToEventToolCallArgs
3773 displayInfo: AiConversationToolDisplayInfo!
3774 """
3775 The name of the tool that was called.
3776 """
3777 name: AiConversationTool!
3778 """
3779 The arguments of the tool call.
3780 """
3781 rawArgs: JSON
3782 """
3783 The result of the tool call.
3784 """
3785 rawResult: JSON
3786 }
3787
3788 type AiConversationSubscribeToEventToolCallArgs {
3789 endsAt: String
3790 kind: AiConversationSubscribeToEventToolCallArgsKind
3791 message: String
3792 subscriptionId: String
3793 type: AiConversationSubscribeToEventToolCallArgsType!
3794 }
3795
3796 enum AiConversationSubscribeToEventToolCallArgsKind {
3797 timer
3798 trigger
3799 }
3800
3801 enum AiConversationSubscribeToEventToolCallArgsType {
3802 once
3803 recurring
3804 }
3805
3806 type AiConversationSuggestRepositoryToolCall implements AiConversationBaseToolCall {
3807 displayInfo: AiConversationToolDisplayInfo!
3808 """
3809 The name of the tool that was called.
3810 """
3811 name: AiConversationTool!
3812 """
3813 The arguments of the tool call.
3814 """
3815 rawArgs: JSON
3816 """
3817 The result of the tool call.
3818 """
3819 rawResult: JSON
3820 }
3821
3822 type AiConversationSuggestValuesToolCall implements AiConversationBaseToolCall {
3823 """
3824 The arguments to the tool call.
3825 """
3826 args: AiConversationSuggestValuesToolCallArgs
3827 displayInfo: AiConversationToolDisplayInfo!
3828 """
3829 The name of the tool that was called.
3830 """
3831 name: AiConversationTool!
3832 """
3833 The arguments of the tool call.
3834 """
3835 rawArgs: JSON
3836 """
3837 The result of the tool call.
3838 """
3839 rawResult: JSON
3840 }
3841
3842 type AiConversationSuggestValuesToolCallArgs {
3843 field: String!
3844 query: String
3845 }
3846
3847 """
3848 A text part in an AI conversation.
3849 """
3850 type AiConversationTextPart implements AiConversationBasePart {
3851 """
3852 The Markdown body of the text part.
3853 """
3854 body: String!
3855 """
3856 The data of the text part.
3857 """
3858 bodyData: JSONObject!
3859 """
3860 The ID of the part.
3861 """
3862 id: String!
3863 """
3864 The metadata of the part.
3865 """
3866 metadata: AiConversationPartMetadata!
3867 """
3868 The type of the part.
3869 """
3870 type: AiConversationPartType!
3871 }
3872
3873 """
3874 The name of a tool that was called in an AI conversation.
3875 """
3876 enum AiConversationTool {
3877 Bash
3878 CodeIntelligence
3879 CodeMode
3880 ContactSupport
3881 CreateAgentChat
3882 CreateEntity
3883 CreateSandbox
3884 DeleteEntity
3885 GetMicrosoftTeamsConversationHistory
3886 GetPullRequestCheckLogs
3887 GetPullRequestDiff
3888 GetPullRequestFile
3889 GetSlackConversationHistory
3890 HandoffToCodingSession
3891 InvokeMcpTool
3892 ListCodingSessions
3893 Memory
3894 MessageSubagent
3895 NavigateToPage
3896 NotifyUsers
3897 PatchSettings
3898 PostChatMessage
3899 PromptCodingSession
3900 QueryActivity
3901 QueryUpdates
3902 QueryView
3903 ReadFile
3904 ReadSandboxFile
3905 ReadSetting
3906 RemoveSpendLimit
3907 RenameAgentChat
3908 RerunPullRequestReview
3909 Research
3910 RestoreEntity
3911 RetrieveEntities
3912 RetryPullRequestCheck
3913 RunLoop
3914 SandboxGitHistory
3915 SearchChatChannels
3916 SearchDocumentation
3917 SearchEntities
3918 SearchSettings
3919 SetSpendLimit
3920 SpawnSubagent
3921 StartCodingSession
3922 SubscribeToEvent
3923 SuggestRepository
3924 SuggestValues
3925 TranscribeMedia
3926 TranscribeVideo
3927 UnsubscribeFromEvent
3928 UpdateEntity
3929 UpdatePullRequestReviewFinding
3930 WebSearch
3931 }
3932
3933 """
3934 The tool call.
3935 """
3936 union AiConversationToolCall =
3937 | AiConversationBashToolCall
3938 | AiConversationCodeIntelligenceToolCall
3939 | AiConversationCodeModeToolCall
3940 | AiConversationContactSupportToolCall
3941 | AiConversationCreateAgentChatToolCall
3942 | AiConversationCreateEntityToolCall
3943 | AiConversationCreateSandboxToolCall
3944 | AiConversationDeleteEntityToolCall
3945 | AiConversationGetMicrosoftTeamsConversationHistoryToolCall
3946 | AiConversationGetPullRequestCheckLogsToolCall
3947 | AiConversationGetPullRequestDiffToolCall
3948 | AiConversationGetPullRequestFileToolCall
3949 | AiConversationGetSlackConversationHistoryToolCall
3950 | AiConversationHandoffToCodingSessionToolCall
3951 | AiConversationInvokeMcpToolToolCall
3952 | AiConversationListCodingSessionsToolCall
3953 | AiConversationMemoryToolCall
3954 | AiConversationMessageSubagentToolCall
3955 | AiConversationNavigateToPageToolCall
3956 | AiConversationNotifyUsersToolCall
3957 | AiConversationPatchSettingsToolCall
3958 | AiConversationPostChatMessageToolCall
3959 | AiConversationPromptCodingSessionToolCall
3960 | AiConversationQueryActivityToolCall
3961 | AiConversationQueryUpdatesToolCall
3962 | AiConversationQueryViewToolCall
3963 | AiConversationReadFileToolCall
3964 | AiConversationReadSandboxFileToolCall
3965 | AiConversationReadSettingToolCall
3966 | AiConversationRemoveSpendLimitToolCall
3967 | AiConversationRenameAgentChatToolCall
3968 | AiConversationRerunPullRequestReviewToolCall
3969 | AiConversationResearchToolCall
3970 | AiConversationRestoreEntityToolCall
3971 | AiConversationRetrieveEntitiesToolCall
3972 | AiConversationRetryPullRequestCheckToolCall
3973 | AiConversationRunLoopToolCall
3974 | AiConversationSandboxGitHistoryToolCall
3975 | AiConversationSearchChatChannelsToolCall
3976 | AiConversationSearchDocumentationToolCall
3977 | AiConversationSearchEntitiesToolCall
3978 | AiConversationSearchSettingsToolCall
3979 | AiConversationSetSpendLimitToolCall
3980 | AiConversationSpawnSubagentToolCall
3981 | AiConversationStartCodingSessionToolCall
3982 | AiConversationSubscribeToEventToolCall
3983 | AiConversationSuggestRepositoryToolCall
3984 | AiConversationSuggestValuesToolCall
3985 | AiConversationTranscribeMediaToolCall
3986 | AiConversationTranscribeVideoToolCall
3987 | AiConversationUnsubscribeFromEventToolCall
3988 | AiConversationUpdateEntityToolCall
3989 | AiConversationUpdatePullRequestReviewFindingToolCall
3990 | AiConversationWebSearchToolCall
3991
3992 """
3993 A tool call part in an AI conversation.
3994 """
3995 type AiConversationToolCallPart implements AiConversationBasePart {
3996 """
3997 The ID of the part.
3998 """
3999 id: String!
4000 """
4001 The metadata of the part.
4002 """
4003 metadata: AiConversationPartMetadata!
4004 """
4005 The tool call part.
4006 """
4007 toolCall: AiConversationToolCall!
4008 """
4009 The type of the part.
4010 """
4011 type: AiConversationPartType!
4012 }
4013
4014 type AiConversationToolDisplayInfo {
4015 activeLabel: String!
4016 detail: String
4017 icon: String!
4018 inactiveLabel: String!
4019 result: String
4020 }
4021
4022 type AiConversationTranscribeMediaToolCall implements AiConversationBaseToolCall {
4023 displayInfo: AiConversationToolDisplayInfo!
4024 """
4025 The name of the tool that was called.
4026 """
4027 name: AiConversationTool!
4028 """
4029 The arguments of the tool call.
4030 """
4031 rawArgs: JSON
4032 """
4033 The result of the tool call.
4034 """
4035 rawResult: JSON
4036 }
4037
4038 type AiConversationTranscribeVideoToolCall implements AiConversationBaseToolCall {
4039 displayInfo: AiConversationToolDisplayInfo!
4040 """
4041 The name of the tool that was called.
4042 """
4043 name: AiConversationTool!
4044 """
4045 The arguments of the tool call.
4046 """
4047 rawArgs: JSON
4048 """
4049 The result of the tool call.
4050 """
4051 rawResult: JSON
4052 }
4053
4054 type AiConversationUnsubscribeFromEventToolCall implements AiConversationBaseToolCall {
4055 """
4056 The arguments to the tool call.
4057 """
4058 args: AiConversationUnsubscribeFromEventToolCallArgs
4059 displayInfo: AiConversationToolDisplayInfo!
4060 """
4061 The name of the tool that was called.
4062 """
4063 name: AiConversationTool!
4064 """
4065 The arguments of the tool call.
4066 """
4067 rawArgs: JSON
4068 """
4069 The result of the tool call.
4070 """
4071 rawResult: JSON
4072 }
4073
4074 type AiConversationUnsubscribeFromEventToolCallArgs {
4075 message: String
4076 subscriptionId: String!
4077 }
4078
4079 type AiConversationUpdateEntityToolCall implements AiConversationBaseToolCall {
4080 """
4081 The arguments to the tool call.
4082 """
4083 args: AiConversationUpdateEntityToolCallArgs
4084 displayInfo: AiConversationToolDisplayInfo!
4085 """
4086 The name of the tool that was called.
4087 """
4088 name: AiConversationTool!
4089 """
4090 The arguments of the tool call.
4091 """
4092 rawArgs: JSON
4093 """
4094 The result of the tool call.
4095 """
4096 rawResult: JSON
4097 """
4098 The result of the tool call.
4099 """
4100 result: AiConversationUpdateEntityToolCallResult
4101 }
4102
4103 type AiConversationUpdateEntityToolCallArgs {
4104 entities: [AiConversationSearchEntitiesToolCallResultEntities!]
4105 entity: AiConversationSearchEntitiesToolCallResultEntities
4106 }
4107
4108 type AiConversationUpdateEntityToolCallResult {
4109 startedAgentSessions: [AiConversationSearchEntitiesToolCallResultEntities!]
4110 updatedEntities: [AiConversationCreateEntityToolCallResultCreatedEntities!]
4111 }
4112
4113 type AiConversationUpdatePullRequestReviewFindingToolCall implements AiConversationBaseToolCall {
4114 """
4115 The arguments to the tool call.
4116 """
4117 args: AiConversationUpdatePullRequestReviewFindingToolCallArgs
4118 displayInfo: AiConversationToolDisplayInfo!
4119 """
4120 The name of the tool that was called.
4121 """
4122 name: AiConversationTool!
4123 """
4124 The arguments of the tool call.
4125 """
4126 rawArgs: JSON
4127 """
4128 The result of the tool call.
4129 """
4130 rawResult: JSON
4131 }
4132
4133 type AiConversationUpdatePullRequestReviewFindingToolCallArgs {
4134 entity: AiConversationSearchEntitiesToolCallResultEntities!
4135 findingId: String!
4136 rejected: Boolean!
4137 }
4138
4139 """
4140 [Internal] Per-user state for an AI conversation, tracking read status and other user-specific data.
4141 """
4142 type AiConversationUserState {
4143 """
4144 The ID of the elicitation part the user dismissed.
4145 """
4146 dismissedElicitationId: String
4147 """
4148 The time at which the user most recently viewed the conversation.
4149 """
4150 lastReadAt: DateTime
4151 """
4152 The ID of the user this state belongs to.
4153 """
4154 userId: String!
4155 }
4156
4157 type AiConversationWebSearchToolCall implements AiConversationBaseToolCall {
4158 """
4159 The arguments to the tool call.
4160 """
4161 args: AiConversationWebSearchToolCallArgs
4162 displayInfo: AiConversationToolDisplayInfo!
4163 """
4164 The name of the tool that was called.
4165 """
4166 name: AiConversationTool!
4167 """
4168 The arguments of the tool call.
4169 """
4170 rawArgs: JSON
4171 """
4172 The result of the tool call.
4173 """
4174 rawResult: JSON
4175 }
4176
4177 type AiConversationWebSearchToolCallArgs {
4178 query: String
4179 url: String
4180 }
4181
4182 """
4183 The widget.
4184 """
4185 union AiConversationWidget =
4186 | AiConversationEntityCardWidget
4187 | AiConversationEntityListWidget
4188 | AiConversationSettingWidget
4189
4190 type AiConversationWidgetDisplayInfo {
4191 """
4192 The Markdown representation of the widget content.
4193 """
4194 body: String!
4195 """
4196 The ProseMirror data representation of the widget content.
4197 """
4198 bodyData: JSONObject!
4199 }
4200
4201 """
4202 The name of a widget in an AI conversation.
4203 """
4204 enum AiConversationWidgetName {
4205 EntityCard
4206 EntityList
4207 Setting
4208 }
4209
4210 """
4211 A widget part in an AI conversation.
4212 """
4213 type AiConversationWidgetPart implements AiConversationBasePart {
4214 """
4215 The ID of the part.
4216 """
4217 id: String!
4218 """
4219 The metadata of the part.
4220 """
4221 metadata: AiConversationPartMetadata!
4222 """
4223 The type of the part.
4224 """
4225 type: AiConversationPartType!
4226 """
4227 The widget.
4228 """
4229 widget: AiConversationWidget!
4230 }
4231
4232 """
4233 [Internal] Tracks the progress and state of an AI prompt workflow execution. Each progress record is associated with an issue or comment and contains the workflow type, current status, metadata about the execution, and optionally the conversation messages exchanged during the workflow. Progress records can form a hierarchy via parent-child relationships for multi-step workflows.
4234 """
4235 type AiPromptProgress implements Node {
4236 """
4237 The time at which the entity was archived. Null if the entity has not been archived.
4238 """
4239 archivedAt: DateTime
4240 """
4241 The time at which the entity was created.
4242 """
4243 createdAt: DateTime!
4244 """
4245 The unique identifier of the entity.
4246 """
4247 id: ID!
4248 """
4249 [Internal] The log ID for the prompt workflow, if available.
4250 """
4251 logId: String
4252 """
4253 [Internal] The metadata for the prompt workflow.
4254 """
4255 metadata: JSONObject!
4256 """
4257 [Internal] The status of the prompt workflow.
4258 """
4259 status: AiPromptProgressStatus!
4260 """
4261 [Internal] The type of AI prompt workflow.
4262 """
4263 type: AiPromptType!
4264 """
4265 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
4266 been updated after creation.
4267 """
4268 updatedAt: DateTime!
4269 }
4270
4271 type AiPromptProgressConnection {
4272 edges: [AiPromptProgressEdge!]!
4273 nodes: [AiPromptProgress!]!
4274 pageInfo: PageInfo!
4275 }
4276
4277 type AiPromptProgressEdge {
4278 """
4279 Used in `before` and `after` args
4280 """
4281 cursor: String!
4282 node: AiPromptProgress!
4283 }
4284
4285 """
4286 [Internal] AI prompt progress filtering options.
4287 """
4288 input AiPromptProgressFilter {
4289 """
4290 [Internal] Compound filters, all of which need to be matched by the AI prompt progress.
4291 """
4292 and: [AiPromptProgressFilter!]
4293 """
4294 Comparator for the created at date.
4295 """
4296 createdAt: DateComparator
4297 """
4298 Comparator for the identifier.
4299 """
4300 id: IDComparator
4301 """
4302 [Internal] Compound filters, one of which need to be matched by the AI prompt progress.
4303 """
4304 or: [AiPromptProgressFilter!]
4305 """
4306 [Internal] Comparator for the AI prompt workflow status.
4307 """
4308 status: AiPromptProgressStatusComparator
4309 """
4310 [Internal] Comparator for the AI prompt workflow type.
4311 """
4312 type: AiPromptTypeComparator
4313 """
4314 Comparator for the updated at date.
4315 """
4316 updatedAt: DateComparator
4317 }
4318
4319 """
4320 [Internal] The status of a prompt workflow.
4321 """
4322 enum AiPromptProgressStatus {
4323 canceled
4324 created
4325 failed
4326 finished
4327 inProgress
4328 }
4329
4330 """
4331 [Internal] Comparator for the AI prompt workflow status.
4332 """
4333 input AiPromptProgressStatusComparator {
4334 """
4335 Equals constraint.
4336 """
4337 eq: AiPromptProgressStatus
4338 """
4339 In-array constraint.
4340 """
4341 in: [AiPromptProgressStatus!]
4342 """
4343 Not-equals constraint.
4344 """
4345 neq: AiPromptProgressStatus
4346 """
4347 Not-in-array constraint.
4348 """
4349 nin: [AiPromptProgressStatus!]
4350 """
4351 Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
4352 """
4353 null: Boolean
4354 }
4355
4356 """
4357 [Internal] Filter for AI prompt progress subscription events.
4358 """
4359 input AiPromptProgressSubscriptionFilter {
4360 """
4361 [Internal] Filter by comment ID.
4362 """
4363 commentId: IDComparator
4364 """
4365 [Internal] Filter by issue ID.
4366 """
4367 issueId: IDComparator
4368 """
4369 [Internal] Filter by pull request comment ID.
4370 """
4371 pullRequestCommentId: IDComparator
4372 """
4373 [Internal] Filter by prompt workflow status.
4374 """
4375 status: AiPromptProgressStatusComparator
4376 """
4377 [Internal] Filter by prompt workflow type.
4378 """
4379 type: AiPromptTypeComparator
4380 }
4381
4382 """
4383 Custom rules that guide AI behavior for a specific scope. Rules can be defined at the workspace level, team level, integration level, or user level, and are applied hierarchically (workspace rules first, then parent team rules, then team rules). Rules contain structured content that instructs the AI assistant on how to handle specific types of prompts, such as coding agent guidance or triage intelligence configuration.
4384 """
4385 type AiPromptRules implements Node {
4386 """
4387 The time at which the entity was archived. Null if the entity has not been archived.
4388 """
4389 archivedAt: DateTime
4390 """
4391 The time at which the entity was created.
4392 """
4393 createdAt: DateTime!
4394 """
4395 The unique identifier of the entity.
4396 """
4397 id: ID!
4398 """
4399 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
4400 been updated after creation.
4401 """
4402 updatedAt: DateTime!
4403 """
4404 The user who last updated the AI prompt rules.
4405 """
4406 updatedBy: User
4407 }
4408
4409 """
4410 The type of AI prompt workflow.
4411 """
4412 enum AiPromptType {
4413 agentGuidance
4414 aiConversation
4415 codeIntelligence
4416 gongIssueIntake
4417 initiativeUpdates
4418 intercomIssueIntake
4419 internalResearch
4420 microsoftTeamsIssueIntake
4421 productIntelligence
4422 projectUpdates
4423 slackIssueIntake
4424 zendeskIssueIntake
4425 }
4426
4427 """
4428 [Internal] Comparator for the AI prompt workflow type.
4429 """
4430 input AiPromptTypeComparator {
4431 """
4432 Equals constraint.
4433 """
4434 eq: AiPromptType
4435 """
4436 In-array constraint.
4437 """
4438 in: [AiPromptType!]
4439 """
4440 Not-equals constraint.
4441 """
4442 neq: AiPromptType
4443 """
4444 Not-in-array constraint.
4445 """
4446 nin: [AiPromptType!]
4447 """
4448 Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
4449 """
4450 null: Boolean
4451 }
4452
4453 input AirbyteConfigurationInput {
4454 """
4455 Linear export API key.
4456 """
4457 apiKey: String!
4458 }
4459
4460 """
4461 Payload for app user notification webhook events.
4462 """
4463 type AppUserNotificationWebhookPayload {
4464 """
4465 The type of action that triggered the webhook.
4466 """
4467 action: String!
4468 """
4469 ID of the app user the notification is for.
4470 """
4471 appUserId: String!
4472 """
4473 The time the payload was created.
4474 """
4475 createdAt: DateTime!
4476 """
4477 Details of the notification.
4478 """
4479 notification: NotificationWebhookPayload!
4480 """
4481 ID of the OAuth client the app user is tied to.
4482 """
4483 oauthClientId: String!
4484 """
4485 ID of the organization for which the webhook belongs to.
4486 """
4487 organizationId: String!
4488 """
4489 The type of resource.
4490 """
4491 type: String!
4492 """
4493 The ID of the webhook that sent this event.
4494 """
4495 webhookId: String!
4496 """
4497 Unix timestamp in milliseconds when the webhook was sent.
4498 """
4499 webhookTimestamp: Float!
4500 }
4501
4502 """
4503 Payload for app user team access change webhook events.
4504 """
4505 type AppUserTeamAccessChangedWebhookPayload {
4506 """
4507 The type of action that triggered the webhook.
4508 """
4509 action: String!
4510 """
4511 IDs of the teams the app user was added to.
4512 """
4513 addedTeamIds: [String!]!
4514 """
4515 ID of the app user the notification is for.
4516 """
4517 appUserId: String!
4518 """
4519 Whether the app user can access all public teams.
4520 """
4521 canAccessAllPublicTeams: Boolean!
4522 """
4523 The time the payload was created.
4524 """
4525 createdAt: DateTime!
4526 """
4527 ID of the OAuth client the app user is tied to.
4528 """
4529 oauthClientId: String!
4530 """
4531 ID of the organization for which the webhook belongs to.
4532 """
4533 organizationId: String!
4534 """
4535 IDs of the teams the app user was removed from.
4536 """
4537 removedTeamIds: [String!]!
4538 """
4539 The type of resource.
4540 """
4541 type: String!
4542 """
4543 The ID of the webhook that sent this event.
4544 """
4545 webhookId: String!
4546 """
4547 Unix timestamp in milliseconds when the webhook was sent.
4548 """
4549 webhookTimestamp: Float!
4550 }
4551
4552 """
4553 Public-facing information about an OAuth application. Contains only the fields that are safe to display to users during the authorization flow, excluding sensitive data like client secrets and internal configuration.
4554 """
4555 type Application {
4556 """
4557 OAuth application's client ID.
4558 """
4559 clientId: String!
4560 """
4561 Information about the application.
4562 """
4563 description: String
4564 """
4565 Name of the developer.
4566 """
4567 developer: String!
4568 """
4569 URL of the developer's website, homepage, or documentation.
4570 """
4571 developerUrl: String!
4572 """
4573 OAuth application's ID.
4574 """
4575 id: String!
4576 """
4577 Image of the application.
4578 """
4579 imageUrl: String
4580 """
4581 Application name.
4582 """
4583 name: String!
4584 }
4585
4586 """
4587 Customer approximate need count sorting options.
4588 """
4589 input ApproximateNeedCountSort {
4590 """
4591 Whether nulls should be sorted first or last
4592 """
4593 nulls: PaginationNulls = last
4594 """
4595 The order for the individual sort
4596 """
4597 order: PaginationSortOrder
4598 }
4599
4600 """
4601 A generic payload return from entity archive or deletion mutations.
4602 """
4603 interface ArchivePayload {
4604 """
4605 The identifier of the last sync operation.
4606 """
4607 lastSyncId: Float!
4608 """
4609 Whether the operation was successful.
4610 """
4611 success: Boolean!
4612 }
4613
4614 """
4615 Contains requested archived model objects.
4616 """
4617 type ArchiveResponse {
4618 """
4619 A JSON serialized collection of model objects loaded from the archive
4620 """
4621 archive: String!
4622 """
4623 The version of the remote database. Incremented by 1 for each migration run on the database.
4624 """
4625 databaseVersion: Float!
4626 """
4627 Whether the dependencies for the model objects are included in the archive.
4628 """
4629 includesDependencies: [String!]!
4630 """
4631 The total number of entities in the archive.
4632 """
4633 totalCount: Float!
4634 }
4635
4636 """
4637 A recently archived integration.
4638 """
4639 type ArchivedIntegrationPayload {
4640 """
4641 The time at which the integration was archived.
4642 """
4643 archivedAt: DateTime!
4644 """
4645 Whether the integration had full code access.
4646 """
4647 codeAccess: Boolean
4648 """
4649 The enterprise URL if this is a GitHub Enterprise Cloud integration.
4650 """
4651 enterpriseUrl: String
4652 """
4653 The external identifier of the connected GitHub organization.
4654 """
4655 externalOrgId: String
4656 """
4657 The unique identifier of the integration.
4658 """
4659 id: String!
4660 """
4661 The avatar URL of the connected GitHub organization.
4662 """
4663 orgAvatarUrl: String
4664 """
4665 The login name of the connected GitHub organization.
4666 """
4667 orgLogin: String
4668 """
4669 The integration service type.
4670 """
4671 service: String!
4672 }
4673
4674 type AsksChannelConnectPayload {
4675 """
4676 Whether the bot needs to be manually added to the channel.
4677 """
4678 addBot: Boolean!
4679 """
4680 GitHub-specific details for the operation. Populated by GitHub-related mutations only.
4681 """
4682 gitHub: GitHubIntegrationConnectDetails
4683 """
4684 The integration that was created or updated.
4685 """
4686 integration: Integration
4687 """
4688 The identifier of the last sync operation.
4689 """
4690 lastSyncId: Float!
4691 """
4692 The new Asks Slack channel mapping for the connected channel.
4693 """
4694 mapping: SlackChannelNameMapping!
4695 """
4696 Whether the operation was successful.
4697 """
4698 success: Boolean!
4699 }
4700
4701 """
4702 Issue assignee sorting options.
4703 """
4704 input AssigneeSort {
4705 """
4706 Whether nulls should be sorted first or last
4707 """
4708 nulls: PaginationNulls = last
4709 """
4710 The order for the individual sort
4711 """
4712 order: PaginationSortOrder
4713 }
4714
4715 """
4716 An attachment linking external content to an issue. Attachments represent connections to external resources such as GitHub pull requests, Slack messages, Zendesk tickets, Figma files, Sentry issues, Intercom conversations, and plain URLs. Each attachment has a title and subtitle displayed in the Linear UI, a URL serving as both the link destination and unique identifier per issue, and optional metadata specific to the source integration.
4717 """
4718 type Attachment implements Node {
4719 """
4720 The time at which the entity was archived. Null if the entity has not been archived.
4721 """
4722 archivedAt: DateTime
4723 """
4724 The body data of the attachment, if any.
4725 """
4726 bodyData: String
4727 """
4728 The time at which the entity was created.
4729 """
4730 createdAt: DateTime!
4731 """
4732 The creator of the attachment.
4733 """
4734 creator: User
4735 """
4736 The non-Linear user who created the attachment.
4737 """
4738 externalUserCreator: ExternalUser
4739 """
4740 Whether attachments from the same source application should be visually grouped together in the Linear issue detail view.
4741 """
4742 groupBySource: Boolean!
4743 """
4744 The unique identifier of the entity.
4745 """
4746 id: ID!
4747 """
4748 The issue this attachment belongs to.
4749 """
4750 issue: Issue!
4751 """
4752 Integration-specific metadata for this attachment. The schema varies by source type and may include fields such as pull request status, review counts, commit information, ticket status, or other data from the external system.
4753 """
4754 metadata: JSONObject!
4755 """
4756 The issue this attachment was originally created on. Null if the attachment hasn't been moved.
4757 """
4758 originalIssue: Issue
4759 """
4760 Information about the source which created the attachment.
4761 """
4762 source: JSONObject
4763 """
4764 The source type of the attachment, derived from the source metadata. Returns the integration type (e.g., 'github', 'slack', 'zendesk') or 'unknown' if no source is set.
4765 """
4766 sourceType: String
4767 """
4768 Content for the subtitle line in the Linear attachment widget.
4769 """
4770 subtitle: String
4771 """
4772 Content for the title line in the Linear attachment widget.
4773 """
4774 title: String!
4775 """
4776 The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
4777 been updated after creation.
4778 """
4779 updatedAt: DateTime!
4780 """
4781 The URL of the external resource this attachment links to. Also serves as a unique identifier for the attachment within an issue; no two attachments on the same issue can share the same URL.
4782 """
4783 url: String!
4784 }
4785
4786 """
4787 Attachment collection filtering options.
4788 """
4789 input AttachmentCollectionFilter {
4790 """
4791 Compound filters, all of which need to be matched by the attachment.
4792 """
4793 and: [AttachmentCollectionFilter!]
4794 """
4795 Comparator for the created at date.
4796 """
4797 createdAt: DateComparator
4798 """
4799 Filters that the attachments creator must satisfy.
4800 """
4801 creator: NullableUserFilter
4802 """
4803 Filters that needs to be matched by all attachments.
4804 """
4805 every: AttachmentFilter
4806 """
4807 Comparator for the identifier.
4808 """
4809 id: IDComparator
4810 """
4811 Comparator for the collection length.
4812 """
4813 length: NumberComparator
4814 """
4815 Compound filters, one of which need to be matched by the attachment.
4816 """
4817 or: [AttachmentCollectionFilter!]
4818 """
4819 Filters that needs to be matched by some attachments.
4820 """
4821 some: AttachmentFilter
4822 """
4823 Comparator for the source type.
4824 """
4825 sourceType: SourceTypeComparator
4826 """
4827 Comparator for the subtitle.
4828 """
4829 subtitle: NullableStringComparator
4830 """
4831 Comparator for the title.
4832 """
4833 title: StringComparator
4834 """
4835 Comparator for the updated at date.
4836 """
4837 updatedAt: DateComparator
4838 """
4839 Comparator for the url.
4840 """
4841 url: StringComparator
4842 }
4843
4844 type AttachmentConnection {
4845 edges: [AttachmentEdge!]!
4846 nodes: [Attachment!]!
4847 pageInfo: PageInfo!
4848 }
4849
4850 """
4851 Input for creating a new issue attachment.
4852 """
4853 input AttachmentCreateInput {
4854 """
4855 Create a linked comment with markdown body.
4856 """
4857 commentBody: String
4858 """
4859 [Internal] Create a linked comment with Prosemirror body. Please use `commentBody` instead.
4860 """
4861 commentBodyData: JSONObject
4862 """
4863 Create attachment as a user with the provided name. This option is only available to OAuth applications creating attachments in `actor=application` mode.
4864 """
4865 createAsUser: String
4866 """
4867 Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating attachments in `actor=app` mode.
4868 """
4869 displayIconUrl: String
4870 """
4871 Indicates if attachments for the same source application should be grouped in the Linear UI.
4872 """
4873 groupBySource: Boolean
4874 """
4875 An icon url to display with the attachment. Should be of jpg or png format. Maximum of 1MB in size. Dimensions should be 20x20px for optimal display quality.
4876 """
4877 iconUrl: String
4878 """
4879 The identifier in UUID v4 format. If none is provided, the backend will generate one.
4880 """
4881 id: String
4882 """
4883 The issue to associate the attachment with. Can be a UUID or issue identifier (e.g., 'LIN-123').
4884 """
4885 issueId: String!
4886 """
4887 Attachment metadata object with string and number values.
4888 """
4889 metadata: JSONObject
4890 """
4891 The attachment subtitle.
4892 """
4893 subtitle: String
4894 """
4895 The attachment title.
4896 """
4897 title: String!
4898 """
4899 Attachment location which is also used as an unique identifier for the attachment. If another attachment is created with the same `url` value, existing record is updated instead.
4900 """
4901 url: String!
4902 }
4903
4904 type AttachmentEdge {
4905 """
4906 Used in `before` and `after` args
4907 """
4908 cursor: String!
4909 node: Attachment!
4910 }
4911
4912 """
4913 Attachment filtering options.
4914 """
4915 input AttachmentFilter {
4916 """
4917 Compound filters, all of which need to be matched by the attachment.
4918 """
4919 and: [AttachmentFilter!]
4920 """
4921 Comparator for the created at date.
4922 """
4923 createdAt: DateComparator
4924 """
4925 Filters that the attachments creator must satisfy.
4926 """
4927 creator: NullableUserFilter
4928 """
4929 Comparator for the identifier.
4930 """
4931 id: IDComparator
4932 """
4933 Compound filters, one of which need to be matched by the attachment.
4934 """
4935 or: [AttachmentFilter!]
4936 """
4937 Comparator for the source type.
4938 """
4939 sourceType: SourceTypeComparator
4940 """
4941 Comparator for the subtitle.
4942 """
4943 subtitle: NullableStringComparator
4944 """
4945 Comparator for the title.
4946 """
4947 title: StringComparator
4948 """
4949 Comparator for the updated at date.
4950 """
4951 updatedAt: DateComparator
4952 """
4953 Comparator for the url.
4954 """
4955 url: StringComparator
4956 }
4957
4958 """
4959 The result of an attachment mutation.
4960 """
4961 type AttachmentPayload {
4962 """
4963 The issue attachment that was created.
4964 """
4965 attachment: Attachment!
4966 """
4967 The identifier of the last sync operation.
4968 """
4969 lastSyncId: Float!
4970 """
4971 Whether the operation was successful.
4972 """
4973 success: Boolean!
4974 }
4975
4976 """
4977 The result of an attachment sources query.
4978 """
4979 type AttachmentSourcesPayload {
4980 """
4981 A unique list of all source types used in this workspace.
4982 """
4983 sources: JSONObject!
4984 }
4985
4986 """
4987 Input for updating an existing issue attachment.
4988 """
4989 input AttachmentUpdateInput {
4990 """
4991 An icon url to display with the attachment. Should be of jpg or png format. Maximum of 1MB in size. Dimensions should be 20x20px for optimal display quality.
4992 """
4993 iconUrl: String
4994 """
4995 Attachment metadata object with string and number values.
4996 """
4997 metadata: JSONObject
4998 """
4999 The attachment subtitle.
5000 """
Showing first 5,000 of 53,680 lines. View raw