# Published

The `analytics/published` endpoint retrieves a list of content (stories, streams, pathways) published on the app. This endpoint is useful if the need to query content on the app before looking at various other analytic endpoints.

## Parameters <a href="#parameters" id="parameters"></a>

The endpoint only takes a single optional parameter which allows filtering of apps

|         |                            |
| ------- | -------------------------- |
| **Key** | **Type**                   |
| **app** | String (ID or name of app) |

## Example

The example below retrieves a list of apps with published content for each app.

```
curl -X POST \
  v1/analytics/published \
  -H 'Authorization: Basic <Your Base64 Encoded Token>'
```

## Success Response

A successful response will have an array of `app` + `content` items.

```
{
    "status": "success",
    "data": [
        {
            "app": {
                "ID": "io.falkor.demo",
                "name": "Falkor",
                "version": "2.10.0"
            },
            "content": {
                "pathways": [
                    {
                        "ID": "EV67-ZCNS-56AD",
                        "name": "Pathway A",
                        "icon": "<content url>",
                        "type": "pathway"
                    },
                    {
                        "ID": "EV44-CXGM-88TI",
                        "name": "Pathway B",
                        "icon": "<content url>",
                        "type": "pathway"
                    },
                    ...etc
                ],
                "stories": [
                    {
                        "ID": "EV72-RQZY-80AH",
                        "name": "Story A",
                        "icon": "<content url>",
                        "type": "story"
                    },
                    {
                        "ID": "EV30-NNDN-79EE",
                        "name": "Story B",
                        "icon": "<content url>",
                        "type": "survey"
                    },
                    ...etc
                ],
                "streams": [
                    {
                        "ID": "EV93-RZXC-81KB",
                        "name": "Stream A",
                        "icon": "<content url>",
                    },
                    {
                        "ID": "EV63-OXFN-39QB",
                        "name": "Stream B",
                        "icon": "<content url>",
                        "type": "podcast"
                    },
                    ...etc
                ]
            }
        }
    ],
    "hash": "24a5bbfea32e4fc3d5e84e19243fc372",
    "response_time": 0.18273687362670898
}
```

### App + Content Item

<table><thead><tr><th width="158.39130434782612"></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Type</strong></td></tr><tr><td><strong>app</strong></td><td>Object</td></tr><tr><td><strong>app.ID</strong></td><td>String (Reverse domain app identity)</td></tr><tr><td><strong>app.name</strong></td><td>String</td></tr><tr><td><strong>app.version</strong></td><td>String</td></tr><tr><td><strong>content</strong></td><td>Object</td></tr><tr><td><strong>content.pathways</strong></td><td>Array of pathway items</td></tr><tr><td><strong>content.stories</strong></td><td>Array of story items</td></tr><tr><td><strong>content.streams</strong></td><td>Array of stream items</td></tr></tbody></table>

### Pathway Item

<table><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Type</strong></td></tr><tr><td><strong>ID</strong></td><td>String (SKU / ID of pathway)</td></tr><tr><td><strong>name</strong></td><td>String</td></tr><tr><td><strong>icon</strong></td><td>String (Icon URL of pathway)</td></tr><tr><td><strong>type</strong></td><td>String (Always pathway)</td></tr></tbody></table>

### Story Item

<table><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Type</strong></td></tr><tr><td><strong>ID</strong></td><td>String (SKU / ID of story)</td></tr><tr><td><strong>name</strong></td><td>String</td></tr><tr><td><strong>icon</strong></td><td>String (Icon URL of story)</td></tr><tr><td><strong>type</strong></td><td>Enum (story, article, assessment, survey, scorm)</td></tr></tbody></table>

### Stream Item

<table><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Type</strong></td></tr><tr><td><strong>ID</strong></td><td>String (SKU / ID of stream)</td></tr><tr><td><strong>name</strong></td><td>String</td></tr><tr><td><strong>icon</strong></td><td>String (Icon URL of story)</td></tr><tr><td><strong>type</strong></td><td>Enum (podcast, youtube, audio, video)</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://everyday-digital.gitbook.io/falkor-dev-docs/analytics/published.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
