Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Modify Target Intel Target

PUT/api/v2/targetWorkbench/targets/{targetRid}/modifyTargetIntel

Modify Intel on Target by RID and IntelId.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:target-write.

Path parameters

targetRid
string

The unique identifier for a Target

Request body

ModifyTargetIntelTargetRequest
object
Hide child attributes

Hide child attributes

intel
list<ModifyTargetIntelData>optional
Show child attributes

Show child attributes

Response body

ModifyTargetIntelResponse
object

The response body returned when modifying intel attached to a target.

Hide child attributes

Hide child attributes

updatedIntelIds
list<IntelId>optional
Show child attributes

Show child attributes

Examples

Request

Copied!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 curl -X PUT \ \t-H "Content-type: application/json" \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/targetWorkbench/targets/ri.gotham-artifact.0-0.target.example/modifyTargetIntel" \ -d '{ "intel": [ { "domain": "SIGINT", "confidence": 3, "name": "Example Intel Name", "description": "Intel containing location.", "intelType": { "type": "geotimeObservation", "geotimeTrack": "ri.gotham.0-0.geotime-track.aa.bb.cc.example" }, "validTime": "2023-10-04T14:48:00.000Z", "location": { "center": { "elevation": 0, "latitude": 0, "longitude": 0 }, "radius": 1.1 }, "id": "Example Intel Id" } ] }'

Response

Copied!
1 2 3 4 5 { "updatedIntelIds": [ "Example Intel Id" ] }

Error responses

Error Name
TargetNotFoundError CodeINVALID_ARGUMENT
Status Code400
DescriptionCannot find target from provided rid.
ParameterstargetRid
ModifyTargetIntelTargetPermissionDeniedError CodePERMISSION_DENIED
Status Code403
DescriptionCould not modifyTargetIntel the Target.
ParameterstargetRid