Apps

Create an app (slug is immutable after first publish)

post/v1/apps

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/apps
  • Auth: HTTP bearer

Request body

slugstring required
display_namestring required
mode'rules' | 'assisted' | 'external' required
descriptionstring

One sentence about the app, shown on its card. Optional.

Response

The created app's manifest (no versions yet).

app_idstring

Stable public id (app_ prefix).

idstring uuid
slugstring
display_namestring
versioninteger nullable
content_hashstring nullable
mode'rules' | 'assisted' | 'autonomous' | 'external'
enabledboolean
output_contractobject nullable

JSON Schema 2020-12 the decision validates against.

input_schemaobject
triggersobject nullable
thresholdsobject nullable
fallback'rules' | 'hold' | 'none' nullable
subscriptions_endpointstring nullable

Where events are delivered; null when the manifest subscribes to nothing.

source'pushed' | 'hosted'

pushed = draft + publish; hosted = fetched from manifest_url.

manifest_urlstring nullable
last_fetch_atstring date-time nullable
last_fetch_errorstring nullable

Null when the last hosted fetch succeeded; the config page offers Refresh instead of a draft editor while this is set.

allowed_originsstring[]

Origins the manifest's host vouches for, beyond the manifest's own origin (the implicit default when empty). A hosted manifest's subscriptions_endpoint and surface.url must lie inside this set.

Changes

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