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

CreateTask

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

GetTask

Next

Creates a new Task in the system with the specified parameters.

This method initiates a new task with a unique ID, if one is not provided, sets the initial task state to STATUS_SENT, and establishes task ownership. The task must be assigned to a specific agent using the Relations field.

Once created, a task enters the lifecycle workflow and can be tracked, updated, and managed through other Task Manager APIs.

CreateTaskRequest

Request
This endpoint expects an object.
specificationobject
The path for the Protobuf task definition, and the complete task data.
authorobject
Who or what is creating this Task. For example, if a user created this Task via a UI, it would contain the "user" Principal type with the user ID of that user. Or if a service is calling the CreateTask endpoint, then a "service" Principal type is to be provided.
relationsobject
Any relationships associated with this Task, such as a parent Task or an assignee this Task is designated to for execution.
descriptionstring

Longer, free-form, human-readable description of this Task.

is_executed_elsewhereboolean

If set, then task-manager will not trigger execution of this task on an agent. Useful for when ingesting tasks from an external system that is triggering execution of tasks on agents.

task_idstring

If non-empty, will set the requested Task ID, otherwise will generate a new random GUID. Will reject if supplied Task ID does not match [A-Za-z0-9_-.]\{5,36\}.

initial_entitieslist of objects
Indicates an initial set of entities that can be used to execute an entity aware task. For example, an entity Objective, an entity Keep In Zone, etc.
retry_strategyobject
Any retry strategy for task execution or update.
delivery_constraintsobject
Any scheduling constraints for Lattice delivery of the task.
display_namestringDeprecated

DEPRECATED: Human-readable display name for this Task, should be short (<100 chars).

CreateTaskResponse

Response
This endpoint returns an object.
taskobject
Task that was created.