Sign in

v28

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-263064641.4 MB
Snippets

Get a Snippet

Returns the configuration of a single custom snippet for this portal. Custom snippets can be used to display static content, documentation, or other information to developers.

get/v3/portals/{portalId}/snippets/{snippetId}

Path parameters

portalIdstring uuid required
Example:f32d905a-ed33-46a3-a093-d8f536af9a8a

The Portal identifier

snippetIdstring uuid required
Example:ebbac5b0-ac89-45c3-9d2e-c4542c657e79

ID of the snippet.

Response

Details about a snippet in a portal.

idstring uuid required

Contains a unique identifier used for this resource.

namestring required

The unique name of a snippet in a portal.

titlestring

The display title of a snippet in a portal.

contentstring required

The renderable markdown content of a page in a portal.

visibility'public' | 'private' required

Whether the resource is publicly accessible to non-authenticated users.

status'published' | 'unpublished' required

Whether the resource is visible on a given portal. Defaults to unpublished.

descriptionstring
created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
  "name": "my-snippet",
  "title": "My Snippet",
  "content": "# Welcome to My Snippet",
  "visibility": "public",
  "status": "published",
  "description": "A custom page about developer portals",
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}