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 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.0,"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.0,"latitude":0.0,"longitude":0.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