/categorySchema: Organization Category Schema

URL:: https://[root]/portals/[portalID]/categorySchema
Methods:: GET

Example usage

The following is a sample ArcGIS Online request URL used to access the categorySchema resource:

Use dark colors for code blocksCopy
https://org.arcgis.com/sharing/rest/portals/0123456789ABCDEF/categorySchema?f=pjson

The following is a sample ArcGIS Enterprise request URL used to access the categorySchema resource:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/sharing/rest/portals/0123456789ABCDEF/categorySchema?f=pjson

Description

The categorySchema resource returns the content category schema for an organization.

Request parameters

Parameter	Details
`f`	The response format. The default format is `html`. Values: `html` \| `json` \| `pjson`

Response properties

Property Details

Property	Details
`categorySchema`	A JSON object that consists of a JSON array representing the top level categories. Each category object has `title`, `description` and `categories` properties, where `categories` consists of an array of objects with each having the same properties and represents the descendant or child categories and so on. Example Use dark colors for code blocksCopy 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 [ { "title": "Categories", "description": "Current news and trends.", "categories": [ { "title": "Trending", "description": "Trending news.", "categories": [ { "title": "New and noteworthy", "description": "This is used to categorize all new and noteworthy news.", "categories": [] }, { "title": "Current events", "description": "This is used to categorize all current events.", "categories": [] } ] }, { "title": "Basemaps", "description": "All types of maps.", "categories": [ { "title": "Reference maps", "description": "This is used to categorize all Reference maps.", "categories": [] }, { "title": "Creative maps", "description": "This is used to categorize all creative maps.", "categories": [] }, { "title": "Vector tiles", "description": "This is used to categorize all Vector tile layers.", "categories": [] }, { "title": "Component layers", "description": "This is used to categorize all component layers.", "categories": [] }, { "title": "Historical maps", "description": "This is used to categorize all historic maps.", "categories": [] } ] }, { "title": "Imagery", "description": "All types of Imagery.", "categories": [ { "title": "Basemap imagery", "description": "This is used to categorize all basemap imagery.", "categories": [] }, { "title": "Multispectral imagery", "description": "This is used to categorize all multispectral imagery.", "categories": [] }, { "title": "Temporal imagery", "description": "This is used to categorize all temporal imagery.", "categories": [] }, { "title": "Event imagery", "description": "This is used to categorize all event imagery.", "categories": [] } ] } ] } ]

categorySchema

A JSON object that consists of a JSON array representing the top level categories. Each category object has title, description and categories properties, where categories consists of an array of objects with each having the same properties and represents the descendant or child categories and so on.

Example

Use dark colors for code blocksCopy
[
  {
    "title": "Categories",
    "description": "Current news and trends.",
    "categories": [
      {
        "title": "Trending",
        "description": "Trending news.",
        "categories": [
          {
            "title": "New and noteworthy",
            "description": "This is used to categorize all new and noteworthy news.",
            "categories": []
          },
          {
            "title": "Current events",
            "description": "This is used to categorize all current events.",
            "categories": []
          }
        ]
      },
      {
        "title": "Basemaps",
        "description": "All types of maps.",
        "categories": [
          {
            "title": "Reference maps",
            "description": "This is used to categorize all Reference maps.",
            "categories": []
          },
          {
            "title": "Creative maps",
            "description": "This is used to categorize all creative maps.",
            "categories": []
          },
          {
            "title": "Vector tiles",
            "description": "This is used to categorize all Vector tile layers.",
            "categories": []
          },
          {
            "title": "Component layers",
            "description": "This is used to categorize all component layers.",
            "categories": []
          },
          {
            "title": "Historical maps",
            "description": "This is used to categorize all historic maps.",
            "categories": []
          }
        ]
      },
      {
        "title": "Imagery",
        "description": "All types of Imagery.",
        "categories": [
          {
            "title": "Basemap imagery",
            "description": "This is used to categorize all basemap imagery.",
            "categories": []
          },
          {
            "title": "Multispectral imagery",
            "description": "This is used to categorize all multispectral imagery.",
            "categories": []
          },
          {
            "title": "Temporal imagery",
            "description": "This is used to categorize all temporal imagery.",
            "categories": []
          },
          {
            "title": "Event imagery",
            "description": "This is used to categorize all event imagery.",
            "categories": []
          }
        ]
      }
    ]
  }
]

JSON Response syntax

Use dark colors for code blocksCopy
{
  "categorySchema": [
    {
      "title": "<root category title>",
      "description": "<root category description>",
      "categories": [
        {
          "title": "<parent category title>",
          "description": "<parent category description>",
          "categories": [
            {
              "title": "<child category title>",
              "description": "<child category description>",
              "categories": [
                {
                  "title": "<grandchild category title>",
                  "description": "<grandchild category description>"
                }
                ....
              ]
            }
            ....
          ]
        }
        ....
      ]
    }
    ....
  ]
}

JSON Response example

Use dark colors for code blocksCopy
{
  "categorySchema": [
    {
      "title": "Categories",
      "description": "Main description",
      "categories": [
        {
          "title": "Basemaps",
          "description": "This is used to categorize basemaps.",
          "categories": [
            {
              "title": "Partner Basemap"
            },
            {
              "title": "Esri Basemaps",
              "description": "This is used to categorize Esri Basemaps.",
              "categories": [
                {
                  "title": "Esri Redlands Basemap"
                },
                {
                  "title": "Esri Highland Basemap"
                }
              ]
            }
          ]
        },
        {
          "title": "Imagery",
          "description": "This is used to categorize different types of imagery.",
          "categories": [
            {
              "title": "Multispectral Imagery"
            },
            {
              "title": "Temporal Imagery"
            }
          ]
        }
      ]
    },
    {
      "title": "Region",
      "description": "This is used to categorize maps by region.",
      "categories": [
        {
          "title": "US"
        },
        {
          "title": "World"
        }
      ]
    }
  ]
}