---
title: "Get one Theme"
method: GET
path: "/organizations/{orgId}/environments/{envId}/portal-themes/{hrid}"
tags: ["Themes"]
---

# Get one Theme

`GET /organizations/{orgId}/environments/{envId}/portal-themes/{hrid}`

## Request

- Base URL: `https://eu.cloudgate.gravitee.io/apim/automation`
- URL: `https://eu.cloudgate.gravitee.io/apim/automation/organizations/{orgId}/environments/{envId}/portal-themes/{hrid}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - HTTP bearer

Get a Theme using HRID

## Response `200`

Theme successfully retrieved

- PortalThemeState: Base status properties common to all resources.
  - `hrid` string, required: A unique human readable id identifying this resource
  - `name` string, required: Display name of the theme
  - `definition` PortalNextThemeDefinition, required: Visual definition of a next-gen portal Theme.
    - `customCss` string: Custom CSS applied on top of the palette.
    - `font` PortalNextThemeFont: Typography settings for a next-gen portal Theme.
      - `fontFamily` string: CSS `font-family` value.
    - `color` PortalNextThemeColor: Palette for a next-gen portal Theme.
      - `primary` string: Primary color (CSS color value).
      - `secondary` string: Secondary color (CSS color value).
      - `tertiary` string: Tertiary color (CSS color value).
      - `error` string: Error color (CSS color value).
      - `background` PortalNextThemeBackground: Background palette for a next-gen portal Theme.
        - `page` string: Page background color (CSS color value).
        - `card` string: Card background color (CSS color value).
  - `logo` string: Primary logo. Inline data URI (for example `data:image/png;base64,...`), the same shape the console produces on upload.
  - `optionalLogo` string: Alternate logo for contexts where the primary one does not render well (dark background, small badge, etc.).
  - `favicon` string: Browser tab icon. Same inline data URI convention as `logo`.
  - `backgroundImage` string: Hero / landing page background image. Same inline data URI convention as `logo`.
  - `id` string: Resource UUID.
  - `environmentId` string: The environment ID.
  - `organizationId` string: The organization ID.
  - `errors` Errors: When a resource has been created regardless of errors, this field is used to persist the error message encountered during validation
    - `severe` string[]: Severe errors do not pass validation and will block creation/update/delete hence, this field should always be populated during the validation phase and is very unlikely to be persisted client side.
    - `warning` string[]: Warning errors do not block object creation/update/delete, most of the time because the value is ignored or defaulted.

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Resource not found
- `default`: Default error

## Changes

- **2026-11-03** `460368511dae`: 1 info
  - endpoint added
- **2026-10-07** `ecefec7d65f9`: 1 breaking
  - api path removed without deprecation
- **2026-10-07** `eb875d036ac9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api/changes/organizations/:orgId/environments/:envId/portal-themes/:hrid/get.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api/revisions/460368511dae?raw)