Get Portal Integration Configurations

Returns the portal’s integration configurations.

get
/api/v3/integrations

Response

200 application/json

Response for portal integration configurations

Portal Integrations

Configuration data for Dev Portal integrations

Default:{}

* Additional properties are NOT allowed.
google_tag_managerobject | null

Google Tag Manager integration configuration

* Additional properties are NOT allowed.
Show Child Parameters
google_analytics_4object | null

Google Analytics integration configuration

* Additional properties are NOT allowed.
Show Child Parameters
200 application/json

Content

The API for retrieving content for a Konnect Portal.

List Pages

Returns a tree view of pages for the portal. Each page has a slug, title, and content. The full tree is returned in one response; this endpoint is not paginated. Public pages will be returned for non-authenticated users, while both private and public pages will be returned for authenticated users.

get
/api/v3/pages

Query Parameters

sortstring

Sorts a collection of portal pages. Supported sort attributes are:

  • created_at
  • updated_at
  • slug
  • title
  • visibility
filter[title][eq]string

Filter by direct equality comparison of the title property with a supplied value.

Example:Good Page

filter[title]string

Filter by direct equality comparison (short-hand) of the title property with a supplied value.

Example:Good Page

filter[title][contains]string

Filter by contains comparison of the title property with a supplied substring

Example:Good

filter[slug][eq]string

Filter by direct equality comparison of the slug property with a supplied value.

Example:good-page

filter[slug]string

Filter by direct equality comparison (short-hand) of the slug property with a supplied value.

Example:good-page

filter[slug][contains]string

Filter by contains comparison of the slug property with a supplied substring

Example:good

filter[visibility][eq]string

Filter by whether the pages returned are public or private. Private pages are only accessible to authenticated users. For authenticated users, results will include both public and private pages if not specified.

Allowed values:publicprivate

Example:public

filter[visibility]string

Filter (short-hand) by whether the pages returned are public or private. Private pages are only accessible to authenticated users. For authenticated users, results will include both public and private pages if not specified.

Allowed values:publicprivate

Example:private

Response

200 application/json

Tree of portal pages for the portal

ListPortalPages

Tree of pages for the portal (nested children). Not paginated.

* Additional properties are NOT allowed.
dataarray[object]required

A single page for the portal

* Additional properties are NOT allowed.
Show Child Parameters
200 application/json

Get a Page

Returns a single page for the portal. Each page has a slug, title, and content. Public pages will be returned for non-authenticated users, while both private and public pages will be returned for authenticated users.

get
/api/v3/pages/{pagePath}

Path Parameters

pagePathstringrequired

Targeted page, url-encoded.

Example:%2Fmypage

Response

application/json

A single portal page

PortalPage

A single page for the portal

* Additional properties are NOT allowed.
idstring(uuid)required

The unique identifier of the page

Example:582b9327-3eba-4bfe-9438-6066840dbbca

titlestringrequired

The title of the page

Example:My Page

slugstringrequired

The slug of the page.

Example:/my-page

contentstringrequired

The renderable markdown content of the page

Example:# Welcome to the Developer Portal

visibilitystringrequired

Whether the page or snippet is public or private. Private pages and snippets are only accessible to authenticated users.

Allowed values:publicprivate

Example:public

descriptionstring

Example:A custom page about developer portals

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

parent_page_idstring | null(uuid)required

Pages may be rendered as a tree of files.

application/json

List Snippets

Returns a paginated list of snippets for the portal. Each snippet has a name, title, and content. Public snippets will be returned for non-authenticated users, while both private and public snippets will be returned for authenticated users.

get
/api/v3/snippets

Query Parameters

sortstring

Sorts a collection of portal snippets. Supported sort attributes are:

  • created_at
  • updated_at
  • name
  • title
  • visibility
page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

filter[title][eq]string

Filter by direct equality comparison of the title property with a supplied value.

Example:Good Page

filter[title]string

Filter by direct equality comparison (short-hand) of the title property with a supplied value.

Example:Good Page

filter[title][contains]string

Filter by contains comparison of the title property with a supplied substring

Example:Good

filter[name][eq]string

Filter by direct equality comparison of the name property with a supplied value.

Example:good service

filter[name]string

Filter by direct equality comparison (short-hand) of the name property with a supplied value.

Example:good service

filter[visibility][eq]string

Filter by whether the pages returned are public or private. Private pages are only accessible to authenticated users. For authenticated users, results will include both public and private pages if not specified.

Allowed values:publicprivate

Example:public

filter[visibility]string

Filter (short-hand) by whether the pages returned are public or private. Private pages are only accessible to authenticated users. For authenticated users, results will include both public and private pages if not specified.

Allowed values:publicprivate

Example:private

Response

200 application/json

Paginated list of portal snippets

ListPortalSnippets

A paginated list of snippets for the portal

* Additional properties are NOT allowed.
dataarray[object]

A single snippet for the portal

* Additional properties are NOT allowed.
Show Child Parameters
metaobject

returns the pagination information

Show Child Parameters
200 application/json