Content - Curator by InterWorks Documentation

/content/createFile

Creates a file model Example Usage: Python Script Parameters: file The file to attach, sent as a multipart upload. Required unless file_location is provided. file_location A URL the Curator server should download the file from. Required unless file is provided. slug The unique identifier to use for the file in the URL. Required. title The title/name of the file. Optional, defaults to the slug. description A short description of the file. Optional. restrict_access Whether the file should be restricted to certain groups. Optional, true or false. groups Comma-separated list of group names the file should be restricted to. Optional. hidden Hides the file from all views: search results, tiles, and explorer. Optional, 1 or 0. hidden_from_search Hides the file from search results only. Optional, 1 or 0. favoritable Whether users may favorite the file. Optional, 1 or 0. allow_browser_cache Whether browsers may cache the file. Optional, 1 or 0. download_only Forces browsers to download the file instead of opening it. Optional, 1 or 0. keywords Comma-separated list of existing keyword IDs (see /content/listKeywords) to classify the file with. Unknown IDs are ignored. Optional. Returns: array Example Response:

    {
        "result": "Success",
        "msg": "Successfully created file",
        "id": 42
    }

/content/createNavMenu

Creates a nav menu model Returns: array Example Response:

    {
        "result": "Success",
        "msg": 0
    }

/content/createPage

Creates a page containing a single full-page embed built from a URL, embed code, or a raw HTML document. The page renders inside the normal Curator navigation with its title hidden, so the embedded content takes up the whole page area. Exactly one of url, embed_code, or html must be provided. Parameters: title The title of the new page. Required. url A URL to embed in the page. embed_code Embed code (HTML) to render in the page as-is. The code is not compiled as a server-side template, but unlike the html parameter it is also not sandboxed: scripts inside it run in the page in the viewing user’s browser session, so only publish embed code from trusted sources. html A full HTML document to display. The document is stored as a hidden, download-only Curator file and rendered inside a sandboxed frame isolated from the viewer’s Curator session. Because the file is download-only, visiting its direct /file/{slug} link downloads the document rather than rendering it in the browser. slug The unique identifier to use for the page in the URL. Optional, generated from the title when omitted. An error is returned if a provided slug is already in use. add_to_nav Adds the new page to the main navigation. Optional, 1 or 0. hidden Hides the page from all views: search results, tiles, and explorer. Optional, 1 or 0. hidden_from_search Hides the page from search results only. The page stays visible in tiles and the explorer. Optional, 1 or 0. Returns: array Example Response:

    {
        "result": "Success",
        "msg": "Successfully created page",
        "id": 42,
        "slug": "sales-report",
        "url": "https://curator.example.com/page/sales-report",
        "edit_url": "https://curator.example.com/backend/interworks/content/page/update/42",
        "file_id": 17
    }

The file_id key is only present when the page was created from the html parameter. It can be passed to /content/updateFile later to replace the page’s HTML in place.

/content/deleteFile

deletes a file model by ID Returns: array Example Response:

    {
        "result": "Success",
        "msg": 0
    }

/content/listFiles

Lists file content types. Returns: array Example Response:

    [
        {
            "id": 1,
            "title": "HexTileAlt",
            "description": "",
            "slug": "hex-tile-alt",
            "restrict_group_access": 0,
            "created_at": "2017-09-12 16:11:10",
            "updated_at": "2017-09-12 16:11:10"
        },
        {
            "id": 2,
            "title": "Logo 196",
            "description": "",
            "slug": "logo-196",
            "restrict_group_access": 0,
            "created_at": "2017-12-15 17:15:07",
            "updated_at": "2017-12-15 17:15:07"
        }
    ]

/content/listDashboards

Lists Tableau dashboard content types with associated keywords. Returns: array Example Response:

    [
        {
            "id": 1,
            "title": "Sales Dashboard",
            "description": "Dashboard showing sales metrics",
            "slug": "sales-dashboard",
            "url": "https://tableau.example.com/#/views/Sales/Dashboard",
            "server": "https://tableau.example.com",
            "site": "Default",
            "restrict_group_access": 0,
            "created_at": "2023-01-15 10:30:00",
            "updated_at": "2024-01-10 14:22:00",
            "keywords": [
                {
                    "id": 2,
                    "title": "Scorecard",
                    "created_at": "2023-08-15T10:24:49.000000Z",
                    "created_by": "admin (backend)",
                    "updated_at": "2023-08-21T07:53:26.000000Z",
                    "updated_by": "admin (backend)",
                    "favoritable": 1,
                    "pivot": {
                        "dashboard_id": 1,
                        "keyword_id": 2
                    }
                },
                {
                    "id": 4,
                    "title": "Pink Cards",
                    "created_at": "2023-08-23T07:28:05.000000Z",
                    "created_by": "admin (backend)",
                    "updated_at": "2023-08-23T07:28:05.000000Z",
                    "updated_by": "admin (backend)",
                    "favoritable": 1,
                    "pivot": {
                        "dashboard_id": 1,
                        "keyword_id": 4
                    }
                }
            ]
        },
        {
            "id": 2,
            "title": "Marketing Dashboard",
            "description": "",
            "slug": "marketing-dashboard",
            "url": "https://tableau.example.com/#/views/Marketing/Overview",
            "server": "https://tableau.example.com",
            "site": "Default",
            "restrict_group_access": 0,
            "created_at": "2023-02-20 09:15:00",
            "updated_at": "2023-12-05 11:45:00"
        }
    ]

/content/listNavMenus

Lists nav menu links with associated keywords. Returns: array Example Response:

    [
        {
            "id": 1,
            "parent_id": null,
            "title": "Main Menu",
            "description": "The main menu items",
            "url": null,
            "enabled": 1,
            "parameters": null,
            "query_string": null,
            "is_external": 0,
            "link_target": "_self",
            "created_at": {
                "date": "2017-10-08 14:51:28.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "updated_at": {
                "date": "2018-03-08 19:41:42.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "link_type": "custom_url",
            "notice_id": null,
            "restrict_group_access": 0,
            "keywords": [
                {
                    "id": 2,
                    "title": "Scorecard",
                    "created_at": "2023-08-15T10:24:49.000000Z",
                    "created_by": "admin (backend)",
                    "updated_at": "2023-08-21T07:53:26.000000Z",
                    "updated_by": "admin (backend)",
                    "favoritable": 1,
                    "pivot": {
                        "menu_id": 1,
                        "keyword_id": 2
                    }
                },
                {
                    "id": 4,
                    "title": "Pink Cards",
                    "created_at": "2023-08-23T07:28:05.000000Z",
                    "created_by": "admin (backend)",
                    "updated_at": "2023-08-23T07:28:05.000000Z",
                    "updated_by": "admin (backend)",
                    "favoritable": 1,
                    "pivot": {
                        "menu_id": 1,
                        "keyword_id": 4
                    }
                }
            ]
        },
        {
            "id": 2,
            "parent_id": 1,
            "title": "Home",
            "description": "Website Home Page",
            "url": "home",
            "enabled": 1,
            "parameters": null,
            "query_string": null,
            "is_external": 0,
            "link_target": "_self",
            "created_at": {
                "date": "2017-10-08 14:51:28.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "updated_at": {
                "date": "2018-01-16 15:24:38.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "link_type": "custom_url",
            "notice_id": null,
            "restrict_group_access": 0,
            "keywords": []
        }
    ]

Every nav menu link includes a keywords array. Links with no keywords assigned return an empty array rather than omitting the field.

/content/updateFile

Updates a file model’s details and can replace its attachment in place, keeping the same file ID, slug, and links. Parameters: id The ID of the file to update. Required. file A replacement file, sent as a multipart upload. Optional. file_location A URL the Curator server should download a replacement file from. Optional. slug, title, description Updated values for the file’s details. Optional. restrict_access, groups Group restriction settings, matching /content/createFile. groups replaces the file’s current groups. Optional. hidden, hidden_from_search, favoritable, allow_browser_cache, download_only File flags, matching /content/createFile. Optional, 1 or 0. keywords Comma-separated list of existing keyword IDs (see /content/listKeywords). Replaces the file’s current keywords; pass an empty value to clear them. Optional. Returns: array Example Response:

    {
        "result": "Success",
        "msg": "Successfully updated file",
        "id": 42
    }

​/content/createFile

​/content/createNavMenu

​/content/createPage

​/content/deleteFile

​/content/listFiles

​/content/listDashboards

​/content/listNavMenus

​/content/updateFile