Content Category

Content can be grouped into content categories to help discoverability.

allowSequences
boolean

Can this category be used to group sequences?

allowSnippets
boolean

Can this category be used to group snippets?

allowTemplates
boolean

Can this category be used to group templates?

color
string <= 255 characters

Color of the content category to be used as a background

createdAt
string <date-time>

The date and time the content category was created.

name
string <= 255 characters

The name of the content category.

updatedAt
string <date-time>

The date and time the content category was last updated.

{
}

Content Category Relationships

(user (data (object) or links (object)))

The creator of the content category. Relationship creator cannot be used as a filter.

{
}

Content Category Resource Metadata

METADATA NAME DESCRIPTION QUERY PARAM
canWrite A boolean value indicating whether the current API user has write access to this resource. provideAuthorizationMeta
canDelete A boolean value indicating whether the current API user has delete access to this resource. provideAuthorizationMeta

⌵ Content Category Actions

Get a Collection of Content Categories

SecuritybearerAuth
Responses
200

OK

422

JSON error message

get/contentCategories
Request samples
Response samples
application/vnd.api+json
{
}

Create a New Content Category

SecuritybearerAuth
Request
Request Body schema: application/vnd.api+json
required
object
Responses
201

Created

422

JSON error message

post/contentCategories
Request samples
application/vnd.api+json
{
}
Response samples
application/vnd.api+json
{
}

Delete an Existing Content Category by ID

SecuritybearerAuth
Request
path Parameters
id
required
integer
Responses
204

Deleted

422

JSON error message

delete/contentCategories/{id}
Request samples
Response samples
application/vnd.api+json
{
}

Get a Content Category by ID

SecuritybearerAuth
Request
path Parameters
id
required
integer
Responses
200

OK

404

Not Found

get/contentCategories/{id}
Request samples
Response samples
application/vnd.api+json
{
}

Update a Content Category

SecuritybearerAuth
Request
path Parameters
id
required
integer
Request Body schema: application/vnd.api+json
required
object
Responses
200

OK

422

JSON error message

patch/contentCategories/{id}
Request samples
application/vnd.api+json
{
}
Response samples
application/vnd.api+json
{
}