> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a profile runtime qualification

> Requires fresh organisation-wide ai.manage and clusters.read on the recorded target; start and cancel also require clusters.operate. Token scopes and current membership are rechecked. Start derives the target from organisation staging settings, requires one recently checked-in agent, and serializes active runs across API replicas. Only a fixed synthetic nonce reaches the probe: no profile configuration, credentials or model request. Cancellation records a request; external cleanup remains unverified until independently observed. History remains readable when new starts are unconfigured. Browser writes require CSRF.



## OpenAPI

````yaml https://platform.ankra.app/openapi.json post /api/v1/org/stack-profiles/summary-runtime-qualifications/{operation_id}/cancel
openapi: 3.1.0
info:
  title: Ankra Platform API
  version: v1
  description: >-
    The Ankra platform HTTP contract. The /api/v1 surface is the public,
    bearer-authenticated API used by the Ankra CLI, MCP clients and automation;
    send a personal or service API token as `Authorization: Bearer <token>`.
    Browser routes under /org and /chat are served on api.platform.ankra.app
    (each declares that server); they and /oauth/access authenticate with the
    ankra_session cookie, and mutations also require the X-Ankra-CSRF header.
    Every operation declares the credential it accepts, and no operation is
    served without one. This document is published deliberately: it describes
    the contract only and carries no organisation data or credentials. Report
    security issues to security@ankra.ai (see /.well-known/security.txt).
servers:
  - url: https://platform.ankra.app
security:
  - BearerAuth: []
tags:
  - name: Onboarding
    description: >-
      Generate a first website from a prompt and deploy it to a new
      organisation's cluster.
  - name: Access Gate
    description: >-
      Private service sign-in and membership checks for trusted Ankra proxy
      relays.
  - name: Canvas Datasets
    description: >-
      Read the fixed, named datasets canvas dashboards bind their charts, tables
      and stats to.
  - name: Canvases
    description: >-
      Keep dashboards and pages in the organisation's canvas library, with
      revision history, undo and pins.
  - name: Canvas Pages
    description: >-
      Publish a chat canvas artifact at a public pages address and take it down
      again.
  - name: Cloud Delegation
    description: >-
      Platform browser consent and organisation-bound connections for Ankra
      Cloud.
  - name: Organisation IAM
    description: >-
      Custom organisation roles and scoped role assignments for member and
      service-account identities.
  - name: Clusters
    description: Create, inspect and manage clusters, and the stacks deployed on them.
  - name: Managed Clusters
    description: Provider-managed control planes, driven through one common surface.
  - name: Imported Clusters
    description: Clusters that already existed and were connected to Ankra.
  - name: Cluster Access
    description: Kubeconfigs, service-account tokens and per-cluster access grants.
  - name: Kubernetes
    description: Read and act on the Kubernetes objects inside a cluster.
  - name: AWS Clusters
    description: >-
      Provision and manage self-managed k3s / kubeadm clusters on AWS EC2 in
      your own VPC.
  - name: Ankra Cloud Clusters
    description: >-
      Provision and manage self-managed kubeadm / k3s clusters on Ankra Cloud
      servers: a private network, a NAT router and a bastion per cluster.
  - name: DigitalOcean Clusters
    description: Provision and manage DigitalOcean Kubernetes clusters.
  - name: Hetzner Clusters
    description: Provision and manage Hetzner Kubernetes clusters.
  - name: OVH Clusters
    description: Provision and manage OVH Kubernetes clusters.
  - name: Scaleway Clusters
    description: Provision and manage Scaleway Kapsule clusters.
  - name: UpCloud Clusters
    description: Provision and manage UpCloud Kubernetes clusters.
  - name: Applications
    description: Deploy, configure and observe applications across the fleet.
  - name: Pipelines
    description: >-
      Pipeline definitions, the approval of the authority they declare, and the
      caches pipelines keep between runs.
  - name: Workspaces
    description: >-
      Personal workspaces on the organisation's CI pool where a repository's
      heavy commands run, and the repository profiles they are built from.
  - name: Deploy Targets
    description: >-
      Environments, the hosts registered to receive deployments, and the
      releases deployed to them.
  - name: Deploy Provenance
    description: >-
      Whether an application's deploys verify signed provenance from the
      organisation's own pipeline, the keys that provenance is signed with, and
      a dry-run that verifies images without deploying.
  - name: Backups
    description: >-
      Backup vaults, restore points, protection posture and captures for stacks
      and application deployments; a completed capture is not a verified
      restore.
  - name: Stack Profiles
    description: Reusable stack definitions, their versions and sharing.
  - name: Services
    description: >-
      Versioned service packages and explicit sharing. Runtime admission is
      separate from publication.
  - name: Charts
    description: Browse the chart catalogue behind stacks and addons.
  - name: Helm
    description: Helm registries, credentials and the charts they expose.
  - name: Executions
    description: Long-running platform executions and their jobs.
  - name: Operations
    description: Cancel in-flight cluster operations and their jobs.
  - name: Chat
    description: Conversational sessions, plans and confirmable actions.
  - name: AI Management
    description: >-
      Customer agent lifecycle, authenticated identity and organisation
      automation controls.
  - name: AI Agent Runs
    description: Autonomous agent runs and their outcomes.
  - name: AI Tickets
    description: The AI ticket board, its sync connections and settings.
  - name: AI Playbooks
    description: Reusable playbooks the AI lanes execute.
  - name: AI Conditions
    description: Conditions that gate AI autonomy.
  - name: AI Remediation
    description: >-
      The organisation's auto-remediation policy: what the AI lanes may fix by
      themselves, and who approves the rest.
  - name: AI Engineering Handoffs
    description: Work the AI lanes escalate to a human engineer.
  - name: AI Environment
    description: The environment and base stacks AI demos deploy into.
  - name: AI Memory
    description: >-
      What the assistant has learned about you: your cross-session memories and
      learned profile.
  - name: MCP Servers
    description: >-
      Register the MCP servers the organisation's AI agents can call, choose
      their tools and grant them to roles.
  - name: Security
    description: Findings, advisories, SBOMs, compliance and posture.
  - name: Cost
    description: Cluster and fleet cost, rate cards and cost settings.
  - name: Decisions
    description: >-
      The decision ledger behind the Security and Cost queues: proposals a
      surface computed, the approve and set-aside decisions people took on them,
      and the receipts of running them.
  - name: Usage
    description: >-
      What your organisation used of Ankra - vCPU-hours, playgrounds, managed
      services, hosted logs and metrics, and AI - per meter and period, with how
      completely it was measured and whether a published rate applies.
  - name: Billing
    description: Subscription and spend caps.
  - name: Organisation
    description: Members, invitations, audit logs and organisation settings.
  - name: Account
    description: >-
      Your own account: the contact email Ankra mails when it differs from your
      sign-in address.
  - name: Account Tokens
    description: Personal access tokens for the API and CLI.
  - name: Credentials
    description: The shared credential store.
  - name: AWS Credentials
    description: >-
      AWS credentials: access keys or CloudFormation-onboarded STS roles for
      cost, EKS and self-managed provisioning.
  - name: Ankra Cloud Credentials
    description: >-
      Ankra Cloud API tokens, shared by the self-managed and managed Ankra Cloud
      lanes.
  - name: Azure Credentials
    description: Azure credentials and SSH keys.
  - name: DigitalOcean Credentials
    description: DigitalOcean credentials and SSH keys.
  - name: Hetzner Credentials
    description: Hetzner credentials and SSH keys.
  - name: HPE Morpheus Credentials
    description: HPE Morpheus credentials and the capacity and quotas behind them.
  - name: OVH Credentials
    description: OVH credentials and SSH keys.
  - name: Proxmox Credentials
    description: Proxmox VE credentials and the capacity and quotas behind them.
  - name: Scaleway Credentials
    description: Scaleway credentials.
  - name: UpCloud Credentials
    description: UpCloud credentials and SSH keys.
  - name: Data Source Credentials
    description: Credentials for metrics and log sources.
  - name: DNS Credentials
    description: Credentials for DNS providers.
  - name: Object Storage Buckets
    description: >-
      Buckets Ankra creates and manages on an organisation's own provider
      credentials.
  - name: DNS
    description: DNS zones and records, including custom organisation zones.
  - name: Cloudflare
    description: Cloudflare domains and the credentials behind them.
  - name: Avura
    description: >-
      The linked Avura organization, the domains it shares with Ankra Platform,
      and their DNS records.
  - name: Variables
    description: Organisation- and cluster-scoped variables.
  - name: Secret Slots
    description: >-
      Store secrets in Vault and reference them by ${SECRET_SLOT:<slot_id>}
      sentinel instead of by value.
  - name: SOPS
    description: Encrypt and decrypt values with the organisation SOPS config.
  - name: Alerts
    description: Alert integrations and ingest credentials.
  - name: Notifications
    description: Notification routes and their delivery targets.
  - name: Support
    description: Support tickets.
  - name: AI Settings
    description: Organisation AI provider, model catalog and per-function model settings
paths:
  /api/v1/org/stack-profiles/summary-runtime-qualifications/{operation_id}/cancel:
    post:
      tags:
        - Stack Profiles
      summary: Cancel a profile runtime qualification
      description: >-
        Requires fresh organisation-wide ai.manage and clusters.read on the
        recorded target; start and cancel also require clusters.operate. Token
        scopes and current membership are rechecked. Start derives the target
        from organisation staging settings, requires one recently checked-in
        agent, and serializes active runs across API replicas. Only a fixed
        synthetic nonce reaches the probe: no profile configuration, credentials
        or model request. Cancellation records a request; external cleanup
        remains unverified until independently observed. History remains
        readable when new starts are unconfigured. Browser writes require CSRF.
      operationId: cancel_profile_summary_qualification_api_v1
      parameters:
        - name: operation_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      responses:
        '200':
          description: >-
            Recorded qualification operation; inspect state and individual
            observations.
          headers:
            Cache-Control:
              schema:
                type: string
                enum:
                  - private, no-store
            Retry-After:
              description: >-
                Polling interval in seconds while running; omitted when
                replaying a terminal operation.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileSummaryQualification'
        '400':
          description: Unable to read body
        '401':
          description: Authentication required
        '403':
          description: >-
            Required current role, target access, token scope or CSRF proof is
            absent
        '404':
          description: Operation or target not visible in this organisation/project
        '409':
          description: Another qualification is active; wait for it or cancel it
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileSummaryQualificationRefusal'
        '413':
          description: Body exceeds 8192 bytes
        '422':
          description: >-
            Malformed, duplicate, case-folded, unknown or missing fields; start
            requires a nonzero request_id
        '500':
          description: Authority or persistence could not be read; do not infer absence
        '503':
          description: >-
            Qualification unavailable, or outcome_unknown when a write
            acknowledgement is uncertain. Read status or retry the same
            request_id; never silently start another run.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileSummaryQualificationRefusal'
      security:
        - BearerAuth: []
components:
  schemas:
    ProfileSummaryQualification:
      type: object
      additionalProperties: false
      required:
        - operation_id
        - request_id
        - cluster_id
        - agent_id
        - state
        - outcome
        - agent_version
        - image
        - created_at
        - updated_at
        - report
        - subject_retention_observed
        - cleanup_state
      properties:
        operation_id:
          type: string
          format: uuid
        request_id:
          type: string
          format: uuid
        cluster_id:
          type: string
          format: uuid
        agent_id:
          type: string
          format: uuid
        state:
          type: string
          description: >-
            Execution state; success is rendered as completed. Terminal failures
            can include failed, timeout, or cancelled.
        outcome:
          type: string
          enum:
            - unverified
            - completed
            - unavailable
            - cancelled
            - interrupted
            - authority_changed
        agent_version:
          type: string
          minLength: 1
          maxLength: 128
        image:
          type: string
          pattern: ^registry\.ankra\.cloud/cluster/cluster@sha256:[a-f0-9]{64}$
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        report:
          anyOf:
            - $ref: '#/components/schemas/ProfileSummaryQualificationReport'
            - type: 'null'
        subject_retention_observed:
          type: boolean
          description: >-
            True only after actual reply and input subjects were checked against
            JetStream before and after the exchange. False means unverified, not
            retained. Does not establish account isolation, backups, or future
            topology.
        cleanup_state:
          type: string
          enum:
            - observed
            - unverified
          description: >-
            Observed only for reported normal and network cleanup. Cancellation
            acceptance does not prove cleanup.
      description: >-
        Private execution history bound to the exact staging cluster, agent
        version and operator-configured immutable probe image. Completion means
        the report was accepted, not that every observation passed. This
        operation cannot enable generation or write a qualification receipt.
    ProfileSummaryQualificationRefusal:
      type: object
      additionalProperties: false
      required:
        - detail
        - code
      properties:
        detail:
          type: string
        code:
          type: string
          enum:
            - qualification_unavailable
            - qualification_in_progress
            - outcome_unknown
    ProfileSummaryQualificationReport:
      type: object
      additionalProperties: false
      required:
        - version
        - nonce
        - policy
        - image
        - checks
      properties:
        version:
          type: string
          enum:
            - profile_runtime_qualification_v1
        nonce:
          type: string
          pattern: ^[a-f0-9]{64}$
        policy:
          type: string
          enum:
            - profile_analysis_stdin_v1
        image:
          type: string
          pattern: ^registry\.ankra\.cloud/cluster/cluster@sha256:[a-f0-9]{64}$
        checks:
          type: object
          additionalProperties: false
          required:
            - non_root_identity
            - no_new_privileges
            - seccomp_filter
            - capabilities_dropped
            - service_account_token_absent
            - root_filesystem_read_only
            - temporary_write_denied_read_only
            - memory_limit_at_most_one_gib
            - cpu_limit_at_most_one_core
            - admission_policy
            - authenticated_input_attach
            - bounded_output
            - normal_cleanup
            - network_egress_ipv4
            - network_ingress_ipv4
            - network_egress_ipv6
            - network_ingress_ipv6
            - network_cleanup
            - cancel_cleanup
            - agent_death_cleanup
            - transport_reconnect
            - duplicate_delivery
            - restore_replay
            - nats_account_isolation
            - nats_retention
            - backup_retention
          properties:
            non_root_identity:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            no_new_privileges:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            seccomp_filter:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            capabilities_dropped:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            service_account_token_absent:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            root_filesystem_read_only:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            temporary_write_denied_read_only:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            memory_limit_at_most_one_gib:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            cpu_limit_at_most_one_core:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            admission_policy:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            authenticated_input_attach:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            bounded_output:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            normal_cleanup:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            network_egress_ipv4:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            network_ingress_ipv4:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            network_egress_ipv6:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            network_ingress_ipv6:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            network_cleanup:
              type: string
              enum:
                - satisfied
                - violated
                - unverified
            cancel_cleanup:
              type: string
              enum:
                - unverified
            agent_death_cleanup:
              type: string
              enum:
                - unverified
            transport_reconnect:
              type: string
              enum:
                - unverified
            duplicate_delivery:
              type: string
              enum:
                - unverified
            restore_replay:
              type: string
              enum:
                - unverified
            nats_account_isolation:
              type: string
              enum:
                - unverified
            nats_retention:
              type: string
              enum:
                - unverified
            backup_retention:
              type: string
              enum:
                - unverified
      description: >-
        Bounded synthetic observations, never an admission receipt or an overall
        pass. Version one leaves lifecycle, account and backup checks
        unverified. IPv6 can remain unverified on a single-stack cluster.
  securitySchemes:
    BearerAuth:
      bearerFormat: PAT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.