# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Authentication API v1.1 Application Management API version: 1.0.0 extends: openapi/here-application-management-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 11 - target: $.paths['/apps'].get update: x-apievangelist-phrasing: intent: List the apps I can manage effect: read questions: - Which HERE platform applications do I or my groups have access to? - Can I filter my apps to the ones I have a particular action permission on? instructions: - text: List my applications. - text: List the apps I hold the {action} permission on. slots: action: query.action method: generated generated: '2026-09-26' - target: $.paths['/apps'].post update: x-apievangelist-phrasing: intent: Register a new application effect: write questions: - How do I register a new app and get a client ID for it? - Can I set redirect URIs and allowed scopes when creating an app? - What token lifetime can a new application be given? instructions: - text: Create an application named {name}. slots: name: requestBody.name - text: Register app {name} with redirect URIs {redirectUris}. slots: name: requestBody.name redirectUris: requestBody.redirectUris - text: Create app {name} whose tokens last {tokenDuration} seconds. slots: name: requestBody.name tokenDuration: requestBody.tokenDuration method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}'].get update: x-apievangelist-phrasing: intent: View an application effect: read questions: - What are the settings of a specific application? - Can I look up an app by its HRN? instructions: - text: Show me application {app}. slots: app: path.app - text: Get the configuration of app {app}. slots: app: path.app method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}'].delete update: x-apievangelist-phrasing: intent: Delete an application effect: destructive questions: - How do I delete an app I no longer need? - Can I remove an application permanently by its HRN? instructions: - text: Delete application {app}. slots: app: path.app - text: Permanently remove app {app}. slots: app: path.app method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}'].patch update: x-apievangelist-phrasing: intent: Update an application's settings effect: write questions: - How do I change the redirect URIs of an existing app? - Can I change the token duration for an app I already registered? instructions: - text: Rename existing app {app} to {name}. slots: app: path.app name: requestBody.name - text: Update the redirect URIs of app {app} to {redirectUris}. slots: app: path.app redirectUris: requestBody.redirectUris - text: Change app {app}'s token duration to {tokenDuration} seconds. slots: app: path.app tokenDuration: requestBody.tokenDuration method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}/defaultScope'].get update: x-apievangelist-phrasing: intent: View an app's default scope effect: read questions: - What default scope does an application's token get? - Is an app locked to a default project scope? instructions: - text: Show the default scope of app {app}. slots: app: path.app - text: Tell me which project app {app} is scoped to by default. slots: app: path.app method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}/defaultScope'].put update: x-apievangelist-phrasing: intent: Set an app's default scope effect: write questions: - How do I make an app's tokens default to a particular project? - Can I restrict an app so it always uses its default project scope? instructions: - text: Set the default scope of app {app} to {scope}. slots: app: path.app scope: requestBody.scope - text: Lock app {app} to default scope {scope} with alwaysProjectScope {alwaysProjectScope}. slots: app: path.app scope: requestBody.scope alwaysProjectScope: requestBody.alwaysProjectScope method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}/defaultScope'].delete update: x-apievangelist-phrasing: intent: Remove an app's default scope effect: destructive questions: - How do I clear the default project scope from an application? - Can an app go back to having no default scope? instructions: - text: Remove the default scope from app {app}. slots: app: path.app - text: Clear app {app}'s default project scope. slots: app: path.app method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}/appCreationEnabled'].get update: x-apievangelist-phrasing: intent: Check if an app may create other apps effect: read questions: - Is this application allowed to create other applications? - Can I verify the appCreationEnabled flag on an app? instructions: - text: Check whether app {app} can create other apps. slots: app: path.app - text: Tell me if app creation is enabled for {app}. slots: app: path.app method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}/appCreationEnabled'].put update: x-apievangelist-phrasing: intent: Let an app create other apps effect: write questions: - How do I allow an application to create new applications itself? - Can I turn on app creation for a service app? instructions: - text: Enable app creation for {app}. slots: app: path.app - text: Allow application {app} to create other apps. slots: app: path.app method: generated generated: '2026-09-26' - target: $.paths['/apps/{app}/appCreationEnabled'].delete update: x-apievangelist-phrasing: intent: Stop an app from creating other apps effect: destructive questions: - How do I take away an application's ability to create more apps? - Can I switch off appCreationEnabled on an app? instructions: - text: Disable app creation for {app}. slots: app: path.app - text: Stop application {app} from creating new apps. slots: app: path.app method: generated generated: '2026-09-26'