Koo Docs
View as Markdown

Published app

The publisher/console view of a published app: pointer, listing, and the live-derived URL + blockers.

Attributes

PublishedAppDto

The publisher/console view of a published app: pointer, listing, and the live-derived URL + blockers.

idstringread-only

Identifier of the published app.

accountIdstringread-only

Identifier of the owning account.

projectIdstringrequired

Identifier of the project the pointed-at service lives in.

environmentNamestringrequired

Name of the environment the pointed-at service lives in (by name, not id).

serviceNamestringrequired

Name of the exposed web service this listing points at (by name, not id).

urlChoicestringrequired

Either 'generated' (the koo URL from the service's status) or one of the service's active custom domain hostnames.

slugstringrequired

URL slug of the app under the owner's handle (/@handle/:slug).

profileobjectrequired
urlstring <uri>read-only

The live-derived public URL to visit, when resolvable (absent while degraded with no fallback).

blockers"service_missing" | "not_exposed" | "domain_missing"[]read-only

Live-derived degradations on the pointer — the honest reasons shown to the owner. Empty when healthy.

createdAtstring <date-time>read-only

When the app was published.

updatedAtstring <date-time>read-only

When the app or its listing was last updated.

The Published app object
json
{  "id": "pub_01example0000000000000000x",  "accountId": "acct_01example0000000000000000x",  "projectId": "proj_01example0000000000000000x",  "environmentName": "example",  "serviceName": "example",  "urlChoice": "example",  "slug": "my-app",  "profile": {    "displayName": "My app",    "tagline": "example",    "description": "example",    "images": [      "https://example.com"    ],    "youtubeId": "youtube_01example0000000000000000x",    "videoCover": true,    "category": "example",    "tags": [      "example"    ],    "links": {      "website": "https://example.com",      "repo": "https://example.com",      "appStore": "https://example.com",      "playStore": "https://example.com",      "steam": "https://example.com"    }  },  "url": "https://example.com",  "blockers": [    "service_missing"  ],  "createdAt": "2026-01-01T00:00:00.000Z",  "updatedAt": "2026-01-01T00:00:00.000Z"}