Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Create Target Intel Target

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

Create Intel on Target by RID.

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

CreateTargetIntelTargetRequest
object
Hide child attributes

Hide child attributes

id
string
name
string
description
string
optional
domain
string (enum)

Enum values: SIGINT, OSINT, IMINT, ELINT, HUMINT, OTHER, ALL_SOURCE, GEOINT, OPIR, FMV, COMINT

validTime
string
location
object
optional

A circle representing the area a target is located.

Show child attributes

Show child attributes

confidence
number
optional
intelType
union
Show child attributes

Show child attributes

source
string
optional

Response body

EmptySuccessResponse
any

An empty response object indicating the request was successful.

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/createTargetIntel" \ -d '{"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","source":"Example source"}'

Error responses

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