PortalSnippet
objectA single snippet for the portal
The unique identifier of the page
Example:582b9327-3eba-4bfe-9438-6066840dbbca
The title of the snippet
Example:My Snippet
The name of the snippet (no leading slash)
Example:my-snippet
The renderable markdown content of the snippet
Example:# Welcome to the Developer Portal
Whether the page or snippet is public or private. Private pages and snippets are only accessible to authenticated users.
Allowed values:publicprivate
Example:public
Example:A custom page about developer portals
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
CreatedAt
stringAn ISO-8601 timestamp representation of entity creation date.
UpdatedAt
stringAn ISO-8601 timestamp representation of entity update date.
Error
objectstandard error
The HTTP status code of the error. Useful when passing the response
body to child properties in a frontend UI. Must be returned as an integer.
A short, human-readable summary of the problem. It should not
change between occurences of a problem, except for localization.
Should be provided as “Sentence case” for direct use in the UI.
The error type.
Used to return the correlation ID back to the user, in the format
kong:trace:<correlation_id>. This helps us find the relevant logs
when a customer reports an issue.
A human readable explanation specific to this occurence of the problem.
This field may contain request/entity data to help the user understand
what went wrong. Enclose variable values in square brackets. Should be
provided as “Sentence case” for direct use in the UI.
NotFoundError
The HTTP status code of the error. Useful when passing the response
body to child properties in a frontend UI. Must be returned as an integer.
Example:404
A short, human-readable summary of the problem. It should not
change between occurences of a problem, except for localization.
Should be provided as “Sentence case” for direct use in the UI.
Example:Not Found
The error type.
Example:https://httpstatuses.com/404
Used to return the correlation ID back to the user, in the format
kong:trace:<correlation_id>. This helps us find the relevant logs
when a customer reports an issue.
Example:kong:trace:1234567890
A human readable explanation specific to this occurence of the problem.
This field may contain request/entity data to help the user understand
what went wrong. Enclose variable values in square brackets. Should be
provided as “Sentence case” for direct use in the UI.
Example:Not found