Listen as agent

POST

https://example.developer.anduril.com/api/v1/agent/listen

POST

/api/v1/agent/listen

1 curl -X POST https://example.developer.anduril.com/api/v1/agent/listen \
2      -H "Content-Type: application/json" \
3      -d '{}'

Try it

1 {
2   "executeRequest": {
3     "task": {
4       "version": {
5         "taskId": "string",
6         "definitionVersion": 1,
7         "statusVersion": 1
8       },
9       "displayName": "string",
10       "specification": {
11         "@type": "string"
12       },
13       "createdBy": {
14         "system": {
15           "serviceName": "string",
16           "entityId": "string",
17           "managesOwnScheduling": true
18         },
19         "user": {
20           "userId": "string"
21         },
22         "team": {
23           "entityId": "string",
24           "members": [
25             {
26               "entityId": "string"
27             }
28           ]
29         },
30         "onBehalfOf": {}
31       },
32       "lastUpdatedBy": {
33         "system": {
34           "serviceName": "string",
35           "entityId": "string",
36           "managesOwnScheduling": true
37         },
38         "user": {
39           "userId": "string"
40         },
41         "team": {
42           "entityId": "string",
43           "members": [
44             {
45               "entityId": "string"
46             }
47           ]
48         },
49         "onBehalfOf": {}
50       },
51       "lastUpdateTime": "2024-01-15T09:30:00Z",
52       "status": {
53         "status": "STATUS_INVALID",
54         "taskError": {
55           "code": "ERROR_CODE_INVALID",
56           "message": "string",
57           "errorDetails": {
58             "@type": "string"
59           }
60         },
61         "progress": {
62           "@type": "string"
63         },
64         "result": {
65           "@type": "string"
66         },
67         "startTime": "2024-01-15T09:30:00Z",
68         "estimate": {
69           "@type": "string"
70         },
71         "allocation": {
72           "activeAgents": [
73             {
74               "entityId": "string"
75             }
76           ]
77         }
78       },
79       "scheduledTime": "2024-01-15T09:30:00Z",
80       "relations": {
81         "assignee": {
82           "system": {
83             "serviceName": "string",
84             "entityId": "string",
85             "managesOwnScheduling": true
86           },
87           "user": {
88             "userId": "string"
89           },
90           "team": {
91             "entityId": "string",
92             "members": [
93               {
94                 "entityId": "string"
95               }
96             ]
97           },
98           "onBehalfOf": {}
99         },
100         "parentTaskId": "string"
101       },
102       "description": "string",
103       "isExecutedElsewhere": true,
104       "createTime": "2024-01-15T09:30:00Z",
105       "replication": {
106         "staleTime": "2024-01-15T09:30:00Z"
107       },
108       "initialEntities": [
109         {
110           "entity": {
111             "entityId": "string",
112             "description": "string",
113             "isLive": true,
114             "createdTime": "2024-01-15T09:30:00Z",
115             "expiryTime": "2024-01-15T09:30:00Z",
116             "status": {
117               "code": 1,
118               "message": "string",
119               "details": [
120                 {
121                   "@type": "string"
122                 }
123               ]
124             },
125             "location": {
126               "position": {
127                 "latitudeDegrees": 1.1,
128                 "longitudeDegrees": 1.1,
129                 "altitudeHaeMeters": 1.1,
130                 "altitudeAglMeters": 1.1,
131                 "altitudeAsfMeters": 1.1,
132                 "pressureDepthMeters": 1.1
133               },
134               "velocityEnu": {
135                 "e": 1.1,
136                 "n": 1.1,
137                 "u": 1.1
138               },
139               "speedMps": 1.1,
140               "acceleration": {
141                 "e": 1.1,
142                 "n": 1.1,
143                 "u": 1.1
144               },
145               "attitudeEnu": {
146                 "x": 1.1,
147                 "y": 1.1,
148                 "z": 1.1,
149                 "w": 1.1
150               }
151             },
152             "locationUncertainty": {
153               "positionEnuCov": {
154                 "mxx": 1.1,
155                 "mxy": 1.1,
156                 "mxz": 1.1,
157                 "myy": 1.1,
158                 "myz": 1.1,
159                 "mzz": 1.1
160               },
161               "velocityEnuCov": {
162                 "mxx": 1.1,
163                 "mxy": 1.1,
164                 "mxz": 1.1,
165                 "myy": 1.1,
166                 "myz": 1.1,
167                 "mzz": 1.1
168               },
169               "positionErrorEllipse": {
170                 "probability": 1.1,
171                 "semiMajorAxisM": 1.1,
172                 "semiMinorAxisM": 1.1,
173                 "orientationD": 1.1
174               }
175             },
176             "geoShape": {
177               "point": {
178                 "position": {
179                   "latitudeDegrees": 1.1,
180                   "longitudeDegrees": 1.1,
181                   "altitudeHaeMeters": 1.1,
182                   "altitudeAglMeters": 1.1,
183                   "altitudeAsfMeters": 1.1,
184                   "pressureDepthMeters": 1.1
185                 }
186               },
187               "line": {
188                 "positions": [
189                   {
190                     "latitudeDegrees": 1.1,
191                     "longitudeDegrees": 1.1,
192                     "altitudeHaeMeters": 1.1,
193                     "altitudeAglMeters": 1.1,
194                     "altitudeAsfMeters": 1.1,
195                     "pressureDepthMeters": 1.1
196                   }
197                 ]
198               },
199               "polygon": {
200                 "rings": [
201                   {
202                     "positions": [
203                       {
204                         "position": {},
205                         "heightM": 1.1
206                       }
207                     ]
208                   }
209                 ],
210                 "isRectangle": true
211               },
212               "ellipse": {
213                 "semiMajorAxisM": 1.1,
214                 "semiMinorAxisM": 1.1,
215                 "orientationD": 1.1,
216                 "heightM": 1.1
217               },
218               "ellipsoid": {
219                 "forwardAxisM": 1.1,
220                 "sideAxisM": 1.1,
221                 "upAxisM": 1.1
222               }
223             },
224             "geoDetails": {
225               "type": "GEO_TYPE_INVALID",
226               "controlArea": {
227                 "type": "CONTROL_AREA_TYPE_INVALID"
228               },
229               "acm": {
230                 "acmType": "ACM_DETAIL_TYPE_INVALID",
231                 "acmDescription": "string"
232               }
233             },
234             "aliases": {
235               "alternateIds": [
236                 {
237                   "id": "string",
238                   "type": "ALT_ID_TYPE_INVALID"
239                 }
240               ],
241               "name": "string"
242             },
243             "tracked": {
244               "trackQualityWrapper": 1,
245               "sensorHits": 1,
246               "numberOfObjects": {
247                 "lowerBound": 1,
248                 "upperBound": 1
249               },
250               "radarCrossSection": 1.1,
251               "lastMeasurementTime": "2024-01-15T09:30:00Z",
252               "lineOfBearing": {
253                 "angleOfArrival": {
254                   "relativePose": {},
255                   "bearingElevationCovarianceRad2": {}
256                 },
257                 "rangeEstimateM": {
258                   "value": {},
259                   "sigma": {}
260                 },
261                 "maxRangeM": {
262                   "value": {},
263                   "sigma": {}
264                 }
265               }
266             },
267             "correlation": {
268               "primary": {
269                 "secondaryEntityIds": [
270                   "string"
271                 ]
272               },
273               "secondary": {
274                 "primaryEntityId": "string",
275                 "metadata": {
276                   "provenance": {},
277                   "replicationMode": {},
278                   "type": {}
279                 }
280               },
281               "membership": {
282                 "correlationSetId": "string",
283                 "primary": {},
284                 "nonPrimary": {},
285                 "metadata": {
286                   "provenance": {},
287                   "replicationMode": {},
288                   "type": {}
289                 }
290               },
291               "decorrelation": {
292                 "all": {
293                   "metadata": {}
294                 },
295                 "decorrelatedEntities": [
296                   {
297                     "entityId": "string",
298                     "metadata": {}
299                   }
300                 ]
301               }
302             },
303             "milView": {
304               "disposition": "DISPOSITION_UNKNOWN",
305               "environment": "ENVIRONMENT_UNKNOWN",
306               "nationality": "NATIONALITY_INVALID"
307             },
308             "ontology": {
309               "platformType": "string",
310               "specificType": "string",
311               "template": "TEMPLATE_INVALID"
312             },
313             "sensors": {
314               "sensors": [
315                 {
316                   "sensorId": "string",
317                   "operationalState": "OPERATIONAL_STATE_INVALID",
318                   "sensorType": "SENSOR_TYPE_INVALID",
319                   "sensorDescription": "string",
320                   "rfConfiguraton": {
321                     "frequencyRangeHz": [
322                       {
323                         "minimumFrequencyHz": {},
324                         "maximumFrequencyHz": {}
325                       }
326                     ],
327                     "bandwidthRangeHz": [
328                       {
329                         "minimumBandwidth": {},
330                         "maximumBandwidth": {}
331                       }
332                     ]
333                   },
334                   "lastDetectionTimestamp": "2024-01-15T09:30:00Z",
335                   "fieldsOfView": [
336                     {
337                       "fovId": 1,
338                       "mountId": "string",
339                       "projectedFrustum": {
340                         "upperLeft": {},
341                         "upperRight": {},
342                         "bottomRight": {},
343                         "bottomLeft": {}
344                       },
345                       "projectedCenterRay": {
346                         "latitudeDegrees": {},
347                         "longitudeDegrees": {},
348                         "altitudeHaeMeters": {},
349                         "altitudeAglMeters": {},
350                         "altitudeAsfMeters": {},
351                         "pressureDepthMeters": {}
352                       },
353                       "centerRayPose": {
354                         "pos": {},
355                         "attEnu": {}
356                       },
357                       "horizontalFov": 1.1,
358                       "verticalFov": 1.1,
359                       "range": 1.1,
360                       "mode": "SENSOR_MODE_INVALID"
361                     }
362                   ]
363                 }
364               ]
365             },
366             "payloads": {
367               "payloadConfigurations": [
368                 {
369                   "config": {
370                     "capabilityId": "string",
371                     "quantity": 1,
372                     "effectiveEnvironment": [
373                       "ENVIRONMENT_UNKNOWN"
374                     ],
375                     "payloadOperationalState": "PAYLOAD_OPERATIONAL_STATE_INVALID",
376                     "payloadDescription": "string"
377                   }
378                 }
379               ]
380             },
381             "powerState": {
382               "sourceIdToState": {}
383             },
384             "provenance": {
385               "integrationName": "string",
386               "dataType": "string",
387               "sourceId": "string",
388               "sourceUpdateTime": "2024-01-15T09:30:00Z",
389               "sourceDescription": "string"
390             },
391             "overrides": {
392               "override": [
393                 {
394                   "requestId": "string",
395                   "fieldPath": "string",
396                   "maskedFieldValue": {},
397                   "status": "OVERRIDE_STATUS_INVALID",
398                   "provenance": {
399                     "integrationName": "string",
400                     "dataType": "string",
401                     "sourceId": "string",
402                     "sourceUpdateTime": "2024-01-15T09:30:00Z",
403                     "sourceDescription": "string"
404                   },
405                   "type": "OVERRIDE_TYPE_INVALID",
406                   "requestTimestamp": "2024-01-15T09:30:00Z"
407                 }
408               ]
409             },
410             "indicators": {
411               "simulated": true,
412               "exercise": true,
413               "emergency": true,
414               "c2": true,
415               "egressable": true,
416               "starred": true
417             },
418             "targetPriority": {
419               "highValueTarget": {
420                 "isHighValueTarget": true,
421                 "targetPriority": 1,
422                 "targetMatches": [
423                   {
424                     "highValueTargetListId": "string",
425                     "highValueTargetDescriptionId": "string"
426                   }
427                 ],
428                 "isHighPayoffTarget": true
429               },
430               "threat": {
431                 "isThreat": true
432               }
433             },
434             "signal": {
435               "frequencyCenter": {
436                 "frequencyHz": {
437                   "value": 1.1,
438                   "sigma": 1.1
439                 }
440               },
441               "frequencyRange": {
442                 "minimumFrequencyHz": {
443                   "frequencyHz": {}
444                 },
445                 "maximumFrequencyHz": {
446                   "frequencyHz": {}
447                 }
448               },
449               "bandwidthHz": 1.1,
450               "signalToNoiseRatio": 1.1,
451               "lineOfBearing": {
452                 "angleOfArrival": {
453                   "relativePose": {},
454                   "bearingElevationCovarianceRad2": {}
455                 },
456                 "rangeEstimateM": {
457                   "value": 1.1,
458                   "sigma": 1.1
459                 },
460                 "maxRangeM": {
461                   "value": 1.1,
462                   "sigma": 1.1
463                 }
464               },
465               "fixed": {},
466               "emitterNotations": [
467                 {
468                   "emitterNotation": "string",
469                   "confidence": 1.1
470                 }
471               ],
472               "pulseWidthS": 1.1,
473               "pulseRepetitionInterval": {
474                 "pulseRepetitionIntervalS": {
475                   "value": 1.1,
476                   "sigma": 1.1
477                 }
478               },
479               "scanCharacteristics": {
480                 "scanType": "SCAN_TYPE_INVALID",
481                 "scanPeriodS": 1.1
482               }
483             },
484             "transponderCodes": {
485               "mode1": 1,
486               "mode2": 1,
487               "mode3": 1,
488               "mode4InterrogationResponse": "INTERROGATION_RESPONSE_INVALID",
489               "mode5": {
490                 "mode5InterrogationResponse": "INTERROGATION_RESPONSE_INVALID",
491                 "mode5": 1,
492                 "mode5PlatformId": 1
493               },
494               "modeS": {
495                 "id": "string",
496                 "address": 1
497               }
498             },
499             "dataClassification": {
500               "default": {
501                 "level": "CLASSIFICATION_LEVELS_INVALID",
502                 "caveats": [
503                   "string"
504                 ]
505               },
506               "fields": [
507                 {
508                   "fieldPath": "string",
509                   "classificationInformation": {
510                     "level": "CLASSIFICATION_LEVELS_INVALID",
511                     "caveats": [
512                       "string"
513                     ]
514                   }
515                 }
516               ]
517             },
518             "taskCatalog": {
519               "taskDefinitions": [
520                 {
521                   "taskSpecificationUrl": "string"
522                 }
523               ]
524             },
525             "media": {
526               "media": [
527                 {
528                   "type": "MEDIA_TYPE_INVALID",
529                   "relativePath": "string"
530                 }
531               ]
532             },
533             "relationships": {
534               "relationships": [
535                 {
536                   "relatedEntityId": "string",
537                   "relationshipId": "string",
538                   "relationshipType": {
539                     "trackedBy": {
540                       "activelyTrackingSensors": {},
541                       "lastMeasurementTimestamp": {}
542                     },
543                     "groupChild": {},
544                     "groupParent": {},
545                     "mergedFrom": {},
546                     "activeTarget": {}
547                   }
548                 }
549               ]
550             },
551             "visualDetails": {
552               "rangeRings": {
553                 "minDistanceM": 1.1,
554                 "maxDistanceM": 1.1,
555                 "ringCount": 1,
556                 "ringLineColor": {
557                   "red": {},
558                   "green": {},
559                   "blue": {},
560                   "alpha": {}
561                 }
562               }
563             },
564             "dimensions": {
565               "lengthM": 1.1
566             },
567             "routeDetails": {
568               "destinationName": "string",
569               "estimatedArrivalTime": "2024-01-15T09:30:00Z"
570             },
571             "schedules": {
572               "schedules": [
573                 {
574                   "windows": [
575                     {
576                       "cronExpression": "string",
577                       "durationMillis": "string"
578                     }
579                   ],
580                   "scheduleId": "string",
581                   "scheduleType": "SCHEDULE_TYPE_INVALID"
582                 }
583               ]
584             },
585             "health": {
586               "connectionStatus": "CONNECTION_STATUS_INVALID",
587               "healthStatus": "HEALTH_STATUS_INVALID",
588               "components": [
589                 {
590                   "id": "string",
591                   "name": "string",
592                   "health": "HEALTH_STATUS_INVALID",
593                   "messages": [
594                     {
595                       "status": "HEALTH_STATUS_INVALID",
596                       "message": "string"
597                     }
598                   ],
599                   "updateTime": "2024-01-15T09:30:00Z"
600                 }
601               ],
602               "updateTime": "2024-01-15T09:30:00Z",
603               "activeAlerts": [
604                 {
605                   "alertCode": "string",
606                   "description": "string",
607                   "level": "ALERT_LEVEL_INVALID",
608                   "activatedTime": "2024-01-15T09:30:00Z",
609                   "activeConditions": [
610                     {
611                       "conditionCode": "string",
612                       "description": "string"
613                     }
614                   ]
615                 }
616               ]
617             },
618             "groupDetails": {
619               "team": {
620                 "entityId": "string",
621                 "members": [
622                   {
623                     "entityId": "string"
624                   }
625                 ]
626               },
627               "echelon": {
628                 "armyEchelon": "ARMY_ECHELON_INVALID"
629               }
630             },
631             "supplies": {
632               "fuel": [
633                 {
634                   "fuelId": "string",
635                   "name": "string",
636                   "reportedDate": "2024-01-15T09:30:00Z",
637                   "amountGallons": 1,
638                   "maxAuthorizedCapacityGallons": 1,
639                   "operationalRequirementGallons": 1,
640                   "dataClassification": {
641                     "default": {},
642                     "fields": [
643                       {
644                         "fieldPath": {},
645                         "classificationInformation": {}
646                       }
647                     ]
648                   },
649                   "dataSource": "string"
650                 }
651               ]
652             },
653             "orbit": {
654               "orbitMeanElements": {
655                 "metadata": {
656                   "creationDate": "2024-01-15T09:30:00Z",
657                   "originator": "string",
658                   "messageId": "string",
659                   "refFrame": "ECI_REFERENCE_FRAME_INVALID",
660                   "refFrameEpoch": "2024-01-15T09:30:00Z",
661                   "meanElementTheory": "MEAN_ELEMENT_THEORY_INVALID"
662                 },
663                 "meanKeplerianElements": {
664                   "epoch": "2024-01-15T09:30:00Z",
665                   "semiMajorAxisKm": 1.1,
666                   "meanMotion": 1.1,
667                   "eccentricity": 1.1,
668                   "inclinationDeg": 1.1,
669                   "raOfAscNodeDeg": 1.1,
670                   "argOfPericenterDeg": 1.1,
671                   "meanAnomalyDeg": 1.1,
672                   "gm": 1.1
673                 },
674                 "tleParameters": {
675                   "ephemerisType": 1,
676                   "classificationType": "string",
677                   "noradCatId": 1,
678                   "elementSetNo": 1,
679                   "revAtEpoch": 1,
680                   "bstar": 1.1,
681                   "bterm": 1.1,
682                   "meanMotionDot": 1.1,
683                   "meanMotionDdot": 1.1,
684                   "agom": 1.1
685                 }
686               }
687             }
688           },
689           "snapshot": true
690         }
691       ],
692       "owner": {
693         "entityId": "string"
694       }
695     }
696   },
697   "cancelRequest": {
698     "taskId": "string",
699     "assignee": {
700       "system": {
701         "serviceName": "string",
702         "entityId": "string",
703         "managesOwnScheduling": true
704       },
705       "user": {
706         "userId": "string"
707       },
708       "team": {
709         "entityId": "string",
710         "members": [
711           {
712             "entityId": "string"
713           }
714         ]
715       },
716       "onBehalfOf": {}
717     }
718   },
719   "completeRequest": {
720     "taskId": "string"
721   }
722 }

This is a long polling API that will block until a new task is ready for delivery. If no new task is available then the server will hold on to your request for up to 5 minutes, after that 5 minute timeout period you will be expected to reinitiate a new request.

Request

This endpoint expects an object.

agentSelectorobjectOptional

Selector criteria to determine which Agent Tasks the agent receives

Response

Requests for the agent to comply with.

executeRequestobject or null

Request to execute a Task.

cancelRequestobject or null

Request to Cancel a Task.

completeRequestobject or null

Request to Complete a Task.

Request

Response

Errors