For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
ContactLearn More
GuidesReferenceSamplesLicenseChangelog
GuidesReferenceSamplesLicenseChangelog
  • SDKs
    • Overview
  • REST
  • gRPC
        • UNARYCreateTask
        • UNARYGetTask
        • UNARYQueryTasks
        • UNARYUpdateStatus
        • UNARYCancelTask
        • STREAMListenAsAgent
        • STREAMListenForManualControlFrames
        • STREAMStreamTasks
ContactLearn More
gRPCanduril.taskmanager.v1TaskManagerAPI

StreamTasks

Example request
1{
2 "task_type": {
3 "task_type_urls": {
4 "task_type_urls": [
5 "example"
6 ]
7 }
8 },
9 "rate_limit": {
10 "update_per_task_limit_ms": 42
11 },
12 "views": [
13 0
14 ],
15 "heartbeat_interval_ms": 42,
16 "exclude_preexisting_tasks": true,
17 "update_start_time": {
18 "seconds": 42,
19 "nanos": 42
20 },
21 "parent_task_id": "example",
22 "assignee": {
23 "agent": {
24 "system": {
25 "service_name": "example",
26 "entity_id": "example",
27 "manages_own_scheduling": true
28 }
29 },
30 "on_behalf_of": {}
31 }
32}
Example response
1{
2 "task_event": {
3 "event_type": 0,
4 "task": {
5 "version": {
6 "task_id": "example",
7 "definition_version": 42,
8 "status_version": 42
9 },
10 "specification": {
11 "type_url": "example",
12 "value": "bytes"
13 },
14 "created_by": {
15 "agent": {
16 "system": {
17 "service_name": "example",
18 "entity_id": "example",
19 "manages_own_scheduling": true
20 }
21 },
22 "on_behalf_of": {}
23 },
24 "last_updated_by": {
25 "agent": {
26 "system": {
27 "service_name": "example",
28 "entity_id": "example",
29 "manages_own_scheduling": true
30 }
31 },
32 "on_behalf_of": {}
33 },
34 "last_update_time": {
35 "seconds": 42,
36 "nanos": 42
37 },
38 "status": {
39 "status": 0,
40 "task_error": {
41 "code": 0,
42 "message": "example",
43 "error_details": {
44 "type_url": "example",
45 "value": "bytes"
46 }
47 },
48 "progress": {
49 "type_url": "example",
50 "value": "bytes"
51 },
52 "result": {
53 "type_url": "example",
54 "value": "bytes"
55 },
56 "start_time": {
57 "seconds": 42,
58 "nanos": 42
59 },
60 "estimate": {
61 "type_url": "example",
62 "value": "bytes"
63 },
64 "allocation": {
65 "active_agents": [
66 {
67 "entity_id": "example"
68 }
69 ]
70 }
71 },
72 "scheduled_time": {
73 "seconds": 42,
74 "nanos": 42
75 },
76 "relations": {
77 "assignee": {
78 "agent": {
79 "system": {
80 "service_name": "example",
81 "entity_id": "example",
82 "manages_own_scheduling": true
83 }
84 },
85 "on_behalf_of": {}
86 },
87 "parent_task_id": "example"
88 },
89 "description": "example",
90 "is_executed_elsewhere": true,
91 "create_time": {
92 "seconds": 42,
93 "nanos": 42
94 },
95 "replication": {
96 "stale_time": {
97 "seconds": 42,
98 "nanos": 42
99 }
100 },
101 "initial_entities": [
102 {
103 "entity": {
104 "entity_id": "example",
105 "description": "example",
106 "is_live": true,
107 "created_time": {
108 "seconds": 42,
109 "nanos": 42
110 },
111 "expiry_time": {
112 "seconds": 42,
113 "nanos": 42
114 },
115 "no_expiry": true,
116 "status": {
117 "platform_activity": "example",
118 "role": "example"
119 },
120 "location": {
121 "position": {
122 "latitude_degrees": 42,
123 "longitude_degrees": 42,
124 "altitude_hae_meters": {
125 "value": 42
126 },
127 "altitude_agl_meters": {
128 "value": 42
129 },
130 "altitude_asf_meters": {
131 "value": 42
132 },
133 "pressure_depth_meters": {
134 "value": 42
135 }
136 },
137 "velocity_enu": {
138 "e": 42,
139 "n": 42,
140 "u": 42
141 },
142 "speed_mps": {
143 "value": 42
144 },
145 "acceleration": {
146 "e": 42,
147 "n": 42,
148 "u": 42
149 },
150 "attitude_enu": {
151 "x": 42,
152 "y": 42,
153 "z": 42,
154 "w": 42
155 }
156 },
157 "location_uncertainty": {
158 "position_enu_cov": {
159 "mxx": 42,
160 "mxy": 42,
161 "mxz": 42,
162 "myy": 42,
163 "myz": 42,
164 "mzz": 42
165 },
166 "velocity_enu_cov": {
167 "mxx": 42,
168 "mxy": 42,
169 "mxz": 42,
170 "myy": 42,
171 "myz": 42,
172 "mzz": 42
173 },
174 "position_error_ellipse": {
175 "probability": {
176 "value": 42
177 },
178 "semi_major_axis_m": {
179 "value": 42
180 },
181 "semi_minor_axis_m": {
182 "value": 42
183 },
184 "orientation_d": {
185 "value": 42
186 }
187 }
188 },
189 "geo_shape": {
190 "shape": {
191 "point": {
192 "position": {
193 "latitude_degrees": 42,
194 "longitude_degrees": 42,
195 "altitude_hae_meters": {
196 "value": 42
197 },
198 "altitude_agl_meters": {
199 "value": 42
200 },
201 "altitude_asf_meters": {
202 "value": 42
203 },
204 "pressure_depth_meters": {
205 "value": 42
206 }
207 }
208 }
209 }
210 },
211 "geo_details": {
212 "type_details": {
213 "control_area": {
214 "type": 0
215 }
216 },
217 "type": 0
218 },
219 "aliases": {
220 "alternate_ids": [
221 {
222 "id": "example",
223 "type": 0
224 }
225 ],
226 "name": "example"
227 },
228 "tracked": {
229 "track_quality_wrapper": {
230 "value": 42
231 },
232 "sensor_hits": {
233 "value": 42
234 },
235 "number_of_objects": {
236 "lower_bound": 42,
237 "upper_bound": 42
238 },
239 "radar_cross_section": {
240 "value": 42
241 },
242 "last_measurement_time": {
243 "seconds": 42,
244 "nanos": 42
245 },
246 "line_of_bearing": {
247 "detection_range": {
248 "range_estimate_m": {
249 "value": {
250 "value": 42
251 },
252 "sigma": {
253 "value": 42
254 }
255 }
256 },
257 "angle_of_arrival": {
258 "relative_pose": {
259 "pos": {
260 "lon": 42,
261 "lat": 42,
262 "alt": 42,
263 "is2d": true,
264 "altitude_reference": 0
265 },
266 "att_enu": {
267 "x": 42,
268 "y": 42,
269 "z": 42,
270 "w": 42
271 }
272 },
273 "bearing_elevation_covariance_rad2": {
274 "mxx": 42,
275 "mxy": 42,
276 "myy": 42
277 }
278 }
279 }
280 },
281 "correlation": {
282 "correlation": {
283 "primary": {
284 "secondary_entity_ids": [
285 "example"
286 ]
287 }
288 },
289 "membership": {
290 "membership": {
291 "primary": {}
292 },
293 "correlation_set_id": "example",
294 "metadata": {
295 "provenance": {
296 "integration_name": "example",
297 "data_type": "example",
298 "source_id": "example",
299 "source_update_time": {
300 "seconds": 42,
301 "nanos": 42
302 },
303 "source_description": "example"
304 },
305 "replication_mode": 0,
306 "type": 0
307 }
308 },
309 "decorrelation": {
310 "all": {
311 "metadata": {
312 "provenance": {
313 "integration_name": "example",
314 "data_type": "example",
315 "source_id": "example",
316 "source_update_time": {
317 "seconds": 42,
318 "nanos": 42
319 },
320 "source_description": "example"
321 },
322 "replication_mode": 0,
323 "type": 0
324 }
325 },
326 "decorrelated_entities": [
327 {
328 "entity_id": "example",
329 "metadata": {
330 "provenance": {
331 "integration_name": "example",
332 "data_type": "example",
333 "source_id": "example",
334 "source_update_time": {
335 "seconds": 42,
336 "nanos": 42
337 },
338 "source_description": "example"
339 },
340 "replication_mode": 0,
341 "type": 0
342 }
343 }
344 ]
345 }
346 },
347 "mil_view": {
348 "disposition": 0,
349 "environment": 0,
350 "nationality": 0
351 },
352 "ontology": {
353 "platform_type": "example",
354 "specific_type": "example",
355 "template": 0
356 },
357 "sensors": {
358 "sensors": [
359 {
360 "sensor_id": "example",
361 "operational_state": 0,
362 "sensor_type": 0,
363 "sensor_description": "example",
364 "rf_configuraton": {
365 "frequency_range_hz": [
366 {
367 "minimum_frequency_hz": {
368 "frequency_hz": {
369 "value": {
370 "value": 42
371 },
372 "sigma": {
373 "value": 42
374 }
375 }
376 },
377 "maximum_frequency_hz": {
378 "frequency_hz": {
379 "value": {
380 "value": 42
381 },
382 "sigma": {
383 "value": 42
384 }
385 }
386 }
387 }
388 ],
389 "bandwidth_range_hz": [
390 {
391 "minimum_bandwidth": {
392 "bandwidth_hz": {
393 "value": 42
394 }
395 },
396 "maximum_bandwidth": {
397 "bandwidth_hz": {
398 "value": 42
399 }
400 }
401 }
402 ]
403 },
404 "last_detection_timestamp": {
405 "seconds": 42,
406 "nanos": 42
407 },
408 "fields_of_view": [
409 {
410 "fov_id": 42,
411 "mount_id": "example",
412 "projected_frustum": {
413 "upper_left": {
414 "latitude_degrees": 42,
415 "longitude_degrees": 42,
416 "altitude_hae_meters": {
417 "value": 42
418 },
419 "altitude_agl_meters": {
420 "value": 42
421 },
422 "altitude_asf_meters": {
423 "value": 42
424 },
425 "pressure_depth_meters": {
426 "value": 42
427 }
428 },
429 "upper_right": {
430 "latitude_degrees": 42,
431 "longitude_degrees": 42,
432 "altitude_hae_meters": {
433 "value": 42
434 },
435 "altitude_agl_meters": {
436 "value": 42
437 },
438 "altitude_asf_meters": {
439 "value": 42
440 },
441 "pressure_depth_meters": {
442 "value": 42
443 }
444 },
445 "bottom_right": {
446 "latitude_degrees": 42,
447 "longitude_degrees": 42,
448 "altitude_hae_meters": {
449 "value": 42
450 },
451 "altitude_agl_meters": {
452 "value": 42
453 },
454 "altitude_asf_meters": {
455 "value": 42
456 },
457 "pressure_depth_meters": {
458 "value": 42
459 }
460 },
461 "bottom_left": {
462 "latitude_degrees": 42,
463 "longitude_degrees": 42,
464 "altitude_hae_meters": {
465 "value": 42
466 },
467 "altitude_agl_meters": {
468 "value": 42
469 },
470 "altitude_asf_meters": {
471 "value": 42
472 },
473 "pressure_depth_meters": {
474 "value": 42
475 }
476 }
477 },
478 "projected_center_ray": {
479 "latitude_degrees": 42,
480 "longitude_degrees": 42,
481 "altitude_hae_meters": {
482 "value": 42
483 },
484 "altitude_agl_meters": {
485 "value": 42
486 },
487 "altitude_asf_meters": {
488 "value": 42
489 },
490 "pressure_depth_meters": {
491 "value": 42
492 }
493 },
494 "center_ray_pose": {
495 "pos": {
496 "latitude_degrees": 42,
497 "longitude_degrees": 42,
498 "altitude_hae_meters": {
499 "value": 42
500 },
501 "altitude_agl_meters": {
502 "value": 42
503 },
504 "altitude_asf_meters": {
505 "value": 42
506 },
507 "pressure_depth_meters": {
508 "value": 42
509 }
510 },
511 "orientation": {
512 "x": 42,
513 "y": 42,
514 "z": 42,
515 "w": 42
516 }
517 },
518 "horizontal_fov": 42,
519 "vertical_fov": 42,
520 "range": {
521 "value": 42
522 },
523 "mode": 0
524 }
525 ]
526 }
527 ]
528 },
529 "payloads": {
530 "payload_configurations": [
531 {
532 "config": {
533 "capability_id": "example",
534 "quantity": 42,
535 "effective_environment": [
536 0
537 ],
538 "payload_operational_state": 0,
539 "payload_description": "example"
540 }
541 }
542 ]
543 },
544 "power_state": {
545 "source_id_to_state": [
546 null
547 ]
548 },
549 "provenance": {
550 "integration_name": "example",
551 "data_type": "example",
552 "source_id": "example",
553 "source_update_time": {
554 "seconds": 42,
555 "nanos": 42
556 },
557 "source_description": "example"
558 },
559 "overrides": {
560 "override": [
561 {
562 "request_id": "example",
563 "field_path": "example",
564 "masked_field_value": {},
565 "status": 0,
566 "provenance": {
567 "integration_name": "example",
568 "data_type": "example",
569 "source_id": "example",
570 "source_update_time": {
571 "seconds": 42,
572 "nanos": 42
573 },
574 "source_description": "example"
575 },
576 "type": 0,
577 "request_timestamp": {
578 "seconds": 42,
579 "nanos": 42
580 }
581 }
582 ]
583 },
584 "indicators": {
585 "simulated": {
586 "value": true
587 },
588 "exercise": {
589 "value": true
590 },
591 "emergency": {
592 "value": true
593 },
594 "c2": {
595 "value": true
596 },
597 "egressable": {
598 "value": true
599 },
600 "starred": {
601 "value": true
602 }
603 },
604 "target_priority": {
605 "high_value_target": {
606 "is_high_value_target": true,
607 "target_priority": 42,
608 "target_matches": [
609 {
610 "high_value_target_list_id": "example",
611 "high_value_target_description_id": "example"
612 }
613 ],
614 "is_high_payoff_target": true
615 },
616 "threat": {
617 "is_threat": true
618 }
619 },
620 "signal": {
621 "frequency_measurement": {
622 "frequency_center": {
623 "frequency_hz": {
624 "value": {
625 "value": 42
626 },
627 "sigma": {
628 "value": 42
629 }
630 }
631 }
632 },
633 "report": {
634 "line_of_bearing": {
635 "angle_of_arrival": {
636 "relative_pose": {
637 "pos": {
638 "lon": 42,
639 "lat": 42,
640 "alt": 42,
641 "is2d": true,
642 "altitude_reference": 0
643 },
644 "att_enu": {
645 "x": 42,
646 "y": 42,
647 "z": 42,
648 "w": 42
649 }
650 },
651 "bearing_elevation_covariance_rad2": {
652 "mxx": 42,
653 "mxy": 42,
654 "myy": 42
655 }
656 },
657 "detection_range": {
658 "range_estimate_m": {
659 "value": {
660 "value": 42
661 },
662 "sigma": {
663 "value": 42
664 }
665 }
666 }
667 }
668 },
669 "bandwidth_hz": {
670 "value": 42
671 },
672 "signal_to_noise_ratio": {
673 "value": 42
674 },
675 "emitter_notations": [
676 {
677 "emitter_notation": "example",
678 "confidence": {
679 "value": 42
680 }
681 }
682 ],
683 "pulse_width_s": {
684 "value": 42
685 },
686 "pulse_repetition_interval": {
687 "pulse_repetition_interval_s": {
688 "value": {
689 "value": 42
690 },
691 "sigma": {
692 "value": 42
693 }
694 }
695 },
696 "scan_characteristics": {
697 "scan_type": 0,
698 "scan_period_s": {
699 "value": 42
700 }
701 }
702 },
703 "transponder_codes": {
704 "_mode_c_altitude_ft": {
705 "mode_c_altitude_ft": 42
706 },
707 "mode1": 42,
708 "mode2": 42,
709 "mode3": 42,
710 "mode4_interrogation_response": 0,
711 "mode5": {
712 "mode5_interrogation_response": 0,
713 "mode5": 42,
714 "mode5_platform_id": 42
715 },
716 "mode_s": {
717 "id": "example",
718 "address": 42
719 }
720 },
721 "data_classification": {
722 "default": {
723 "level": 0,
724 "caveats": [
725 "example"
726 ]
727 },
728 "fields": [
729 {
730 "field_path": "example",
731 "classification_information": {
732 "level": 0,
733 "caveats": [
734 "example"
735 ]
736 }
737 }
738 ]
739 },
740 "task_catalog": {
741 "task_definitions": [
742 {
743 "task_specification_url": "example"
744 }
745 ]
746 },
747 "media": {
748 "media": [
749 {
750 "item_identifier": "example",
751 "type": 0,
752 "relative_path": "example"
753 }
754 ]
755 },
756 "relationships": {
757 "relationships": [
758 {
759 "related_entity_id": "example",
760 "relationship_id": "example",
761 "relationship_type": {
762 "type": {
763 "tracked_by": {
764 "actively_tracking_sensors": {
765 "sensors": [
766 {
767 "sensor_id": "example",
768 "operational_state": 0,
769 "sensor_type": 0,
770 "sensor_description": "example",
771 "rf_configuraton": {
772 "frequency_range_hz": [
773 {
774 "minimum_frequency_hz": {},
775 "maximum_frequency_hz": {}
776 }
777 ],
778 "bandwidth_range_hz": [
779 {
780 "minimum_bandwidth": {},
781 "maximum_bandwidth": {}
782 }
783 ]
784 },
785 "last_detection_timestamp": {
786 "seconds": 42,
787 "nanos": 42
788 },
789 "fields_of_view": [
790 {
791 "fov_id": 42,
792 "mount_id": "example",
793 "projected_frustum": {
794 "upper_left": {},
795 "upper_right": {},
796 "bottom_right": {},
797 "bottom_left": {}
798 },
799 "projected_center_ray": {
800 "latitude_degrees": 42,
801 "longitude_degrees": 42,
802 "altitude_hae_meters": {},
803 "altitude_agl_meters": {},
804 "altitude_asf_meters": {},
805 "pressure_depth_meters": {}
806 },
807 "center_ray_pose": {
808 "pos": {},
809 "orientation": {}
810 },
811 "horizontal_fov": 42,
812 "vertical_fov": 42,
813 "range": {
814 "value": 42
815 },
816 "mode": 0
817 }
818 ]
819 }
820 ]
821 },
822 "last_measurement_timestamp": {
823 "seconds": 42,
824 "nanos": 42
825 }
826 }
827 }
828 }
829 }
830 ]
831 },
832 "visual_details": {
833 "range_rings": {
834 "min_distance_m": {
835 "value": 42
836 },
837 "max_distance_m": {
838 "value": 42
839 },
840 "ring_count": 42,
841 "ring_line_color": {
842 "red": 42,
843 "green": 42,
844 "blue": 42,
845 "alpha": {
846 "value": 42
847 }
848 }
849 }
850 },
851 "dimensions": {
852 "length_m": 42
853 },
854 "route_details": {
855 "destination_name": "example",
856 "estimated_arrival_time": {
857 "seconds": 42,
858 "nanos": 42
859 }
860 },
861 "schedules": {
862 "schedules": [
863 {
864 "windows": [
865 {
866 "cron_expression": "example",
867 "duration_millis": 42
868 }
869 ],
870 "schedule_id": "example",
871 "schedule_type": 0
872 }
873 ]
874 },
875 "health": {
876 "connection_status": 0,
877 "health_status": 0,
878 "components": [
879 {
880 "id": "example",
881 "name": "example",
882 "health": 0,
883 "messages": [
884 {
885 "status": 0,
886 "message": "example"
887 }
888 ],
889 "update_time": {
890 "seconds": 42,
891 "nanos": 42
892 }
893 }
894 ],
895 "update_time": {
896 "seconds": 42,
897 "nanos": 42
898 },
899 "active_alerts": [
900 {
901 "alert_code": "example",
902 "description": "example",
903 "level": 0,
904 "activated_time": {
905 "seconds": 42,
906 "nanos": 42
907 },
908 "active_conditions": [
909 {
910 "condition_code": "example",
911 "description": "example"
912 }
913 ]
914 }
915 ]
916 },
917 "group_details": {
918 "group_type": {
919 "team": {}
920 }
921 },
922 "supplies": {
923 "munitions": [
924 {
925 "munition_id": "example",
926 "name": "example",
927 "quantity_units": 42
928 }
929 ],
930 "fuel": [
931 {
932 "fuel_id": "example",
933 "name": "example",
934 "reported_date": {
935 "seconds": 42,
936 "nanos": 42
937 },
938 "amount_gallons": 42,
939 "max_authorized_capacity_gallons": 42,
940 "operational_requirement_gallons": 42,
941 "data_classification": {
942 "default": {
943 "level": 0,
944 "caveats": [
945 "example"
946 ]
947 },
948 "fields": [
949 {
950 "field_path": "example",
951 "classification_information": {
952 "level": 0,
953 "caveats": [
954 "example"
955 ]
956 }
957 }
958 ]
959 },
960 "data_source": "example"
961 }
962 ]
963 },
964 "orbit": {
965 "orbit_mean_elements": {
966 "metadata": {
967 "creation_date": {
968 "seconds": 42,
969 "nanos": 42
970 },
971 "originator": {
972 "value": "example"
973 },
974 "message_id": {
975 "value": "example"
976 },
977 "ref_frame": 0,
978 "ref_frame_epoch": {
979 "seconds": 42,
980 "nanos": 42
981 },
982 "mean_element_theory": 0
983 },
984 "mean_keplerian_elements": {
985 "line2_field8": {
986 "semi_major_axis_km": 42
987 },
988 "epoch": {
989 "seconds": 42,
990 "nanos": 42
991 },
992 "eccentricity": 42,
993 "inclination_deg": 42,
994 "ra_of_asc_node_deg": 42,
995 "arg_of_pericenter_deg": 42,
996 "mean_anomaly_deg": 42,
997 "gm": {
998 "value": 42
999 }
1000 },
1001 "tle_parameters": {
1002 "line1_field11": {
1003 "bstar": 42
1004 },
1005 "line1_field10": {
1006 "mean_motion_ddot": 42
1007 },
1008 "ephemeris_type": {
1009 "value": 42
1010 },
1011 "classification_type": {
1012 "value": "example"
1013 },
1014 "norad_cat_id": {
1015 "value": 42
1016 },
1017 "element_set_no": {
1018 "value": 42
1019 },
1020 "rev_at_epoch": {
1021 "value": 42
1022 },
1023 "mean_motion_dot": {
1024 "value": 42
1025 }
1026 }
1027 }
1028 },
1029 "symbology": {
1030 "standard": {
1031 "mil_std_2525_c": {
1032 "sidc": "example"
1033 }
1034 }
1035 }
1036 },
1037 "snapshot": true
1038 }
1039 ],
1040 "owner": {
1041 "entity_id": "example"
1042 },
1043 "retry_strategy": {
1044 "strategy": {
1045 "fixed_retry_strategy": {
1046 "retry_interval": {
1047 "seconds": 42,
1048 "nanos": 42
1049 }
1050 }
1051 }
1052 },
1053 "delivery_state": {
1054 "status": 0,
1055 "error": {
1056 "code": 0,
1057 "message": "example"
1058 },
1059 "delivery_constraints": {
1060 "deliver_after": {
1061 "seconds": 42,
1062 "nanos": 42
1063 },
1064 "deliver_before": {
1065 "seconds": 42,
1066 "nanos": 42
1067 }
1068 }
1069 },
1070 "display_name": "example"
1071 },
1072 "task_view": 0,
1073 "time": {
1074 "seconds": 42,
1075 "nanos": 42
1076 }
1077 },
1078 "heartbeat": {
1079 "timestamp": {
1080 "seconds": 42,
1081 "nanos": 42
1082 }
1083 }
1084}
Establishes a server streaming connection that delivers task updates in real-time. The stream delivers all existing non-terminal tasks when first connected, followed by real-time updates for task creation and status changes. Additionally, heartbeat messages are sent periodically to maintain the connection. The stream delivers two types of responses: - Heartbeat: A periodic message to maintain connection health - TaskEvent: Contains a task and an event type indicating whether the task was created, updated, or was preexisting when the stream was established Filtering options allow narrowing the stream to specific task types, statuses, assignees, parent tasks, or tasks updated after a certain time.
Was this page helpful?
Previous

Establishes a server streaming connection that delivers task updates in real-time.

The stream delivers all existing non-terminal tasks when first connected, followed by real-time updates for task creation and status changes. Additionally, heartbeat messages are sent periodically to maintain the connection.

The stream delivers two types of responses:

  • Heartbeat: A periodic message to maintain connection health
  • TaskEvent: Contains a task and an event type indicating whether the task was created, updated, or was preexisting when the stream was established

Filtering options allow narrowing the stream to specific task types, statuses, assignees, parent tasks, or tasks updated after a certain time.

StreamTasksRequest

Request
This endpoint expects an object.
task_typeobject or string
rate_limitobject
Rate limit configuration for task update events.
viewslist of enums

Optional additional views of a Task. If not set, defaults to TASK_VIEW_MANAGER.

Allowed values:
heartbeat_interval_msuint

The time interval, in milliseconds, that determines the frequency at which to send heartbeat events. Defaults to 30000 (30 seconds).

exclude_preexisting_tasksboolean
Optional flag to only include tasks created or updated after the stream is initiated, and not any previous preexisting tasks. If unset or false, the stream will include any new tasks and task updates, as well as all preexisting tasks.
update_start_timeobject
If provided, returns tasks which have been updated since the given time.
parent_task_idstring

A filter for tasks with a specific parent task ID. Note: This filter is mutually exclusive with all other filter fields.

assigneeobject
A filter for tasks assigned to a specific principal.
status_filterobject
Filters on provided status types in the filter.

StreamTasksResponse

Stream response
This endpoint returns an object.
task_eventobject
Task event associated with the streaming request.
heartbeatobject
Heartbeat message signaling liveliness of the stream.