// fusionrest agent · hcm

Person Notes

personNotes Based on latest (2026.09)

Create, change, delete and look up Person Notes. Actions include get bip report url print feedback and get view pub person note privilege.

The record key personNotesUniqID is a generated hash. Take it from the record's links (rel self) in a GET response; never build it yourself.

Oracle documents an Effective-Of header and an effectiveDate parameter for this resource, used for date-effective reads and changes.

/hcmRestApi/resources/11.13.18.05/personNotes
Operations
GET (list)GET (one)POST (create)PATCH (update)DELETE6 actions
Record key
personNotesUniqID
Required on create
WorkerId
At a glance
28 fields2 finders1 children1 file/large text fields
Extra parameters
?effectiveDate=Effective-Of:
I want to…List the latest 25Count recordsGet one recordCreate oneUpdate one

Try it

Response fields ·
Filters (q)

Only attributes Oracle marks as searchable are offered.

Finder
Include children (expand)
Paging and options
limit
Endpoint and headers
GET /hcmRestApi/resources/11.13.18.05/personNotes?fields=AuthorId,AuthorKnownAs,AuthorName,AuthorNumber,CardTitle&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "AuthorId": 0,
      "AuthorKnownAs": "<string, max 80>",
      "AuthorName": "<string, max 240>",
      "AuthorNumber": "<string, max 30>",
      "CardTitle": "<string, max 500>"
    }
  ],
  "count": 25,
  "hasMore": true,
  "limit": 25,
  "offset": 0
}

Shapes and placeholders, not real data. Replace https://<your-pod> and the login with your own: this site never sees them. Based on Oracle's latest (2026.09) REST specification.

Fields 28

AttributeTypeUse
AuthorIdnumberOptional on createSearchable
AuthorKnownAstext · max 80Read-onlySearchable
AuthorNametext · max 240Read-onlySearchable
AuthorNumbertext · max 30Optional on create
CardTitletext · max 500Optional on createUpdatableSearchable
ContextIdnumberOptional on createSearchable
ContextId2numberOptional on createSearchable
ContextTypetextOptional on createSearchable
ContextType2text · max 30Optional on createSearchable
CreatedBytext · max 64Read-onlySearchable
CreationDatedate-timeRead-onlySearchable
DeleteNonAuthorFlagyes/noOptional on createUpdatableSearchable
ForeignKeyReferenceFlagyes/noOptional on createUpdatableSearchable
HiddenFlagyes/no · max 1 · default falseOptional on createUpdatableSearchable
HideShowFlagyes/noOptional on createUpdatableSearchable
HideShowNonRecipientFlagyes/noOptional on createUpdatableSearchable
ImageReferenceURLtext · max 4000Optional on createUpdatableSearchable
LastUpdateDatedate-timeRead-onlySearchable
LastUpdatedBytext · max 64Read-onlySearchable
NoteIdnumberOptional on createSearchable
NoteTexttextOptional on createUpdatable
NoteVisibilityCodetext · max 30Optional on createUpdatableSearchable
NoteVisibilityMeaningtext · max 255Optional on createUpdatableSearchable
ThankYouFlagyes/noOptional on createUpdatableSearchable
WorkerIdnumberRequired on createSearchable
WorkerKnownAstext · max 80Read-onlySearchable
WorkerNametext · max 240Read-onlySearchable
WorkerNumbertext · max 30Optional on create

Names, types, labels and flags from Oracle's REST specification (latest (2026.09)). Flexfield and custom attributes vary by pod: check /describe for yours.

Finders 2

Predefined searches: ?finder=Name;variable=value,variable2=value2. Pick one in Try it to build the call.

Check a payload

Checked in your browser only; nothing you paste is sent anywhere. Checks names and flags, not values.

Children 1

Child resources sit under one record: /hcmRestApi/resources/11.13.18.05/personNotes/{personNotesUniqID}/child/<name>. Add them to a GET with expand.

Actions 6

Actions use Content-Type: application/vnd.oracle.adf.action+json. A path with a {key} runs on one record.

Use in AI Agent Studio

More in For Builders.

Pitfalls