---
title: "Get a Page"
url: "https://nov18-dev.movespot.fyi/apis/portal-2/versions/891fea74-0458-4c01-8657-e3e36ffacc99/operations/get-portal-page-by-name"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/portal-2/versions/891fea74-0458-4c01-8657-e3e36ffacc99.md

# Get a Page

`GET` `/api/v3/pages/{pagePath}`

Operation ID: `get-portal-page-by-name`

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.

## Path parameters

- `pagePath` (string, required) - Targeted page, url-encoded.

## Responses

- `200` - A single portal page
- `404` - Not Found

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Portal
  version: 3.3.1
paths:
  /api/v3/pages/{pagePath}:
    get:
      operationId: get-portal-page-by-name
      summary: Get a Page
      description: 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.
      parameters:
        - $ref: "#/components/parameters/pagePath"
      responses:
        "200":
          $ref: "#/components/responses/GetPortalPageResponse"
        "404":
          $ref: "#/components/responses/NotFound"
      security:
        - portalAccessToken: []
        - {}
      tags:
        - Content
security:
  - portalAccessToken: []
  - {}
components:
  parameters:
    pagePath:
      name: pagePath
      in: path
      required: true
      description: Targeted page, url-encoded.
      example: "%2Fmypage"
      schema:
        type: string
  responses:
    GetPortalPageResponse:
      description: A single portal page
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/PortalPage"
          examples:
            PortalPageResponseExample1:
              value:
                id: 582b9327-3eba-4bfe-9438-6066840dbbca
                title: Home
                slug: /
                content: "# Welcome to the Developer Portal"
                visibility: public
                parent_page_id: null
                created_at: 2021-09-01T00:00:00Z
                updated_at: 2021-09-01T00:00:00Z
    NotFound:
      description: Not Found
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/NotFoundError"
          examples:
            NotFoundExample:
              $ref: "#/components/examples/NotFoundExample"
  schemas:
    PortalPage:
      description: A single page for the portal
      type: object
      properties:
        id:
          $ref: "#/components/schemas/PageId"
        title:
          $ref: "#/components/schemas/PageTitle"
        slug:
          $ref: "#/components/schemas/PageSlug"
        content:
          $ref: "#/components/schemas/PageContent"
        visibility:
          $ref: "#/components/schemas/Visibility"
        description:
          $ref: "#/components/schemas/Description"
        created_at:
          $ref: "#/components/schemas/CreatedAt"
        updated_at:
          $ref: "#/components/schemas/UpdatedAt"
        parent_page_id:
          $ref: "#/components/schemas/ParentPageId"
      additionalProperties: false
      required:
        - id
        - title
        - slug
        - content
        - visibility
        - created_at
        - updated_at
        - parent_page_id
      title: PortalPage
    NotFoundError:
      allOf:
        - $ref: "#/components/schemas/BaseError"
        - type: object
          properties:
            status:
              example: 404
            title:
              example: Not Found
            type:
              example: https://httpstatuses.com/404
            instance:
              example: kong:trace:1234567890
            detail:
              example: Not found
    PageId:
      description: The unique identifier of the page
      type: string
      format: uuid
      example: 582b9327-3eba-4bfe-9438-6066840dbbca
      title: PageId
    PageTitle:
      description: The title of the page
      type: string
      example: My Page
      title: PageTitle
    PageSlug:
      description: The slug of the page.
      type: string
      example: /my-page
      title: PageSlug
    PageContent:
      description: The renderable markdown content of the page
      type: string
      example: "# Welcome to the Developer Portal"
      title: PageContent
    Visibility:
      description: Whether the page or snippet is public or private. Private pages and
        snippets are only accessible to authenticated users.
      type: string
      example: public
      enum:
        - public
        - private
      title: Resource Public Visibility
    Description:
      type: string
      example: A custom page about developer portals
      title: ResourceDescription
    CreatedAt:
      description: An ISO-8601 timestamp representation of entity creation date.
      type: string
      format: date-time
      example: 2022-11-04T20:10:06.927Z
      readOnly: true
    UpdatedAt:
      description: An ISO-8601 timestamp representation of entity update date.
      type: string
      format: date-time
      example: 2022-11-04T20:10:06.927Z
      readOnly: true
    ParentPageId:
      description: |
        Pages may be rendered as a tree of files.
      type: string
      format: uuid
      nullable: true
    BaseError:
      description: standard error
      type: object
      properties:
        status:
          description: >
            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.
          type: integer
          readOnly: true
        title:
          description: |
            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.
          type: string
          readOnly: true
        type:
          description: The error type.
          type: string
          readOnly: true
        instance:
          description: |
            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.
          type: string
          readOnly: true
        detail:
          description: >
            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.
          type: string
          readOnly: true
      required:
        - status
        - title
        - instance
        - detail
      title: Error
  examples:
    NotFoundExample:
      value:
        status: 404
        title: Not Found
        instance: kong:trace:6816496025408232265
        detail: Not Found
  securitySchemes:
    portalAccessToken:
      type: apiKey
      in: cookie
      name: portalaccesstoken
      description: >
        The Developer portal cookie is meant to be used by the Developer API to
        authenticate with.
```
