Skip to content

EditSubject

Include name when creating a subject.

PropertyTypeRequiredDescription
namestringYes, for creationRequired. The name of the subject. Nullable.
nicknamestringNoOptional. Another name/alias property for the subject Nullable.
profilePicUrlstringNoOptional. A profile picture URL for the subject. Nullable.
addressstringNoOptional. The street address of the subject. Nullable.
citystringNoOptional. The name of the city where the subject lives. Nullable.
statestringNoOptional. The name of the state name the subject lives. Nullable.
countrystringNoOptional. The name of the country where the subject lives. Nullable.
ageOrDateOfBirthstringNoOptional. The age or birth date of the subject. Nullable.
emailstringNoOptional. The email address of the subject. Note that this will not be automatically checked for validity. Nullable.
highSchoolstringNoOptional. The name of the high school the subject attended. Nullable.
collegestringNoOptional. The name of the college the subject attended. Nullable.
companystringNoOptional. The name of the company the subject works for. Nullable.
phonestringNoOptional. The phone number of the subject. Note that this will not be automatically checked for validity. Nullable.
twitterUrlstringNoOptional. The URL of the subject’s Twitter profile. Nullable.
facebookUrlstringNoOptional. The URL of the subject’s Facebook profile. Nullable.
instagramUrlstringNoOptional. The URL of the subject’s Instagram profile. Nullable.
linkedInUrlstringNoOptional. The URL of the subject’s LinkedIn profile. Nullable.
tiktokUrlstringNoOptional. The URL of the subject’s TikTok profile. Nullable.
redditUrlstringNoOptional. The URL of the subject’s Reddit profile. Nullable.
pinterestUrlstringNoOptional. The URL of the subject’s Pinterest profile. Nullable.
youtubeUrlstringNoOptional. The URL of the subject’s YouTube channel. All four channel URL forms are accepted: a handle ({/@name}), a channel id ({/channel/UC…}), and the legacy {/c/name} and {/user/name} forms. The identifier is stored with its prefix, because the forms are not interchangeable and may resolve to different channels. Nullable.
tagsarray of stringNoOptional. A set of tags to associate with the subject. Nullable.
notesstringNoOptional. Free-form notes about the subject, including context for the reviewing analyst. Notes can be read back from Subject.notes and edited in the Ferretly app. Nullable.

Use only the documented fields.