API
Start typing to search…

Create a category

post
https://{hostname}/api-definitions/v2/categories

Creates a category that you can use to tag endpoints. The request's apiCategoryName needs to be unique per account.

Query Params
string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params
string | null

The description of the category that you may use to tag related endpoints. If you specify null or an empty string in the request, the JSON response doesn't include this field.

integer

The unique identifier for the category.

string
required

The unique-per-account name of the category. Any empty value reflects back as an __UNCATEGORIZED__ keyword.

date-time

The ISO 8601 timestamp indicating when you created the category.

string

The identifier for the user who created the category.

string | null

The location of the navigable resource within this API, for use by API clients.

integer

The identifier used for optimistic locking. See Concurrency control for details.

date-time

The ISO 8601 timestamp indicating when you last modified the category.

string

The identifier for the user who last modified the category.

integer

The number of endpoints that share the category.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 1 month ago

Language
URL
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json
Updated about 1 month ago