// fusionrest agent · supply chain and manufacturing · product lifecycle management

Item Categories

itemCategories Based on 26C

Create, change and look up Item Categories, with translatable attributes. Actions include share category.

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

/fscmRestApi/resources/11.13.18.05/itemCategories
Operations
GET (list)GET (one)POST (create)PATCH (update)6 actions
Record key
itemCategoriesUniqID
Required on create
CatalogIdCategoryCodeCategoryName
At a glance
17 fields3 finders4 children
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 /fscmRestApi/resources/11.13.18.05/itemCategories?fields=CatalogCode,CatalogControlLevel,CatalogControlLevelValue,CatalogId,CatalogName&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "CatalogCode": "<string, max 255>",
      "CatalogControlLevel": 0,
      "CatalogControlLevelValue": "<string, max 255>",
      "CatalogId": 0,
      "CatalogName": "<string, max 30>"
    }
  ],
  "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 26C REST specification.

Fields 17

AttributeTypeUse
CatalogCodetext · max 255Optional on createUpdatableSearchable
CatalogControlLevelnumberRead-onlySearchable
CatalogControlLevelValuetext · max 255Read-only
CatalogIdnumberRequired on createSearchable
CatalogNametext · max 30Read-onlySearchable
CategoryCodetext · max 820Required on createUpdatableSearchable
CategoryIdnumberOptional on createSearchable
CategoryNametext · max 250Required on createUpdatableSearchable
CreationDateTimedate-timeRead-onlySearchable
Descriptiontext · max 240Optional on createUpdatableSearchable
EndDatedateOptional on createUpdatableSearchable
ItemsOnlyFlagyes/no · max 30 · default falseOptional on createUpdatableSearchable
LastUpdateDateTimedate-timeRead-onlySearchable
ParentCategoryCodetext · max 255Optional on createUpdatableSearchable
ParentCategoryIdnumberRead-onlySearchable
SharedFlagyes/no · max 1Read-onlySearchable
StartDatedateOptional on createUpdatableSearchable

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

Finders 3

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 4

Child resources sit under one record: /fscmRestApi/resources/11.13.18.05/itemCategories/{itemCategoriesUniqID}/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