Reports

Post Report Page Layout

post/api/v1/entities/workspaces/{workspaceId}/reportPageLayouts

Request

  • Base URL
    https://www.gooddata.ai
  • Auth
    none declared

Path parameters

workspaceIdstring required

Query parameters

includestring[]

Array of included collections or individual relationships. Includes are separated by commas (e.g. include=entity1s,entity2s). Collection include represents the inclusion of every relationship between this entity and the given collection. Relationship include represents the inclusion of the particular relationships only. If single parameter "ALL" is present, all possible includes are used (include=ALL).

WARNING: Individual include types (collection, relationship or ALL) cannot be combined together.

metaIncludestring[]

Included meta objects

Include Meta objects.

Request body

Example request

{
  "data": {
    "attributes": {
      "content": {
        "format": "widescreen",
        "kind": "content",
        "layout": {
          "children": [
            {
              "slotId": "pageTitle",
              "type": "slotRef",
              "weight": 2
            },
            {
              "children": [
                {
                  "children": [
                    {
                      "slotId": "widget1",
                      "type": "slotRef"
                    },
                    {
                      "slotId": "widget2",
                      "type": "slotRef"
                    }
                  ],
                  "direction": "row",
                  "type": "section",
                  "weight": 2
                },
                {
                  "slotId": "summary",
                  "type": "slotRef",
                  "weight": 1
                }
              ],
              "direction": "row",
              "type": "section",
              "weight": 9
            },
            {
              "children": [
                {
                  "slotId": "footerLogo",
                  "type": "slotRef",
                  "weight": 1
                },
                {
                  "slotId": "footerPageNumber",
                  "type": "slotRef",
                  "weight": 8
                }
              ],
              "direction": "row",
              "type": "section",
              "weight": 1
            }
          ],
          "direction": "column",
          "type": "section"
        },
        "slots": [
          {
            "localIdentifier": "pageTitle",
            "placeholder": {
              "hint": "Page title"
            },
            "style": {
              "type": "h1"
            },
            "type": "heading"
          },
          {
            "localIdentifier": "widget1",
            "placeholder": {
              "hint": "Add a visualization"
            },
            "showTitle": true,
            "type": "visualization"
          },
          {
            "localIdentifier": "widget2",
            "placeholder": {
              "hint": "Add a visualization"
            },
            "showTitle": true,
            "type": "visualization"
          },
          {
            "localIdentifier": "summary",
            "placeholder": {
              "hint": "Add a summary"
            },
            "style": {
              "type": "normalText"
            },
            "type": "paragraph"
          },
          {
            "altText": "Logo",
            "fit": "contain",
            "localIdentifier": "footerLogo",
            "source": {
              "type": "url",
              "url": "{logo}"
            },
            "style": {
              "horizontalAlign": "start",
              "verticalAlign": "end"
            },
            "type": "image"
          },
          {
            "localIdentifier": "footerPageNumber",
            "source": {
              "content": "{currentPageNumber} / {totalPages}",
              "type": "static"
            },
            "style": {
              "horizontalAlign": "end",
              "type": "largeText",
              "verticalAlign": "end"
            },
            "type": "paragraph"
          }
        ],
        "version": "1"
      }
    },
    "id": "id1",
    "type": "reportPageLayout"
  }
}

Response

Request successfully processed

Example response

{
  "data": {
    "attributes": {
      "content": {
        "format": "widescreen",
        "kind": "content",
        "layout": {
          "children": [
            {
              "slotId": "pageTitle",
              "type": "slotRef",
              "weight": 2
            },
            {
              "children": [
                {
                  "children": [
                    {
                      "slotId": "widget1",
                      "type": "slotRef"
                    },
                    {
                      "slotId": "widget2",
                      "type": "slotRef"
                    }
                  ],
                  "direction": "row",
                  "type": "section",
                  "weight": 2
                },
                {
                  "slotId": "summary",
                  "type": "slotRef",
                  "weight": 1
                }
              ],
              "direction": "row",
              "type": "section",
              "weight": 9
            },
            {
              "children": [
                {
                  "slotId": "footerLogo",
                  "type": "slotRef",
                  "weight": 1
                },
                {
                  "slotId": "footerPageNumber",
                  "type": "slotRef",
                  "weight": 8
                }
              ],
              "direction": "row",
              "type": "section",
              "weight": 1
            }
          ],
          "direction": "column",
          "type": "section"
        },
        "slots": [
          {
            "localIdentifier": "pageTitle",
            "placeholder": {
              "hint": "Page title"
            },
            "style": {
              "type": "h1"
            },
            "type": "heading"
          },
          {
            "localIdentifier": "widget1",
            "placeholder": {
              "hint": "Add a visualization"
            },
            "showTitle": true,
            "type": "visualization"
          },
          {
            "localIdentifier": "widget2",
            "placeholder": {
              "hint": "Add a visualization"
            },
            "showTitle": true,
            "type": "visualization"
          },
          {
            "localIdentifier": "summary",
            "placeholder": {
              "hint": "Add a summary"
            },
            "style": {
              "type": "normalText"
            },
            "type": "paragraph"
          },
          {
            "altText": "Logo",
            "fit": "contain",
            "localIdentifier": "footerLogo",
            "source": {
              "type": "url",
              "url": "{logo}"
            },
            "style": {
              "horizontalAlign": "start",
              "verticalAlign": "end"
            },
            "type": "image"
          },
          {
            "localIdentifier": "footerPageNumber",
            "source": {
              "content": "{currentPageNumber} / {totalPages}",
              "type": "static"
            },
            "style": {
              "horizontalAlign": "end",
              "type": "largeText",
              "verticalAlign": "end"
            },
            "type": "paragraph"
          }
        ],
        "version": "1"
      },
      "createdAt": "2023-07-20 12:30",
      "modifiedAt": "2023-07-20 12:30"
    },
    "id": "id1",
    "type": "reportPageLayout"
  },
  "included": [
    {
      "id": "id1",
      "type": "userIdentifier"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.