# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Akuity Platform API — Organization Organization Service API version: 1.0.0 extends: openapi/akuity-organizationservice-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: 192 - target: $.paths['/api/v1/billing/plans'].get update: x-apievangelist-phrasing: intent: List available billing plans effect: read questions: - What subscription plans can I choose from on Akuity? - Which billing tiers are offered for an Akuity organization? instructions: - text: Show me all the billing plans I can subscribe to. - text: Look up billing plan {plan_id} in the plans catalog. slots: plan_id: query.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations'].get update: x-apievangelist-phrasing: intent: List the organizations I belong to effect: read questions: - Which organizations is my user account a member of? - Can I see every org I have access to with my login? instructions: - text: List all organizations my account belongs to. - text: Show the orgs I'm signed into so I can pick one. method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations'].post update: x-apievangelist-phrasing: intent: Create a new organization effect: write questions: - How do I set up a brand-new organization? - Can I create another org under my account with its own name? instructions: - text: Create a new organization named {name}. slots: name: requestBody.name - text: Set up an org called {name} for our platform team. slots: name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}'].get update: x-apievangelist-phrasing: intent: Get an organization's details effect: read questions: - What details are stored for a specific organization? - Can I look up an org by its name instead of its ID? instructions: - text: Show the details of organization {id}. slots: id: path.id - text: Fetch organization {id} using id type {idType}. slots: id: path.id idType: query.idType method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}'].put update: x-apievangelist-phrasing: intent: Update organization settings effect: write questions: - Can I rename my organization or change its MFA and AI settings? - Where do I turn on required MFA for everyone in the org? instructions: - text: Rename organization {id} to {name}. slots: id: path.id name: requestBody.name - text: Update the MFA settings on organization {id} to {mfa}. slots: id: path.id mfa: requestBody.mfa - text: Change the AI settings for organization {id} to {ai}. slots: id: path.id ai: requestBody.ai method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}'].delete update: x-apievangelist-phrasing: intent: Delete an organization effect: destructive questions: - How do I permanently delete an organization I no longer need? - Is it possible to remove a whole org and everything under it? instructions: - text: Delete organization {id}. slots: id: path.id - text: Permanently remove org {id} from Akuity. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/apikeys'].get update: x-apievangelist-phrasing: intent: List organization-level API keys effect: read questions: - Which API keys have been issued at the organization level? - Can I audit the org-wide API keys that exist today? instructions: - text: List the organization API keys for org {id}. slots: id: path.id - text: Show every org-scoped API key in organization {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/apikeys'].post update: x-apievangelist-phrasing: intent: Create an organization-level API key effect: write questions: - How do I generate an API key that works across the whole organization? - Can I set an expiry and specific permissions on a new org API key? instructions: - text: Create an org API key in organization {id} described as {description}. slots: id: path.id description: requestBody.description - text: Issue an organization API key for org {id} that expires in {expireInDuration} with permissions {permissions}. slots: id: path.id expireInDuration: requestBody.expireInDuration permissions: requestBody.permissions method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/audit-logs'].get update: x-apievangelist-phrasing: intent: View the organization's audit log effect: read questions: - Who changed what in my organization recently? - Where can I read the audit trail of actions taken in our org? instructions: - text: Show the audit log for organization {id}. slots: id: path.id - text: Pull recent audit log entries for org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/audit-logs-archives'].get update: x-apievangelist-phrasing: intent: List archived audit log bundles effect: read questions: - Are older audit logs archived somewhere I can list? - Which audit log archives are available for my organization? instructions: - text: List the audit log archives for organization {id}. slots: id: path.id - text: Show which archived audit log files exist for org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/billing'].patch update: x-apievangelist-phrasing: intent: Update billing details effect: write questions: - How do I change the billing address or contact on my org? - Can I edit the invoice details Akuity bills us with? instructions: - text: Update the billing details for organization {id} to {billingDetails}. slots: id: path.id billingDetails: requestBody.billingDetails - text: Change the billing information on org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/billing/customer'].get update: x-apievangelist-phrasing: intent: Get billing customer details effect: read questions: - What billing customer record is on file for my organization? - Can I see the customer account used for our invoices? instructions: - text: Show the billing customer details for organization {id}. slots: id: path.id - text: Fetch the customer record behind org {id}'s billing. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/billing/subscription'].patch update: x-apievangelist-phrasing: intent: Change the subscription plan or add-ons effect: write questions: - Can I upgrade my organization to a different plan? - How do I add or drop add-ons on an existing subscription? instructions: - text: Switch organization {id}'s subscription to plan {plan}. slots: id: path.id plan: requestBody.plan - text: Update the add-ons on org {id}'s subscription to {addons}. slots: id: path.id addons: requestBody.addons method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/billing/{plan}/addons'].get update: x-apievangelist-phrasing: intent: List add-ons available for a plan effect: read questions: - Which add-ons can I buy on top of a given plan? - What extras are available for the plan my org is considering? instructions: - text: List the add-ons available for plan {plan} in organization {id}. slots: plan: path.plan id: path.id - text: Show purchasable add-ons for org {id} on the {plan} plan. slots: id: path.id plan: path.plan method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/checkout'].post update: x-apievangelist-phrasing: intent: Start a billing checkout for a plan effect: write questions: - How do I pay for a plan and start a checkout for my org? - Can I check out with add-ons and a separate billing email? instructions: - text: Start a checkout for organization {id} on plan {plan}. slots: id: path.id plan: requestBody.plan - text: Check out org {id} on plan {plan} billed to {billingName} at {billingEmail}. slots: id: path.id plan: requestBody.plan billingName: requestBody.billingName billingEmail: requestBody.billingEmail method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/csv-audit-logs'].get update: x-apievangelist-phrasing: intent: Export the audit log as CSV effect: read questions: - Can I download my org's audit log as a spreadsheet? - Is there a CSV export of audit events for compliance review? instructions: - text: Export the audit log for organization {id} as CSV. slots: id: path.id - text: Download org {id}'s audit events in CSV format. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/feature-statuses'].get update: x-apievangelist-phrasing: intent: Check which features are enabled effect: read questions: - Which features are turned on for my organization? - Can I tell if a feature is enabled on our current plan? instructions: - text: Show the feature statuses for organization {id}. slots: id: path.id - text: Check which features are enabled or disabled in org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/invitees'].get update: x-apievangelist-phrasing: intent: List pending invitations effect: read questions: - Who has been invited to my org but not joined yet? - Can I see the outstanding invitations for our organization? instructions: - text: List the pending invitees for organization {id}. slots: id: path.id - text: Show everyone with an open invite to org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/join'].post update: x-apievangelist-phrasing: intent: Accept an invitation to join an organization effect: write questions: - How do I accept an invite to join an organization? - I was invited to an org — how do I become a member? instructions: - text: Join organization {id}. slots: id: path.id - text: Accept my pending invitation to org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/members'].get update: x-apievangelist-phrasing: intent: List organization members effect: read questions: - Who are the current members of my organization? - Can I list everyone who has already joined our org? instructions: - text: List the members of organization {id}. slots: id: path.id - text: Show all joined users in org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/members/invite'].post update: x-apievangelist-phrasing: intent: Invite people to the organization effect: write questions: - How do I invite teammates to my organization by email? - Can I choose a role for people when I invite them? instructions: - text: Invite {emails} to organization {id}. slots: emails: requestBody.emails id: path.id - text: Invite {emails} to org {id} with the {role} role. slots: emails: requestBody.emails id: path.id role: requestBody.role method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/members/uninvite'].post update: x-apievangelist-phrasing: intent: Revoke a pending invitation effect: destructive questions: - Can I cancel an invitation I sent to the wrong email? - How do I withdraw someone's pending invite before they join? instructions: - text: Revoke the invitation for {email} in organization {id}. slots: email: requestBody.email id: path.id - text: Uninvite {email} from org {id}. slots: email: requestBody.email id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/members/{member_id}'].put update: x-apievangelist-phrasing: intent: Change a member's organization role effect: write questions: - How do I promote an org member to admin? - Can I change the role of someone already in my organization? instructions: - text: Set member {member_id} in organization {id} to the {role} role. slots: member_id: path.member_id id: path.id role: requestBody.role - text: Change the org role of {member_id} in {id}. slots: member_id: path.member_id id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/members/{member_id}'].delete update: x-apievangelist-phrasing: intent: Remove a member from the organization effect: destructive questions: - How do I remove someone who has left the company from our org? - Can I kick a member out of my organization? instructions: - text: Remove member {member_id} from organization {id}. slots: member_id: path.member_id id: path.id - text: Take user {member_id} out of org {id}. slots: member_id: path.member_id id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/oidc-map'].get update: x-apievangelist-phrasing: intent: View the OIDC group-to-role map effect: read questions: - How are my identity provider groups mapped to organization roles? - Which OIDC claims grant which org role today? instructions: - text: Show the OIDC role mapping for organization {id}. slots: id: path.id - text: Fetch the OIDC group-to-role map for org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/oidc-map'].put update: x-apievangelist-phrasing: intent: Update the OIDC group-to-role map effect: write questions: - Can I map an SSO group to the admin role in my org? - How do I change which OIDC groups get which organization role? instructions: - text: Replace the OIDC role mapping for organization {id} with {entries}. slots: id: path.id entries: requestBody.entries - text: Update org {id}'s OIDC group-to-role entries. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/permissions'].get update: x-apievangelist-phrasing: intent: Get my permissions in an organization effect: read questions: - What am I allowed to do in this organization? - Which actions do my permissions cover in a given org? instructions: - text: Show my permissions in organization {id}. slots: id: path.id - text: List what actions I'm permitted to take in org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/reject'].post update: x-apievangelist-phrasing: intent: Decline an invitation to an organization effect: write questions: - Can I turn down an invite to join an organization? - How do I decline an org invitation I don't want? instructions: - text: Decline the invitation to organization {id}. slots: id: path.id - text: Reject my pending invite from org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/role'].get update: x-apievangelist-phrasing: intent: Get my role in an organization effect: read questions: - What role do I have in this organization — owner, admin or member? - Am I an admin in the org I'm currently using? instructions: - text: Show my role in organization {id}. slots: id: path.id - text: Tell me whether I'm an owner, admin or member of org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/sso/configuration'].get update: x-apievangelist-phrasing: intent: View the SSO configuration effect: read questions: - How is single sign-on currently configured for my organization? - Is SSO enforced for our org, and which identity provider is used? instructions: - text: Show the SSO configuration for organization {id}. slots: id: path.id - text: Fetch org {id}'s single sign-on settings. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/sso/configuration'].put update: x-apievangelist-phrasing: intent: Set up or update SSO effect: write questions: - How do I connect Okta, Azure AD, Google Workspace or SAML for SSO? - Can I enforce SSO and automatically add members who sign in? instructions: - text: Configure Okta SSO for organization {id} using {okta}. slots: id: path.id okta: requestBody.okta - text: Set up SAML single sign-on on org {id} with {saml}. slots: id: path.id saml: requestBody.saml - text: Turn SSO enforcement to {enforceSso} for organization {id}. slots: enforceSso: requestBody.enforceSso id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/sso/configuration'].delete update: x-apievangelist-phrasing: intent: Remove the SSO configuration effect: destructive questions: - Can I disconnect single sign-on from my organization? - How do I delete an SSO setup that is misconfigured? instructions: - text: Delete the SSO configuration for organization {id}. slots: id: path.id - text: Remove single sign-on from org {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/workspaces/{workspace_id}/apikeys'].get update: x-apievangelist-phrasing: intent: List a workspace's API keys effect: read questions: - Which API keys are scoped to a particular workspace? - Can I audit the keys created inside one workspace? instructions: - text: List API keys for workspace {workspace_id} in organization {id}. slots: workspace_id: path.workspace_id id: path.id - text: Show the workspace-scoped keys in {workspace_id}. slots: workspace_id: path.workspace_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{id}/workspaces/{workspace_id}/apikeys'].post update: x-apievangelist-phrasing: intent: Create a workspace-scoped API key effect: write questions: - How do I create an API key limited to a single workspace? - Can a workspace API key have an expiry and restricted permissions? instructions: - text: Create an API key for workspace {workspace_id} in organization {id}. slots: workspace_id: path.workspace_id id: path.id - text: Issue a workspace key in {workspace_id} of org {id} expiring in {expireInDuration} with permissions {permissions}. slots: workspace_id: path.workspace_id id: path.id expireInDuration: requestBody.expireInDuration permissions: requestBody.permissions method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/billing/subscription/cancel'].post update: x-apievangelist-phrasing: intent: Cancel the organization's subscription effect: destructive questions: - How do I cancel our paid Akuity subscription? - Can I stop billing for my organization entirely? instructions: - text: Cancel the subscription for organization {organization_id}. slots: organization_id: path.organization_id - text: End paid billing on org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/custom-roles'].get update: x-apievangelist-phrasing: intent: List organization custom roles effect: read questions: - What custom roles have been defined at the organization level? - Can I page through our org's custom roles? instructions: - text: List the custom roles in organization {organization_id}. slots: organization_id: path.organization_id - text: Show {limit} org custom roles in {organization_id} starting at offset {offset}. slots: limit: query.limit organization_id: path.organization_id offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/custom-roles'].post update: x-apievangelist-phrasing: intent: Create an organization custom role effect: write questions: - How do I define a custom role with its own policy for the whole org? - Can I create a least-privilege role for our organization? instructions: - text: Create an org custom role named {name} in {organization_id} with policy {policy}. slots: name: requestBody.name organization_id: path.organization_id policy: requestBody.policy - text: Add organization-wide role {name} described as {description} to {organization_id}. slots: name: requestBody.name description: requestBody.description organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/custom-roles/{id}'].get update: x-apievangelist-phrasing: intent: Get an organization custom role effect: read questions: - What policy does a specific org-level custom role grant? - Can I inspect one of our organization's custom roles? instructions: - text: Show org custom role {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Fetch the policy of organization role {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/custom-roles/{id}'].delete update: x-apievangelist-phrasing: intent: Delete an organization custom role effect: destructive questions: - How do I remove an org-level custom role we no longer use? - Can I delete a custom role from the organization? instructions: - text: Delete org custom role {id} from organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Remove organization role {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/custom-roles/{id}'].patch update: x-apievangelist-phrasing: intent: Update an organization custom role effect: write questions: - Can I change the policy on an existing org custom role? - How do I rename an organization-level custom role? instructions: - text: Update org custom role {id} in {organization_id} to policy {policy}. slots: id: path.id organization_id: path.organization_id policy: requestBody.policy - text: Rename organization role {id} to {name}. slots: id: path.id name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/domains'].get update: x-apievangelist-phrasing: intent: List verified organization domains effect: read questions: - Which email domains are verified for my organization? - What domains has our org claimed? instructions: - text: List the domains for organization {organization_id}. slots: organization_id: path.organization_id - text: Show org {organization_id}'s verified domains. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/domains'].post update: x-apievangelist-phrasing: intent: Verify domains for the organization effect: write questions: - How do I verify that our company domain belongs to my org? - Can I claim several email domains for the organization at once? instructions: - text: Verify domains {domains} for organization {organization_id}. slots: domains: requestBody.domains organization_id: path.organization_id - text: Claim {domains} as org {organization_id}'s domains. slots: domains: requestBody.domains organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/domains/{domain}'].delete update: x-apievangelist-phrasing: intent: Remove a domain from the organization effect: destructive questions: - Can I remove a domain we no longer own from our org? - How do I unclaim an organization domain? instructions: - text: Remove domain {domain} from organization {organization_id}. slots: domain: path.domain organization_id: path.organization_id - text: Delete the {domain} domain from org {organization_id}. slots: domain: path.domain organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/teams-oidc-map'].get update: x-apievangelist-phrasing: intent: View the OIDC group-to-team map effect: read questions: - Which identity provider groups are mapped to which teams? - How are OIDC claims assigning people to teams in my org? instructions: - text: Show the team OIDC mapping for organization {organization_id}. slots: organization_id: path.organization_id - text: Fetch the OIDC group-to-team map for org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/teams-oidc-map'].put update: x-apievangelist-phrasing: intent: Update the OIDC group-to-team map effect: write questions: - Can I automatically put SSO group members into a team? - How do I change which OIDC groups map to which teams? instructions: - text: Replace the team OIDC mapping for organization {organization_id} with {entries}. slots: organization_id: path.organization_id entries: requestBody.entries - text: Update org {organization_id}'s OIDC group-to-team entries. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/users-mfa-status'].get update: x-apievangelist-phrasing: intent: List members' MFA status effect: read questions: - Which users in my org haven't set up multi-factor authentication? - Can I see MFA enrollment for everyone in the organization? instructions: - text: List MFA status for all users in organization {organization_id}. slots: organization_id: path.organization_id - text: Show who has MFA enabled in org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/users/{email}/mfa/reset'].post update: x-apievangelist-phrasing: intent: Reset a user's MFA effect: write questions: - A teammate lost their authenticator — can I reset their MFA? - How do I force a user to re-enroll in multi-factor auth? instructions: - text: Reset MFA for {email} in organization {organization_id}. slots: email: path.email organization_id: path.organization_id - text: Request an MFA reset for user {email}. slots: email: path.email method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/custom-roles'].get update: x-apievangelist-phrasing: intent: List a workspace's custom roles effect: read questions: - Which custom roles exist inside a specific workspace? - Can I list roles defined only for one workspace? instructions: - text: List custom roles in workspace {workspace_id} of organization {organization_id}. slots: workspace_id: path.workspace_id organization_id: path.organization_id - text: Show {limit} workspace roles in {workspace_id}. slots: limit: query.limit workspace_id: path.workspace_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/custom-roles'].post update: x-apievangelist-phrasing: intent: Create a workspace custom role effect: write questions: - How do I create a custom role that only applies within one workspace? - Can I give a workspace its own role policy? instructions: - text: Create workspace role {name} in {workspace_id} with policy {policy}. slots: name: requestBody.name workspace_id: path.workspace_id policy: requestBody.policy - text: Add a custom role named {name} to workspace {workspace_id} in org {organization_id}. slots: name: requestBody.name workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/custom-roles/{id}'].get update: x-apievangelist-phrasing: intent: Get a workspace custom role effect: read questions: - What does a particular workspace-level role allow? - Can I read the policy of one custom role in a workspace? instructions: - text: Show custom role {id} in workspace {workspace_id}. slots: id: path.id workspace_id: path.workspace_id - text: Fetch workspace role {id} from {workspace_id} in org {organization_id}. slots: id: path.id workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/custom-roles/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a workspace custom role effect: destructive questions: - How do I delete a custom role from a workspace? - Can I remove an unused role scoped to one workspace? instructions: - text: Delete custom role {id} from workspace {workspace_id}. slots: id: path.id workspace_id: path.workspace_id - text: Remove workspace role {id} in {workspace_id} of org {organization_id}. slots: id: path.id workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/custom-roles/{id}'].patch update: x-apievangelist-phrasing: intent: Update a workspace custom role effect: write questions: - Can I change the policy of a role inside a workspace? - How do I rename a workspace-scoped custom role? instructions: - text: Update workspace role {id} in {workspace_id} to policy {policy}. slots: id: path.id workspace_id: path.workspace_id policy: requestBody.policy - text: Rename custom role {id} in workspace {workspace_id} of org {organization_id} to {name}. slots: id: path.id workspace_id: path.workspace_id organization_id: path.organization_id name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations'].get update: x-apievangelist-phrasing: intent: List AI assistant conversations effect: read questions: - Which AI assistant conversations are open for my Argo CD instance? - Can I filter AI conversations to only incidents for one application? - Is there a way to find assistant chats from a time range with a title keyword? instructions: - text: List AI conversations in organization {organization_id}. slots: organization_id: path.organization_id - text: Show only incident conversations with status {incidentStatus} for application {application}. slots: incidentStatus: query.incidentStatus application: query.application - text: Find AI conversations whose title contains {titleContains} between {startTime} and {endTime}. slots: titleContains: query.titleContains startTime: query.startTime endTime: query.endTime method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations'].post update: x-apievangelist-phrasing: intent: Start an AI assistant conversation effect: write questions: - How do I open a new conversation with the Akuity AI assistant? - Can I start an AI chat tied to an incident or a Kargo promotion analysis? instructions: - text: Start a new AI conversation in organization {organization_id} for instance {instanceId}. slots: organization_id: path.organization_id instanceId: requestBody.instanceId - text: Open an AI conversation about incident {incident} with context {contexts}. slots: incident: requestBody.incident contexts: requestBody.contexts method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{conversation_id}/conversation-feedback'].patch update: x-apievangelist-phrasing: intent: Rate an AI conversation overall effect: write questions: - Can I leave feedback on a whole AI assistant conversation? - Where do I tell Akuity an assistant session was helpful or not? instructions: - text: Submit feedback {feedback} on AI conversation {conversation_id}. slots: feedback: requestBody.feedback conversation_id: path.conversation_id - text: Rate conversation {conversation_id} in org {organization_id} as a whole. slots: conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{conversation_id}/feedback'].patch update: x-apievangelist-phrasing: intent: Mark an AI reply as useful or not effect: write questions: - Can I thumbs-up or thumbs-down a single assistant reply? - How do I flag one AI message as not useful? instructions: - text: 'Mark message {messageId} in conversation {conversation_id} as useful: {isUseful}.' slots: messageId: requestBody.messageId conversation_id: path.conversation_id isUseful: requestBody.isUseful - text: Flag AI reply {messageId} in org {organization_id} as unhelpful. slots: messageId: requestBody.messageId organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{conversation_id}/messages'].post update: x-apievangelist-phrasing: intent: Send a message to the AI assistant effect: write questions: - How do I ask the AI assistant a follow-up in an existing conversation? - Can I attach runbooks when I message the assistant? instructions: - text: Send {content} to AI conversation {conversation_id} in org {organization_id}. slots: content: requestBody.content conversation_id: path.conversation_id organization_id: path.organization_id - text: Ask the assistant {content} in conversation {conversation_id} using runbooks {runbooks}. slots: content: requestBody.content conversation_id: path.conversation_id runbooks: requestBody.runbooks method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{conversation_id}/suggestions'].post update: x-apievangelist-phrasing: intent: Get suggested follow-up prompts effect: read questions: - What follow-up questions does the assistant suggest for this chat? - Can I get prompt suggestions for an ongoing AI conversation? instructions: - text: Get suggested prompts for AI conversation {conversation_id}. slots: conversation_id: path.conversation_id - text: Show next-step suggestions for conversation {conversation_id} in org {organization_id}. slots: conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{conversation_id}/tools/{tool_call_id}/approval-status'].put update: x-apievangelist-phrasing: intent: Approve or deny an AI tool call effect: write questions: - The assistant wants to run a tool — how do I approve it? - Can I reject an action the AI proposed before it executes? instructions: - text: Set tool call {tool_call_id} in conversation {conversation_id} to {status}. slots: tool_call_id: path.tool_call_id conversation_id: path.conversation_id status: requestBody.status - text: Approve the assistant's tool call {tool_call_id} in {conversation_id} for org {organization_id}. slots: tool_call_id: path.tool_call_id conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{id}'].get update: x-apievangelist-phrasing: intent: Get an AI conversation effect: read questions: - Can I pull up the full history of one AI assistant conversation? - What did the assistant say in a specific past chat? instructions: - text: Show AI conversation {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Open conversation {id} for instance {instanceId}. slots: id: path.id instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{id}'].put update: x-apievangelist-phrasing: intent: Update an AI conversation effect: write questions: - Can I rename an AI conversation or make it public? - How do I change the context attached to an assistant chat? instructions: - text: Rename AI conversation {id} to {title}. slots: id: path.id title: requestBody.title - text: 'Set conversation {id} in org {organization_id} public: {public}.' slots: id: path.id organization_id: path.organization_id public: requestBody.public method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{id}'].delete update: x-apievangelist-phrasing: intent: Delete an AI conversation effect: destructive questions: - How do I delete an AI assistant chat I no longer need? - Can I permanently remove a conversation from the assistant history? instructions: - text: Delete AI conversation {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Remove assistant chat {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{id}/share'].post update: x-apievangelist-phrasing: intent: Share an AI conversation to Slack effect: write questions: - Can I post an AI assistant conversation into a team chat channel? - How do I share an incident chat with my team? instructions: - text: Share AI conversation {id} to channel {slackChannelName}. slots: id: path.id slackChannelName: requestBody.slackChannelName - text: Share conversation {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{id}/suspend'].post update: x-apievangelist-phrasing: intent: Suspend an AI conversation effect: write questions: - Can I pause an AI assistant conversation that is still running? - How do I stop the assistant from continuing to work on a chat? instructions: - text: Suspend AI conversation {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Pause the assistant on conversation {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/conversations/{id}/unshare'].post update: x-apievangelist-phrasing: intent: Stop sharing an AI conversation effect: destructive questions: - How do I revoke sharing on an AI conversation? - Can I make a shared assistant chat private again? instructions: - text: Unshare AI conversation {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Stop sharing conversation {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/incidents'].post update: x-apievangelist-phrasing: intent: Open an AI incident effect: write questions: - How do I open a new incident for the AI assistant to investigate? - Can I create an incident record in my organization? instructions: - text: Create an incident in organization {organization_id}. slots: organization_id: path.organization_id - text: Open a new AI incident for org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/incidents/resolve'].post update: x-apievangelist-phrasing: intent: Resolve AI incidents in bulk effect: write questions: - Can I mark several incidents as resolved at once? - How do I close every incident for one application or namespace? instructions: - text: Resolve incidents {incidentIds} in organization {organization_id}. slots: incidentIds: requestBody.incidentIds organization_id: path.organization_id - text: Mark all incidents for application {application} in namespace {namespace} as resolved. slots: application: requestBody.application namespace: requestBody.namespace method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/models'].get update: x-apievangelist-phrasing: intent: List the AI models in use effect: read questions: - Which AI models can the assistant use for my instance? - What LLMs are configured for my organization's AI features? instructions: - text: List AI models for organization {organization_id}. slots: organization_id: path.organization_id - text: Show the assistant models available to instance {instanceId}. slots: instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/provider-models/{provider}'].get update: x-apievangelist-phrasing: intent: List models offered by an AI provider effect: read questions: - Which models does a given LLM provider expose when I bring my own key? - Can I check a custom API base for its model list? instructions: - text: List models from provider {provider} for organization {organization_id}. slots: provider: path.provider organization_id: path.organization_id - text: Fetch {provider} models at {apiBase} using key {apiKey}. slots: provider: path.provider apiBase: query.apiBase apiKey: query.apiKey method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/ai/tools'].get update: x-apievangelist-phrasing: intent: List tools the AI assistant can call effect: read questions: - What tools is the AI assistant allowed to call? - Which actions can the assistant take on my clusters? instructions: - text: List the AI assistant tools for organization {organization_id}. slots: organization_id: path.organization_id - text: Show every tool the assistant can invoke in org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/instances/quota'].get update: x-apievangelist-phrasing: intent: View Argo CD instance quota effect: read questions: - How many Argo CD instances is my organization allowed? - What is our current Argo CD instance quota? instructions: - text: Show the Argo CD instance quota for organization {organization_id}. slots: organization_id: path.organization_id - text: Check org {organization_id}'s Argo CD instance limits. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/instances/quota'].put update: x-apievangelist-phrasing: intent: Change Argo CD instance quota effect: write questions: - Can I raise the number of Argo CD instances allowed in my org? - How do I set a cap on Argo CD instances? instructions: - text: Set the Argo CD instance quota for organization {organization_id} to {instanceQuota}. slots: organization_id: path.organization_id instanceQuota: requestBody.instanceQuota - text: Update org {organization_id}'s Argo CD instance limit. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/applications'].get update: x-apievangelist-phrasing: intent: List Argo CD applications across clusters effect: read questions: - Which Argo CD applications are deployed across my clusters? - Can I search Argo CD apps and group them by cluster? instructions: - text: List Argo CD applications for instance {instanceId}. slots: instanceId: query.instanceId - text: Search Argo CD apps matching {search} on clusters {clusterIds}. slots: search: query.search clusterIds: query.clusterIds - text: List apps on clusters matching label selector {clusterLabelSelector} in org {organization_id}. slots: clusterLabelSelector: query.clusterLabelSelector organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/clusters'].get update: x-apievangelist-phrasing: intent: List clusters with Kubernetes visibility effect: read questions: - Which clusters have Kubernetes dashboard visibility turned on? - Can I find clusters that are still using deprecated Kubernetes APIs? instructions: - text: List KubeVision-enabled clusters in org {organization_id} for instance {instanceId}. slots: organization_id: path.organization_id instanceId: query.instanceId - text: 'Show only clusters with deprecated APIs: {hasDeprecatedApis}.' slots: hasDeprecatedApis: query.hasDeprecatedApis method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/containers'].get update: x-apievangelist-phrasing: intent: List containers running in clusters effect: read questions: - Which containers are running a particular image tag? - Can I list containers in one namespace filtered by status? instructions: - text: List containers in namespace {namespace} across clusters {clusterIds} in org {organization_id}. slots: namespace: query.namespace clusterIds: query.clusterIds organization_id: path.organization_id - text: Find containers running image {image} with tag {imageTag}. slots: image: query.image imageTag: query.imageTag - text: Show containers in pod {podName} with status {status}. slots: podName: query.podName status: query.status method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/containers/{container_id}'].get update: x-apievangelist-phrasing: intent: Get a container's details effect: read questions: - What image, status and resources does one specific container have? - Can I inspect a single container by its ID? instructions: - text: Show container {container_id} on cluster {clusterId}. slots: container_id: path.container_id clusterId: query.clusterId - text: Get details for container {container_id} in org {organization_id}. slots: container_id: path.container_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/deprecated-apis'].get update: x-apievangelist-phrasing: intent: Find deprecated Kubernetes APIs in use effect: read questions: - Which of my workloads use Kubernetes APIs that are being removed? - Can I filter deprecated API usage by severity before an upgrade? instructions: - text: List deprecated Kubernetes APIs in use on clusters {clusterIds} in org {organization_id}. slots: clusterIds: query.clusterIds organization_id: path.organization_id - text: Show deprecated API usage of kind {kind} with severity {severity}. slots: kind: query.kind severity: query.severity method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/images'].get update: x-apievangelist-phrasing: intent: List container images in clusters effect: read questions: - Which container images are running in my clusters? - Can I find every place an image with a given digest is deployed? instructions: - text: List container images on clusters {clusterIds}. slots: clusterIds: query.clusterIds - text: Find images whose name contains {nameContains}. slots: nameContains: query.nameContains - text: Look up images with digest {digest} in org {organization_id}. slots: digest: query.digest organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/images/detail'].get update: x-apievangelist-phrasing: intent: Get details about a container image effect: read questions: - Where is a specific container image used and what versions exist? - Can I drill into one image on a particular cluster? instructions: - text: Show details for image {imageId} on cluster {clusterId}. slots: imageId: query.imageId clusterId: query.clusterId - text: Get image detail {imageId} in org {organization_id}. slots: imageId: query.imageId organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/instances/{instance_id}/clusters/{cluster_id}/detail'].get update: x-apievangelist-phrasing: intent: Get a cluster's details effect: read questions: - What is the Kubernetes version and node footprint of a given cluster? - Can I see a detail view of one managed cluster? instructions: - text: Show details for cluster {cluster_id} on instance {instance_id}. slots: cluster_id: path.cluster_id instance_id: path.instance_id - text: Get cluster {cluster_id} detail in org {organization_id} for instance {instance_id}. slots: cluster_id: path.cluster_id organization_id: path.organization_id instance_id: path.instance_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/instances/{instance_id}/clusters/{cluster_id}/resources/{resource_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Kubernetes resource effect: destructive questions: - Can I delete a stuck Kubernetes resource straight from Akuity? - How do I remove a single resource from a managed cluster? instructions: - text: Delete resource {resource_id} on cluster {cluster_id} of instance {instance_id}. slots: resource_id: path.resource_id cluster_id: path.cluster_id instance_id: path.instance_id - text: Remove Kubernetes resource {resource_id} from cluster {cluster_id} in org {organization_id} ({instance_id}). slots: resource_id: path.resource_id cluster_id: path.cluster_id organization_id: path.organization_id instance_id: path.instance_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/namespaces'].get update: x-apievangelist-phrasing: intent: List namespace names in clusters effect: read questions: - Which namespaces exist on my clusters? - Can I list the namespaces that have pods on a given node? instructions: - text: List namespace names in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Show namespaces with workloads on node {nodeName}. slots: nodeName: query.nodeName method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/namespaces-details'].get update: x-apievangelist-phrasing: intent: List namespaces with resource usage details effect: read questions: - How much CPU and memory is each namespace using? - Can I get namespace details grouped by cluster? instructions: - text: List namespace details with usage in org {organization_id} for clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Show detailed namespace stats grouped by {groupBy} for instance {instanceId}. slots: groupBy: query.groupBy instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/namespaces-details/{namespace_id}'].get update: x-apievangelist-phrasing: intent: Get one namespace's details effect: read questions: - What is running inside one particular namespace and what does it use? - Can I inspect a single namespace on a given cluster? instructions: - text: Show details for namespace {namespace_id} on cluster {clusterId}. slots: namespace_id: path.namespace_id clusterId: query.clusterId - text: Get namespace {namespace_id} in org {organization_id}. slots: namespace_id: path.namespace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/nodes'].get update: x-apievangelist-phrasing: intent: List cluster nodes effect: read questions: - Which nodes make up my clusters and how loaded are they? - Can I list nodes grouped by cluster or instance type? instructions: - text: List nodes in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Show nodes grouped by {groupBy} for instance {instanceId}. slots: groupBy: query.groupBy instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/nodes/{node_id}'].get update: x-apievangelist-phrasing: intent: Get a node's details effect: read questions: - What pods and capacity does one specific node have? - Can I inspect a single Kubernetes node? instructions: - text: Show node {node_id} on cluster {clusterId}. slots: node_id: path.node_id clusterId: query.clusterId - text: Get details for node {node_id} in org {organization_id}. slots: node_id: path.node_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/pods'].get update: x-apievangelist-phrasing: intent: List pods across clusters effect: read questions: - Which pods are running across my clusters? - Can I list pods grouped by namespace or node? instructions: - text: List pods in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Show pods grouped by {groupBy} for instance {instanceId}. slots: groupBy: query.groupBy instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/pods/{pod_id}'].get update: x-apievangelist-phrasing: intent: Get a pod's details effect: read questions: - What containers and status does one specific pod have? - Can I look at a single pod by ID? instructions: - text: Show pod {pod_id} on cluster {clusterId}. slots: pod_id: path.pod_id clusterId: query.clusterId - text: Get details for pod {pod_id} in org {organization_id}. slots: pod_id: path.pod_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resource-types'].get update: x-apievangelist-phrasing: intent: List Kubernetes resource kinds effect: read questions: - Which Kubernetes resource kinds are present, including CRDs? - What resource types can I browse for an instance? instructions: - text: List Kubernetes resource types for instance {instanceId}. slots: instanceId: query.instanceId - text: Show all resource kinds known in org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources'].get update: x-apievangelist-phrasing: intent: List and filter Kubernetes resources effect: read questions: - Can I list every Deployment in a namespace across clusters? - Which resources are unhealthy or stuck being deleted? - Is there a way to filter resources by labels or annotations? instructions: - text: List resources of kind {kind} in namespaces {namespaces} for org {organization_id}. slots: kind: query.kind namespaces: query.namespaces organization_id: path.organization_id - text: Show resources with health status {healthStatuses} on clusters {clusterIds}. slots: healthStatuses: query.healthStatuses clusterIds: query.clusterIds - text: Find resources labeled {labels} whose name contains {nameContains}. slots: labels: query.labels nameContains: query.nameContains method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/assistant-suggestion'].post update: x-apievangelist-phrasing: intent: Ask the AI assistant about a resource effect: read questions: - Can the AI assistant explain why a specific resource is failing? - How do I get troubleshooting suggestions for one Kubernetes object? instructions: - text: Ask the assistant {question} about resource {resource_id} in org {organization_id}. slots: question: requestBody.question resource_id: path.resource_id organization_id: path.organization_id - text: Get AI suggestions for resource {resource_id} in application {applicationName}. slots: resource_id: path.resource_id applicationName: requestBody.applicationName method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/audit-logs'].get update: x-apievangelist-phrasing: intent: View audit history for a resource effect: read questions: - Who changed or deleted a particular Kubernetes resource? - Can I filter a resource's audit trail by actor or action? instructions: - text: Show audit logs for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: List actions by {actorId} of type {action} on resource {resource_id}. slots: actorId: query.actorId action: query.action resource_id: path.resource_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/detail'].get update: x-apievangelist-phrasing: intent: Get a resource's details effect: read questions: - What is the status and ownership of one specific Kubernetes resource? - Can I see a detail view of a single resource? instructions: - text: Show details for resource {resource_id} on cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId - text: Get resource {resource_id} detail in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/diff'].get update: x-apievangelist-phrasing: intent: Diff a resource's live vs desired state effect: read questions: - How does a live resource differ from what Git says it should be? - Can I see drift on one Kubernetes resource? instructions: - text: Show the diff for resource {resource_id} on cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId - text: Compare live and desired state of resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/events'].get update: x-apievangelist-phrasing: intent: Get events for a resource effect: read questions: - What Kubernetes events have fired for one resource? - Why is my pod crash-looping — can I see its recent events? instructions: - text: Show Kubernetes events for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: List recent events on resource {resource_id} in cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/manifest'].get update: x-apievangelist-phrasing: intent: Get a resource's YAML manifest effect: read questions: - Can I view the live YAML manifest of one resource? - What does the full spec of a particular Kubernetes object look like? instructions: - text: Show the manifest for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: Fetch the YAML of resource {resource_id} on cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/resources/{resource_id}/resolve-assistant-conversation'].post update: x-apievangelist-phrasing: intent: Mark a resource troubleshooting chat resolved effect: write questions: - Can I mark the assistant's troubleshooting of a resource as resolved? - How do I close out an AI thread about a broken resource? instructions: - text: 'Mark the assistant conversation for resource {resource_id} resolved: {resolved}.' slots: resource_id: path.resource_id resolved: requestBody.resolved - text: Close the resource troubleshooting chat for {resource_id} on cluster {clusterId} in org {organization_id}. slots: resource_id: path.resource_id clusterId: requestBody.clusterId organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/spotlight-search'].get update: x-apievangelist-phrasing: intent: Quick-search Kubernetes resources effect: read questions: - Can I type a name and jump straight to any matching Kubernetes resource? - Is there an AI-assisted search across my cluster resources? instructions: - text: Spotlight search for {query} in organization {organization_id}. slots: query: query.query organization_id: path.organization_id - text: Run an AI-assisted resource search for {query} with aiSearch {aiSearch}. slots: query: query.query aiSearch: query.aiSearch method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/summary'].get update: x-apievangelist-phrasing: intent: Get a Kubernetes overview summary effect: read questions: - What's the high-level health summary of all my clusters? - Can I get a dashboard overview for one instance? instructions: - text: Show the Kubernetes summary for organization {organization_id}. slots: organization_id: path.organization_id - text: Get the cluster overview for instance {instanceId}. slots: instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/timeline-events'].get update: x-apievangelist-phrasing: intent: List timeline events for resources effect: read questions: - What happened to my application's resources over time? - Can I see a timeline of changes for selected resources? instructions: - text: List timeline events for applications {applicationNames} in org {organization_id}. slots: applicationNames: query.applicationNames organization_id: path.organization_id - text: Show timeline events for resources {timelineResourceIds} in namespaces {namespaces}. slots: timelineResourceIds: query.timelineResourceIds namespaces: query.namespaces method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/timeline-resources'].get update: x-apievangelist-phrasing: intent: List resources on the timeline effect: read questions: - Which resources can I put on the change timeline view? - Can I list timeline resources of one kind in a namespace? instructions: - text: List timeline resources of kind {kind} in namespaces {namespaces}. slots: kind: query.kind namespaces: query.namespaces - text: Show resources available for the timeline in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/k8s/usage'].get update: x-apievangelist-phrasing: intent: Get KubeVision usage effect: read questions: - How much KubeVision usage has my organization consumed? - Can I check our Kubernetes visibility usage numbers? instructions: - text: Show KubeVision usage for organization {organization_id}. slots: organization_id: path.organization_id - text: Get Kubernetes dashboard usage for org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/kargo-instances/quota'].get update: x-apievangelist-phrasing: intent: View Kargo instance quota effect: read questions: - How many Kargo instances can my organization run? - What is our current Kargo instance quota? instructions: - text: Show the Kargo instance quota for organization {organization_id}. slots: organization_id: path.organization_id - text: Check org {organization_id}'s Kargo instance limits. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/kargo-instances/quota'].put update: x-apievangelist-phrasing: intent: Change Kargo instance quota effect: write questions: - Can I raise the number of Kargo instances allowed? - How do I cap Kargo instances for my organization? instructions: - text: Set the Kargo instance quota for organization {organization_id} to {instanceQuota}. slots: organization_id: path.organization_id instanceQuota: requestBody.instanceQuota - text: Update org {organization_id}'s Kargo instance limit. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs'].get update: x-apievangelist-phrasing: intent: List notification configurations effect: read questions: - Which notification channels are configured for my org? - Can I list only webhook or only email notification configs? instructions: - text: List notification configs in organization {organization_id}. slots: organization_id: path.organization_id - text: Show notification configs using delivery methods {deliveryMethods}. slots: deliveryMethods: query.deliveryMethods method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs'].post update: x-apievangelist-phrasing: intent: Create a notification configuration effect: write questions: - How do I send Akuity notifications to a webhook? - Can I set up email notifications for my organization? instructions: - text: Create a webhook notification named {name} using {webhook} in org {organization_id}. slots: name: requestBody.name webhook: requestBody.webhook organization_id: path.organization_id - text: Add an email notification config {name} sending to {email}. slots: name: requestBody.name email: requestBody.email method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{config_id}/delivery-history/{id}'].get update: x-apievangelist-phrasing: intent: Get one notification delivery attempt effect: read questions: - What exactly happened on one specific notification delivery? - Can I see the request and response of a single webhook delivery? instructions: - text: Show delivery {id} of notification config {config_id}. slots: id: path.id config_id: path.config_id - text: Get delivery history entry {id} for config {config_id} in org {organization_id}. slots: id: path.id config_id: path.config_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{config_id}/notifications/{id}/redeliver'].post update: x-apievangelist-phrasing: intent: Redeliver a notification effect: write questions: - A webhook delivery failed — can I resend it? - How do I retry a specific notification? instructions: - text: Redeliver notification {id} for config {config_id}. slots: id: path.id config_id: path.config_id - text: Resend notification {id} through config {config_id} in org {organization_id}. slots: id: path.id config_id: path.config_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{id}'].get update: x-apievangelist-phrasing: intent: Get a notification configuration effect: read questions: - What settings does one notification config have? - Where is a given notification config sending to? instructions: - text: Show notification config {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Get the details of notification config {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{id}'].put update: x-apievangelist-phrasing: intent: Update a notification configuration effect: write questions: - Can I change the webhook URL on an existing notification config? - How do I rename a notification config or change its email? instructions: - text: Update notification config {id} to use webhook {webhook}. slots: id: path.id webhook: requestBody.webhook - text: Rename notification config {id} to {name} in org {organization_id}. slots: id: path.id name: requestBody.name organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a notification configuration effect: destructive questions: - How do I stop and remove a notification config? - Can I delete a webhook notification we no longer use? instructions: - text: Delete notification config {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Remove notification config {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{id}/delivery-history'].get update: x-apievangelist-phrasing: intent: List a config's delivery history effect: read questions: - Have my webhook notifications been delivered successfully? - Can I page through past deliveries for one notification config? instructions: - text: List delivery history for notification config {id}. slots: id: path.id - text: Show the last {limit} deliveries of config {id} in org {organization_id}. slots: limit: query.limit id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/notification-configs/{id}/ping'].post update: x-apievangelist-phrasing: intent: Send a test ping to a notification config effect: write questions: - Can I test a webhook notification before relying on it? - How do I send a ping to check a notification endpoint works? instructions: - text: Ping notification config {id}. slots: id: path.id - text: Send a test event to notification config {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams'].get update: x-apievangelist-phrasing: intent: List teams effect: read questions: - What teams exist in my organization? - Can I page through our org's teams? instructions: - text: List teams in organization {organization_id}. slots: organization_id: path.organization_id - text: Show {limit} teams in org {organization_id} from offset {offset}. slots: limit: query.limit organization_id: path.organization_id offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams'].post update: x-apievangelist-phrasing: intent: Create a team effect: write questions: - How do I create a team and give it custom roles? - Can I group users into a new team in my org? instructions: - text: Create team {name} in organization {organization_id}. slots: name: requestBody.name organization_id: path.organization_id - text: Create team {name} with custom roles {customRoles}. slots: name: requestBody.name customRoles: requestBody.customRoles method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{name}'].get update: x-apievangelist-phrasing: intent: Get a team effect: read questions: - What roles and description does a specific team have? - Can I look up one team by name? instructions: - text: Show team {name} in organization {organization_id}. slots: name: path.name organization_id: path.organization_id - text: Get the details of team {name}. slots: name: path.name method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{name}'].put update: x-apievangelist-phrasing: intent: Update a team effect: write questions: - Can I change which custom roles a team has? - How do I edit a team's description? instructions: - text: Update team {name} to have custom roles {customRoles}. slots: name: path.name customRoles: requestBody.customRoles - text: Change the description of team {name} in org {organization_id} to {description}. slots: name: path.name organization_id: path.organization_id description: requestBody.description method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{name}'].delete update: x-apievangelist-phrasing: intent: Delete a team effect: destructive questions: - How do I delete a team that is no longer needed? - Can I remove a team from my organization? instructions: - text: Delete team {name} from organization {organization_id}. slots: name: path.name organization_id: path.organization_id - text: Remove the {name} team. slots: name: path.name method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{team_name}/members'].get update: x-apievangelist-phrasing: intent: List a team's members effect: read questions: - Who belongs to a particular team? - Can I page through the members of one team? instructions: - text: List members of team {team_name}. slots: team_name: path.team_name - text: Show {limit} members of team {team_name} in org {organization_id}. slots: limit: query.limit team_name: path.team_name organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{team_name}/members'].post update: x-apievangelist-phrasing: intent: Add a user to a team effect: write questions: - How do I add someone to a team? - Can I put an existing org user into a team? instructions: - text: Add user {userId} to team {team_name}. slots: userId: requestBody.userId team_name: path.team_name - text: Put {userId} on team {team_name} in org {organization_id}. slots: userId: requestBody.userId team_name: path.team_name organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{team_name}/members/{id}'].get update: x-apievangelist-phrasing: intent: Get a team member effect: read questions: - Is a specific user a member of this team? - Can I look up one member's record within a team? instructions: - text: Show member {id} of team {team_name}. slots: id: path.id team_name: path.team_name - text: Check team {team_name} membership for {id} in org {organization_id}. slots: team_name: path.team_name id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/teams/{team_name}/members/{id}'].delete update: x-apievangelist-phrasing: intent: Remove a user from a team effect: destructive questions: - How do I take someone off a team? - Can I remove a member from one team without removing them from the org? instructions: - text: Remove member {id} from team {team_name}. slots: id: path.id team_name: path.team_name - text: Take {id} off team {team_name} in org {organization_id}. slots: id: path.id team_name: path.team_name organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces'].get update: x-apievangelist-phrasing: intent: List workspaces effect: read questions: - What workspaces exist in my organization? - Can I page through our workspaces? instructions: - text: List workspaces in organization {organization_id}. slots: organization_id: path.organization_id - text: Show {limit} workspaces in org {organization_id} from offset {offset}. slots: limit: query.limit organization_id: path.organization_id offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces'].post update: x-apievangelist-phrasing: intent: Create a workspace effect: write questions: - How do I create a new workspace to separate teams' instances? - Can I add a workspace with a description? instructions: - text: Create workspace {name} in organization {organization_id}. slots: name: requestBody.name organization_id: path.organization_id - text: Create a workspace named {name} described as {description}. slots: name: requestBody.name description: requestBody.description method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{id}'].get update: x-apievangelist-phrasing: intent: Get a workspace effect: read questions: - What are the details of a specific workspace? - Can I look up one workspace by ID? instructions: - text: Show workspace {id} in organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Get the details of workspace {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{id}'].put update: x-apievangelist-phrasing: intent: Update a workspace effect: write questions: - Can I rename a workspace? - How do I change a workspace's description? instructions: - text: Rename workspace {id} to {name}. slots: id: path.id name: requestBody.name - text: Update the description of workspace {id} in org {organization_id} to {description}. slots: id: path.id organization_id: path.organization_id description: requestBody.description method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a workspace effect: destructive questions: - How do I delete a workspace? - Can I remove a workspace we no longer use? instructions: - text: Delete workspace {id} from organization {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Remove workspace {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/member'].post update: x-apievangelist-phrasing: intent: Add a member to a workspace effect: write questions: - How do I add a single user or team to a workspace? - Can I give one more person access to a workspace? instructions: - text: Add member {memberRef} to workspace {workspace_id}. slots: memberRef: requestBody.memberRef workspace_id: path.workspace_id - text: Grant {memberRef} access to workspace {workspace_id} in org {organization_id}. slots: memberRef: requestBody.memberRef workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/members'].get update: x-apievangelist-phrasing: intent: List a workspace's members effect: read questions: - Who has access to a particular workspace? - Can I page through the members of one workspace? instructions: - text: List members of workspace {workspace_id}. slots: workspace_id: path.workspace_id - text: Show {limit} members of workspace {workspace_id} in org {organization_id}. slots: limit: query.limit workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/members'].put update: x-apievangelist-phrasing: intent: Replace a workspace's member list effect: write questions: - Can I set the full list of workspace members in one call? - How do I bulk-update who belongs to a workspace? instructions: - text: Set workspace {workspace_id}'s members to {memberRefs}. slots: workspace_id: path.workspace_id memberRefs: requestBody.memberRefs - text: Replace all members of workspace {workspace_id} in org {organization_id}. slots: workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/members/{id}'].get update: x-apievangelist-phrasing: intent: Get a workspace member effect: read questions: - What role does a specific person have in a workspace? - Can I look up one member of a workspace? instructions: - text: Show member {id} of workspace {workspace_id}. slots: id: path.id workspace_id: path.workspace_id - text: Get workspace {workspace_id} membership for {id} in org {organization_id}. slots: workspace_id: path.workspace_id id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/members/{id}'].put update: x-apievangelist-phrasing: intent: Change a member's workspace role effect: write questions: - How do I make someone an admin of a workspace? - Can I change one member's role inside a workspace? instructions: - text: Set workspace member {id} in {workspace_id} to role {role}. slots: id: path.id workspace_id: path.workspace_id role: requestBody.role - text: Promote {id} to a different role inside workspace {workspace_id} of org {organization_id}. slots: id: path.id workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/members/{id}'].delete update: x-apievangelist-phrasing: intent: Remove a member from a workspace effect: destructive questions: - How do I revoke someone's access to a workspace? - Can I remove a member from one workspace only? instructions: - text: Remove member {id} from workspace {workspace_id}. slots: id: path.id workspace_id: path.workspace_id - text: Revoke {id}'s access to workspace {workspace_id} in org {organization_id}. slots: id: path.id workspace_id: path.workspace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/ai/conversations/{id}/messages'].get update: x-apievangelist-phrasing: intent: Stream an AI conversation's messages effect: read questions: - Can I stream the assistant's reply as it is generated? - How do I follow new messages in an AI conversation live? instructions: - text: Stream messages for AI conversation {id}. slots: id: path.id - text: Follow live replies in conversation {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/k8s/containers-csv'].get update: x-apievangelist-phrasing: intent: Export containers to CSV effect: read questions: - Can I download the container inventory as a CSV? - Is there a spreadsheet export of containers filtered by image? instructions: - text: Export containers in org {organization_id} on clusters {clusterIds} to CSV. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Download a CSV of containers running image {image} in namespace {namespace}. slots: image: query.image namespace: query.namespace method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/k8s/deprecated-apis-csv'].get update: x-apievangelist-phrasing: intent: Export deprecated API usage to CSV effect: read questions: - Can I get a CSV report of deprecated Kubernetes APIs for upgrade planning? - Is there a spreadsheet of deprecated API usage by severity? instructions: - text: Export deprecated API usage in org {organization_id} on clusters {clusterIds} to CSV. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Download a CSV of deprecated APIs with severity {severity}. slots: severity: query.severity method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/k8s/images-csv'].get update: x-apievangelist-phrasing: intent: Export container images to CSV effect: read questions: - Can I download my cluster image inventory as a CSV? - Is there a spreadsheet export of images by name? instructions: - text: Export container images in org {organization_id} on clusters {clusterIds} to CSV. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Download a CSV of images whose name contains {nameContains}. slots: nameContains: query.nameContains method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/k8s/resources-csv'].get update: x-apievangelist-phrasing: intent: Export Kubernetes resources to CSV effect: read questions: - Can I export a filtered list of Kubernetes resources to a spreadsheet? - Is there a CSV of every resource of a given kind? instructions: - text: Export resources of kind {kind} in org {organization_id} to CSV. slots: kind: query.kind organization_id: path.organization_id - text: Download a CSV of resources in namespaces {namespaces} on clusters {clusterIds}. slots: namespaces: query.namespaces clusterIds: query.clusterIds method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/k8s/resources/{resource_id}/logs'].get update: x-apievangelist-phrasing: intent: Stream container logs for a resource effect: read questions: - How do I tail the logs of a pod from Akuity? - Can I see the previous container's logs after a crash? instructions: - text: Stream logs for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: Show the last {tailLines} log lines of resource {resource_id} filtered by {filter}. slots: tailLines: query.tailLines resource_id: path.resource_id filter: query.filter - text: Get logs from the last {sinceSeconds} seconds for resource {resource_id} on cluster {clusterId}. slots: sinceSeconds: query.sinceSeconds resource_id: path.resource_id clusterId: query.clusterId method: generated generated: '2026-09-26' - target: $.paths['/api/v1/stream/orgs/{organization_id}/k8s/usage-csv'].get update: x-apievangelist-phrasing: intent: Export KubeVision usage to CSV effect: read questions: - Can I download KubeVision usage as a CSV? - Is there a spreadsheet export of our Kubernetes visibility usage? instructions: - text: Export KubeVision usage for organization {organization_id} to CSV. slots: organization_id: path.organization_id - text: Download org {organization_id}'s KubeVision usage report. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations'].get update: x-apievangelist-phrasing: intent: List AI conversations via the Argo CD extension effect: read questions: - From inside the Argo CD UI extension, which AI conversations can I list? - Can the Argo CD KubeVision extension filter assistant chats to incidents only? instructions: - text: Through the Argo CD extension, list AI conversations for org {organization_id}. slots: organization_id: path.organization_id - text: Via the Argo CD extension, show incident chats for namespace {namespace} with only incidents {incidentOnly}. slots: namespace: query.namespace incidentOnly: query.incidentOnly method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations'].post update: x-apievangelist-phrasing: intent: Start an AI conversation via the Argo CD extension effect: write questions: - Can I open an AI assistant chat from the Argo CD extension? - How does the Argo CD KubeVision extension start a new assistant conversation? instructions: - text: Through the Argo CD extension, start an AI conversation in org {organization_id}. slots: organization_id: path.organization_id - text: Using the Argo CD extension endpoint, open an assistant chat on instance {instanceId} with context {contexts}. slots: instanceId: requestBody.instanceId contexts: requestBody.contexts method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{conversation_id}/conversation-feedback'].patch update: x-apievangelist-phrasing: intent: Rate an AI conversation via the Argo CD extension effect: write questions: - Can users rate a whole assistant conversation from the Argo CD extension? - Where does the Argo CD KubeVision extension send overall chat feedback? instructions: - text: Through the Argo CD extension, record feedback {feedback} on conversation {conversation_id}. slots: feedback: requestBody.feedback conversation_id: path.conversation_id - text: Via the Argo CD extension, rate chat {conversation_id} in org {organization_id}. slots: conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{conversation_id}/feedback'].patch update: x-apievangelist-phrasing: intent: Rate one AI reply via the Argo CD extension effect: write questions: - Can I mark a single assistant reply useful from within the Argo CD extension? - How does the Argo CD extension flag one AI message as unhelpful? instructions: - text: 'Through the Argo CD extension, mark message {messageId} in {conversation_id} useful: {isUseful}.' slots: messageId: requestBody.messageId conversation_id: path.conversation_id isUseful: requestBody.isUseful - text: Via the Argo CD extension, flag reply {messageId} of chat {conversation_id} in org {organization_id} as not useful. slots: messageId: requestBody.messageId conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{conversation_id}/messages'].post update: x-apievangelist-phrasing: intent: Message the AI assistant via the Argo CD extension effect: write questions: - Can I send the assistant a message from the Argo CD UI extension? - How does the Argo CD extension post a follow-up into an AI chat? instructions: - text: Through the Argo CD extension, send {content} to conversation {conversation_id} in org {organization_id}. slots: content: requestBody.content conversation_id: path.conversation_id organization_id: path.organization_id - text: Via the Argo CD extension, ask {content} in chat {conversation_id} with runbooks {runbooks}. slots: content: requestBody.content conversation_id: path.conversation_id runbooks: requestBody.runbooks method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{conversation_id}/suggestions'].post update: x-apievangelist-phrasing: intent: Get prompt suggestions via the Argo CD extension effect: read questions: - Does the Argo CD extension offer suggested follow-up prompts for a chat? - Can I fetch assistant prompt suggestions through the Argo CD KubeVision extension? instructions: - text: Through the Argo CD extension, get suggested prompts for conversation {conversation_id}. slots: conversation_id: path.conversation_id - text: Via the Argo CD extension, list next-step suggestions for chat {conversation_id} in org {organization_id}. slots: conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{conversation_id}/tools/{tool_call_id}/approval-status'].put update: x-apievangelist-phrasing: intent: Approve an AI tool call via the Argo CD extension effect: write questions: - Can I approve the assistant's proposed tool call from within Argo CD? - How does the Argo CD extension deny an AI action before it runs? instructions: - text: Through the Argo CD extension, set tool call {tool_call_id} in {conversation_id} to {status}. slots: tool_call_id: path.tool_call_id conversation_id: path.conversation_id status: requestBody.status - text: Via the Argo CD extension, approve tool call {tool_call_id} for chat {conversation_id} in org {organization_id}. slots: tool_call_id: path.tool_call_id conversation_id: path.conversation_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{id}'].get update: x-apievangelist-phrasing: intent: Get an AI conversation via the Argo CD extension effect: read questions: - Can I open one assistant conversation from the Argo CD extension? - How does the Argo CD KubeVision extension load a past AI chat? instructions: - text: Through the Argo CD extension, show AI conversation {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Via the Argo CD extension, load chat {id} for instance {instanceId}. slots: id: path.id instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{id}'].put update: x-apievangelist-phrasing: intent: Update an AI conversation via the Argo CD extension effect: write questions: - Can I rename an assistant chat from inside the Argo CD extension? - How does the Argo CD extension make an AI conversation public? instructions: - text: Through the Argo CD extension, rename conversation {id} in org {organization_id} to {title}. slots: id: path.id organization_id: path.organization_id title: requestBody.title - text: 'Via the Argo CD extension, set chat {id} public: {public}.' slots: id: path.id public: requestBody.public method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{id}'].delete update: x-apievangelist-phrasing: intent: Delete an AI conversation via the Argo CD extension effect: destructive questions: - Can I delete an assistant chat from within the Argo CD extension? - How does the Argo CD KubeVision extension remove an AI conversation? instructions: - text: Through the Argo CD extension, delete AI conversation {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Via the Argo CD extension, remove chat {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{id}/share'].post update: x-apievangelist-phrasing: intent: Share an AI conversation via the Argo CD extension effect: write questions: - Can I share an assistant chat to a team channel from the Argo CD extension? - How does the Argo CD extension post an AI conversation to a channel? instructions: - text: Through the Argo CD extension, share conversation {id} to channel {slackChannelName}. slots: id: path.id slackChannelName: requestBody.slackChannelName - text: Via the Argo CD extension, share chat {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{id}/suspend'].post update: x-apievangelist-phrasing: intent: Suspend an AI conversation via the Argo CD extension effect: write questions: - Can I pause a running assistant chat from the Argo CD extension? - How does the Argo CD extension suspend an AI conversation? instructions: - text: Through the Argo CD extension, suspend conversation {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Via the Argo CD extension, pause chat {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/conversations/{id}/unshare'].post update: x-apievangelist-phrasing: intent: Unshare an AI conversation via the Argo CD extension effect: destructive questions: - Can I stop sharing an assistant chat from the Argo CD extension? - How does the Argo CD extension make a shared AI conversation private? instructions: - text: Through the Argo CD extension, unshare conversation {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id - text: Via the Argo CD extension, revoke sharing on chat {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/incidents/resolve'].post update: x-apievangelist-phrasing: intent: Resolve incidents via the Argo CD extension effect: write questions: - Can I bulk-resolve incidents from inside the Argo CD extension? - How does the Argo CD KubeVision extension close incidents for one app? instructions: - text: Through the Argo CD extension, resolve incidents {incidentIds} in org {organization_id}. slots: incidentIds: requestBody.incidentIds organization_id: path.organization_id - text: Via the Argo CD extension, resolve every incident for application {application} with applyToAll {applyToAll}. slots: application: requestBody.application applyToAll: requestBody.applyToAll method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/models'].get update: x-apievangelist-phrasing: intent: List AI models via the Argo CD extension effect: read questions: - Which assistant models does the Argo CD extension see for my instance? - Can the Argo CD KubeVision extension list configured LLMs? instructions: - text: Through the Argo CD extension, list AI models for org {organization_id}. slots: organization_id: path.organization_id - text: Via the Argo CD extension, show models for instance {instanceId}. slots: instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/provider-models/{provider}'].get update: x-apievangelist-phrasing: intent: List a provider's models via the Argo CD extension effect: read questions: - Can the Argo CD extension list the models a given LLM provider offers? - How does the Argo CD extension check a custom API base for models? instructions: - text: Through the Argo CD extension, list models from provider {provider} in org {organization_id}. slots: provider: path.provider organization_id: path.organization_id - text: Via the Argo CD extension, fetch {provider} models at {apiBase}. slots: provider: path.provider apiBase: query.apiBase method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/ai/tools'].get update: x-apievangelist-phrasing: intent: List AI assistant tools via the Argo CD extension effect: read questions: - Which tools can the assistant call when used from the Argo CD extension? - Can I list the AI tool catalog through the Argo CD KubeVision extension? instructions: - text: Through the Argo CD extension, list AI tools for org {organization_id}. slots: organization_id: path.organization_id - text: Via the Argo CD extension, show the assistant's callable tools in {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/applications'].get update: x-apievangelist-phrasing: intent: List Argo CD apps via the Argo CD extension effect: read questions: - Can the Argo CD KubeVision extension list applications across clusters? - How does the extension search Argo CD apps from inside the UI? instructions: - text: Through the Argo CD extension, list applications in org {organization_id} for instance {instanceId}. slots: organization_id: path.organization_id instanceId: query.instanceId - text: Via the Argo CD extension, search apps for {search} grouped by {groupBy}. slots: search: query.search groupBy: query.groupBy method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/clusters'].get update: x-apievangelist-phrasing: intent: List visible clusters via the Argo CD extension effect: read questions: - Which KubeVision-enabled clusters does the Argo CD extension show? - Can the Argo CD extension filter clusters with deprecated APIs? instructions: - text: Through the Argo CD extension, list enabled clusters in org {organization_id} for instance {instanceId}. slots: organization_id: path.organization_id instanceId: query.instanceId - text: Via the Argo CD extension, show clusters where hasDeprecatedApis is {hasDeprecatedApis}. slots: hasDeprecatedApis: query.hasDeprecatedApis method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/containers'].get update: x-apievangelist-phrasing: intent: List containers via the Argo CD extension effect: read questions: - Can I browse running containers from the Argo CD KubeVision extension? - How does the Argo CD extension filter containers by image tag? instructions: - text: Through the Argo CD extension, list containers in namespace {namespace} of org {organization_id}. slots: namespace: query.namespace organization_id: path.organization_id - text: Via the Argo CD extension, find containers with image {image} and tag {imageTag}. slots: image: query.image imageTag: query.imageTag method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/containers/{container_id}'].get update: x-apievangelist-phrasing: intent: Get a container via the Argo CD extension effect: read questions: - Can I inspect one container from inside the Argo CD extension? - How does the Argo CD KubeVision extension load a container's detail? instructions: - text: Through the Argo CD extension, show container {container_id} on cluster {clusterId}. slots: container_id: path.container_id clusterId: query.clusterId - text: Via the Argo CD extension, get container {container_id} in org {organization_id}. slots: container_id: path.container_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/deprecated-apis'].get update: x-apievangelist-phrasing: intent: Find deprecated APIs via the Argo CD extension effect: read questions: - Can the Argo CD extension show which workloads use deprecated Kubernetes APIs? - How do I filter deprecated API findings by severity inside Argo CD? instructions: - text: Through the Argo CD extension, list deprecated APIs in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, show deprecated APIs of kind {kind} at severity {severity}. slots: kind: query.kind severity: query.severity method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/images'].get update: x-apievangelist-phrasing: intent: List images via the Argo CD extension effect: read questions: - Can I see the container image inventory from the Argo CD extension? - How does the Argo CD extension look up images by digest? instructions: - text: Through the Argo CD extension, list images in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, find images with digest {digest}. slots: digest: query.digest method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/images/detail'].get update: x-apievangelist-phrasing: intent: Get image detail via the Argo CD extension effect: read questions: - Can the Argo CD extension drill into one container image? - How does the Argo CD KubeVision extension show where an image runs? instructions: - text: Through the Argo CD extension, show image {imageId} on cluster {clusterId}. slots: imageId: query.imageId clusterId: query.clusterId - text: Via the Argo CD extension, get image {imageId} detail in org {organization_id}. slots: imageId: query.imageId organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/instances/{instance_id}/clusters/{cluster_id}/detail'].get update: x-apievangelist-phrasing: intent: Get cluster detail via the Argo CD extension effect: read questions: - Can I view one cluster's detail page from the Argo CD extension? - How does the Argo CD KubeVision extension describe a managed cluster? instructions: - text: Through the Argo CD extension, show cluster {cluster_id} on instance {instance_id}. slots: cluster_id: path.cluster_id instance_id: path.instance_id - text: Via the Argo CD extension, get cluster {cluster_id} of instance {instance_id} in org {organization_id}. slots: cluster_id: path.cluster_id instance_id: path.instance_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/instances/{instance_id}/clusters/{cluster_id}/resources/{resource_id}'].delete update: x-apievangelist-phrasing: intent: Delete a resource via the Argo CD extension effect: destructive questions: - Can I delete a Kubernetes resource from inside the Argo CD extension? - How does the Argo CD KubeVision extension remove a stuck object? instructions: - text: Through the Argo CD extension, delete resource {resource_id} on cluster {cluster_id} of instance {instance_id}. slots: resource_id: path.resource_id cluster_id: path.cluster_id instance_id: path.instance_id - text: Via the Argo CD extension, remove {resource_id} from cluster {cluster_id} ({instance_id}) in org {organization_id}. slots: resource_id: path.resource_id cluster_id: path.cluster_id instance_id: path.instance_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/namespaces'].get update: x-apievangelist-phrasing: intent: List namespaces via the Argo CD extension effect: read questions: - Which namespaces does the Argo CD extension list for my clusters? - Can the Argo CD extension show namespaces on one node? instructions: - text: Through the Argo CD extension, list namespaces in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, show namespaces on node {nodeName}. slots: nodeName: query.nodeName method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/namespaces-details'].get update: x-apievangelist-phrasing: intent: List namespace usage via the Argo CD extension effect: read questions: - Can the Argo CD extension show resource usage per namespace? - How does the Argo CD KubeVision extension group namespace details? instructions: - text: Through the Argo CD extension, list namespace details in org {organization_id} for clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, show namespace stats grouped by {groupBy}. slots: groupBy: query.groupBy method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/namespaces-details/{namespace_id}'].get update: x-apievangelist-phrasing: intent: Get a namespace via the Argo CD extension effect: read questions: - Can I inspect one namespace from within the Argo CD extension? - How does the Argo CD extension load a namespace's detail? instructions: - text: Through the Argo CD extension, show namespace {namespace_id} on cluster {clusterId}. slots: namespace_id: path.namespace_id clusterId: query.clusterId - text: Via the Argo CD extension, get namespace {namespace_id} in org {organization_id}. slots: namespace_id: path.namespace_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/nodes'].get update: x-apievangelist-phrasing: intent: List nodes via the Argo CD extension effect: read questions: - Can the Argo CD extension list the nodes in my clusters? - How does the Argo CD KubeVision extension group nodes? instructions: - text: Through the Argo CD extension, list nodes in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, show nodes grouped by {groupBy}. slots: groupBy: query.groupBy method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/nodes/{node_id}'].get update: x-apievangelist-phrasing: intent: Get a node via the Argo CD extension effect: read questions: - Can I inspect a single node from the Argo CD extension? - How does the Argo CD extension load one node's capacity and pods? instructions: - text: Through the Argo CD extension, show node {node_id} on cluster {clusterId}. slots: node_id: path.node_id clusterId: query.clusterId - text: Via the Argo CD extension, get node {node_id} in org {organization_id}. slots: node_id: path.node_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/pods'].get update: x-apievangelist-phrasing: intent: List pods via the Argo CD extension effect: read questions: - Can the Argo CD extension list pods across clusters? - How does the Argo CD KubeVision extension group pods? instructions: - text: Through the Argo CD extension, list pods in org {organization_id} on clusters {clusterIds}. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, show pods grouped by {groupBy}. slots: groupBy: query.groupBy method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/pods/{pod_id}'].get update: x-apievangelist-phrasing: intent: Get a pod via the Argo CD extension effect: read questions: - Can I inspect a single pod from the Argo CD extension? - How does the Argo CD extension load one pod's detail? instructions: - text: Through the Argo CD extension, show pod {pod_id} on cluster {clusterId}. slots: pod_id: path.pod_id clusterId: query.clusterId - text: Via the Argo CD extension, get pod {pod_id} in org {organization_id}. slots: pod_id: path.pod_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resource-types'].get update: x-apievangelist-phrasing: intent: List resource kinds via the Argo CD extension effect: read questions: - Which resource kinds does the Argo CD extension let me browse? - Can the Argo CD KubeVision extension list CRD types too? instructions: - text: Through the Argo CD extension, list resource types for instance {instanceId}. slots: instanceId: query.instanceId - text: Via the Argo CD extension, show resource kinds in org {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources'].get update: x-apievangelist-phrasing: intent: List resources via the Argo CD extension effect: read questions: - Can I filter Kubernetes resources by kind from the Argo CD extension? - How does the Argo CD extension find unhealthy resources? instructions: - text: Through the Argo CD extension, list resources of kind {kind} in namespaces {namespaces} for org {organization_id}. slots: kind: query.kind namespaces: query.namespaces organization_id: path.organization_id - text: Via the Argo CD extension, show resources with health {healthStatuses} labeled {labels}. slots: healthStatuses: query.healthStatuses labels: query.labels method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/assistant-suggestion'].post update: x-apievangelist-phrasing: intent: Ask about a resource via the Argo CD extension effect: read questions: - Can the assistant explain a failing resource from inside the Argo CD extension? - How does the Argo CD extension request AI troubleshooting for one object? instructions: - text: Through the Argo CD extension, ask {question} about resource {resource_id} in org {organization_id}. slots: question: requestBody.question resource_id: path.resource_id organization_id: path.organization_id - text: Via the Argo CD extension, get AI suggestions for {resource_id} in app {applicationName}. slots: resource_id: path.resource_id applicationName: requestBody.applicationName method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/audit-logs'].get update: x-apievangelist-phrasing: intent: View resource audit logs via the Argo CD extension effect: read questions: - Can the Argo CD extension show who changed a Kubernetes resource? - How do I filter a resource's audit trail by actor inside Argo CD? instructions: - text: Through the Argo CD extension, show audit logs for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: Via the Argo CD extension, list {action} actions by {actorId} on resource {resource_id}. slots: action: query.action actorId: query.actorId resource_id: path.resource_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/detail'].get update: x-apievangelist-phrasing: intent: Get resource detail via the Argo CD extension effect: read questions: - Can I open one resource's detail view in the Argo CD extension? - How does the Argo CD KubeVision extension load a resource's status? instructions: - text: Through the Argo CD extension, show resource {resource_id} on cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId - text: Via the Argo CD extension, get detail for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/diff'].get update: x-apievangelist-phrasing: intent: Diff a resource via the Argo CD extension effect: read questions: - Can the Argo CD extension show drift between live and desired state? - How does the Argo CD KubeVision extension diff one resource? instructions: - text: Through the Argo CD extension, diff resource {resource_id} on cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId - text: Via the Argo CD extension, compare live vs desired for {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/events'].get update: x-apievangelist-phrasing: intent: Get resource events via the Argo CD extension effect: read questions: - Can I see a resource's Kubernetes events from the Argo CD extension? - How does the Argo CD extension show why a pod keeps restarting? instructions: - text: Through the Argo CD extension, show events for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: Via the Argo CD extension, list events on {resource_id} in cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/manifest'].get update: x-apievangelist-phrasing: intent: Get a resource manifest via the Argo CD extension effect: read questions: - Can the Argo CD extension display a resource's live YAML? - How does the Argo CD KubeVision extension fetch a manifest? instructions: - text: Through the Argo CD extension, show the manifest of resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: Via the Argo CD extension, fetch YAML for {resource_id} on cluster {clusterId}. slots: resource_id: path.resource_id clusterId: query.clusterId method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/resources/{resource_id}/resolve-assistant-conversation'].post update: x-apievangelist-phrasing: intent: Resolve a resource AI chat via the Argo CD extension effect: write questions: - Can I mark resource troubleshooting resolved from inside the Argo CD extension? - How does the Argo CD extension close an AI thread about a resource? instructions: - text: 'Through the Argo CD extension, mark the chat for resource {resource_id} resolved: {resolved}.' slots: resource_id: path.resource_id resolved: requestBody.resolved - text: Via the Argo CD extension, close troubleshooting for {resource_id} on cluster {clusterId} in org {organization_id}. slots: resource_id: path.resource_id clusterId: requestBody.clusterId organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/spotlight-search'].get update: x-apievangelist-phrasing: intent: Quick-search resources via the Argo CD extension effect: read questions: - Can I spotlight-search cluster resources from the Argo CD extension? - Does the Argo CD KubeVision extension support AI-assisted search? instructions: - text: Through the Argo CD extension, spotlight search for {query}. slots: query: query.query - text: Via the Argo CD extension, run an AI search for {query} with aiSearch {aiSearch} in org {organization_id}. slots: query: query.query aiSearch: query.aiSearch organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/summary'].get update: x-apievangelist-phrasing: intent: Get a Kubernetes summary via the Argo CD extension effect: read questions: - Can the Argo CD extension show an overview of cluster health? - How does the Argo CD KubeVision extension summarize an instance? instructions: - text: Through the Argo CD extension, show the Kubernetes summary for org {organization_id}. slots: organization_id: path.organization_id - text: Via the Argo CD extension, get the overview for instance {instanceId}. slots: instanceId: query.instanceId method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/timeline-events'].get update: x-apievangelist-phrasing: intent: List timeline events via the Argo CD extension effect: read questions: - Can the Argo CD extension show a timeline of changes to my app? - How does the Argo CD KubeVision extension fetch timeline events? instructions: - text: Through the Argo CD extension, list timeline events for applications {applicationNames} in org {organization_id}. slots: applicationNames: query.applicationNames organization_id: path.organization_id - text: Via the Argo CD extension, show timeline events for resources {timelineResourceIds}. slots: timelineResourceIds: query.timelineResourceIds method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/k8s/timeline-resources'].get update: x-apievangelist-phrasing: intent: List timeline resources via the Argo CD extension effect: read questions: - Which resources can the Argo CD extension place on the timeline? - Can the Argo CD extension list timeline resources of one kind? instructions: - text: Through the Argo CD extension, list timeline resources of kind {kind} in org {organization_id}. slots: kind: query.kind organization_id: path.organization_id - text: Via the Argo CD extension, show timeline resources in namespaces {namespaces} on clusters {clusterIds}. slots: namespaces: query.namespaces clusterIds: query.clusterIds method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/stream/orgs/{organization_id}/ai/conversations/{id}/messages'].get update: x-apievangelist-phrasing: intent: Stream AI replies via the Argo CD extension effect: read questions: - Can the Argo CD extension stream assistant replies live? - How does the Argo CD KubeVision extension follow an AI chat in real time? instructions: - text: Through the Argo CD extension, stream messages for conversation {id}. slots: id: path.id - text: Via the Argo CD extension, follow live replies in chat {id} in org {organization_id}. slots: id: path.id organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/stream/orgs/{organization_id}/k8s/containers-csv'].get update: x-apievangelist-phrasing: intent: Export containers to CSV via the Argo CD extension effect: read questions: - Can I download a containers CSV from inside the Argo CD extension? - Does the Argo CD KubeVision extension export container inventory? instructions: - text: Through the Argo CD extension, export containers in org {organization_id} on clusters {clusterIds} to CSV. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, download a CSV of containers using image {image}. slots: image: query.image method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/stream/orgs/{organization_id}/k8s/deprecated-apis-csv'].get update: x-apievangelist-phrasing: intent: Export deprecated APIs to CSV via the Argo CD extension effect: read questions: - Can the Argo CD extension export deprecated API findings to CSV? - How do I download deprecated Kubernetes API usage from within Argo CD? instructions: - text: Through the Argo CD extension, export deprecated APIs in org {organization_id} on clusters {clusterIds} to CSV. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, download deprecated API usage at severity {severity} as CSV. slots: severity: query.severity method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/stream/orgs/{organization_id}/k8s/images-csv'].get update: x-apievangelist-phrasing: intent: Export images to CSV via the Argo CD extension effect: read questions: - Can I export the image inventory as CSV from the Argo CD extension? - Does the Argo CD KubeVision extension offer an images spreadsheet? instructions: - text: Using the Argo CD extension, save the image inventory for org {organization_id} and clusters {clusterIds} as a CSV file. slots: organization_id: path.organization_id clusterIds: query.clusterIds - text: Via the Argo CD extension, download a CSV of images named like {nameContains}. slots: nameContains: query.nameContains method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/stream/orgs/{organization_id}/k8s/resources-csv'].get update: x-apievangelist-phrasing: intent: Export resources to CSV via the Argo CD extension effect: read questions: - Can the Argo CD extension export a filtered resource list to CSV? - How do I download Kubernetes resources as a spreadsheet inside Argo CD? instructions: - text: Through the Argo CD extension, export resources of kind {kind} in org {organization_id} to CSV. slots: kind: query.kind organization_id: path.organization_id - text: Via the Argo CD extension, download a CSV of resources in namespaces {namespaces}. slots: namespaces: query.namespaces method: generated generated: '2026-09-26' - target: $.paths['/ext-api/v1/argocd/extensions/kubevision/stream/orgs/{organization_id}/k8s/resources/{resource_id}/logs'].get update: x-apievangelist-phrasing: intent: Stream resource logs via the Argo CD extension effect: read questions: - Can I tail pod logs from within the Argo CD extension? - How does the Argo CD KubeVision extension show a crashed container's previous logs? instructions: - text: Through the Argo CD extension, stream logs for resource {resource_id} in org {organization_id}. slots: resource_id: path.resource_id organization_id: path.organization_id - text: Via the Argo CD extension, show the last {tailLines} lines of logs for {resource_id} with previous {previous}. slots: tailLines: query.tailLines resource_id: path.resource_id previous: query.previous method: generated generated: '2026-09-26'