Akuity

Akuity Kargo Service API

The KargoService API from Akuity — 39 operation(s) for kargoservice.

GitHub OpenAPI
Business capability
Deployment Orchestration BC-4210.40

Operations 51

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/orgs/{organization_id}/kargo/instances List Kargo instances in an organization · List Kargo Instances #
Ask an LLM
“Which Kargo instances does my Akuity organization run?”
“Can I narrow the organization-wide Kargo instance list to one workspace with a query filter?”
Tell an agent
List every Kargo instance in organization {organization_id}.
Show the Kargo instances of org {organization_id}, filtered by the workspaceId query value {workspace}.
POST /api/v1/orgs/{organization_id}/kargo/instances Create a Kargo instance at the organization level · Create Kargo Instance #
Ask an LLM
“How do I spin up a new managed Kargo instance for my organization?”
“Can I pick the Kargo version when provisioning an instance through the org-level endpoint?”
Tell an agent
Provision a Kargo instance named {name} in organization {organization_id}.
Stand up Kargo {version} as instance {name} under org {organization_id} with description {description}.
POST /api/v1/orgs/{organization_id}/kargo/instances/promotions-events Query Kargo promotion events for an organization · Get Promotion Events #
Ask an LLM
“What promotions have happened across all Kargo instances in my organization?”
“Is there a way to page through org-wide promotion events with a limit and offset?”
Tell an agent
Pull the Kargo promotion event history for organization {organization_id}.
Fetch {limit} org-level promotion events for {organization_id} starting at offset {offset}.
POST /api/v1/orgs/{organization_id}/kargo/instances/promotions-stats Get Kargo promotion statistics for an organization · Get Promotion Stats #
Ask an LLM
“How many Kargo promotions ran over time across my whole organization?”
“Can promotion statistics be bucketed by an interval and grouped by a field for the org?”
Tell an agent
Chart promotion stats for organization {organization_id} bucketed by {interval}.
Aggregate org {organization_id} promotion counts grouped by {group_by}.
POST /api/v1/orgs/{organization_id}/kargo/instances/stage-specific-stats Get per-stage Kargo stats for an organization · Get Stage Specific Stats #
Ask an LLM
“Which Kargo stages see the most activity across my organization?”
“Where can I get stage-by-stage statistics for every Kargo instance in the org?”
Tell an agent
Break down Kargo activity by stage for organization {organization_id}.
Get org-level stage specific stats for {organization_id} using filter {filter}.
DELETE /api/v1/orgs/{organization_id}/kargo/instances/{id} Delete a Kargo instance by organization · Delete Instance #
Ask an LLM
“How do I tear down a Kargo instance I no longer need in my organization?”
“Does removing a Kargo instance through the org endpoint accept an optional workspace hint?”
Tell an agent destructive · confirm first
Delete Kargo instance {id} from organization {organization_id}.
Permanently remove org {organization_id}'s Kargo instance {id}, passing workspaceId {workspace}.
PATCH /api/v1/orgs/{organization_id}/kargo/instances/{id} Patch a Kargo instance's settings (org scope) · Patch Kargo Instance #
Ask an LLM
“Can I partially change a Kargo instance's configuration without resending all of it?”
“What's the org-scoped way to apply a PATCH to one Kargo instance?”
Tell an agent
Patch Kargo instance {id} in organization {organization_id}.
Apply a partial settings update to org {organization_id} Kargo instance {id}.
PUT /api/v1/orgs/{organization_id}/kargo/instances/{id}/transfer Move a Kargo instance to another workspace · Update Kargo Instance Workspace #
Ask an LLM
“How can I transfer a Kargo instance from one workspace to a different one?”
“Is it possible to reassign which workspace owns a Kargo instance using only the organization path?”
Tell an agent
Transfer Kargo instance {id} in organization {organization_id} to workspace {new_workspace}.
Reassign org {organization_id}'s instance {id} so it belongs to workspace {new_workspace}.
GET /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents List agents on a Kargo instance (org scope) · List Kargo Instance Agents #
Ask an LLM
“Which agents are connected to my Kargo instance?”
“Can I see every Kargo agent registered to an instance using just the organization path?”
Tell an agent
List the agents of Kargo instance {instance_id} in organization {organization_id}.
Show all registered agents for org {organization_id} instance {instance_id} with workspaceId {workspace}.
POST /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents Register a new agent on a Kargo instance · Create Kargo Instance Agent #
Ask an LLM
“How do I add a Kargo agent for a new cluster to my instance?”
“Can I upsert a Kargo agent so it is created or updated in one call from the org route?”
Tell an agent
Create a Kargo agent named {name} in namespace {namespace} on instance {instance_id} of org {organization_id}.
Register agent {name} for organization {organization_id} Kargo instance {instance_id} with upsert set to {upsert}.
PUT /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents Apply customizations to all agents of an instance · Update Kargo Instance Agents #
Ask an LLM
“How do I push agent customizations to every agent of a Kargo instance at once?”
“Can bulk agent customizations be set through the organization-level Kargo route?”
Tell an agent
Set agent customizations {customizations} on Kargo instance {instance_id} in org {organization_id}.
Bulk-update the agent settings of organization {organization_id} instance {instance_id}.
POST /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/regenerate-manifests Regenerate install manifests for Kargo agents · Regenerate Manifests #
Ask an LLM
“How do I regenerate the install manifests for some or all Kargo agents?”
“Can I rebuild agent manifests for every agent on an instance via the organization path?”
Tell an agent
Regenerate manifests for agents {agent_names} on Kargo instance {instance_id} in org {organization_id}.
Rebuild install manifests for all agents of organization {organization_id} instance {instance_id}.
POST /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/rotate-credentials Rotate credentials for Kargo agents · Rotate Instance Agent Credentials #
Ask an LLM
“How do I rotate the credentials my Kargo agents use to connect?”
“Can agent credential rotation target every agent on an instance from the org route?”
Tell an agent
Rotate credentials for Kargo agents {agent_names} on instance {instance_id} in org {organization_id}.
Issue fresh credentials to all agents of organization {organization_id} instance {instance_id}.
POST /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/set-maintenance-mode Put Kargo agents into maintenance mode · Set Agent Maintenance Mode #
Ask an LLM
“How do I put my Kargo agents into maintenance mode while I work on a cluster?”
“Can maintenance mode on Kargo agents expire automatically after a set time?”
Tell an agent
Turn maintenance mode {mode} for agents {agent_names} on instance {instance_id} in org {organization_id}.
Pause every agent of organization {organization_id} instance {instance_id} for maintenance until {expiry}.
POST /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/version Upgrade Kargo agents to a new version · Update Instance Agent Version #
Ask an LLM
“How do I upgrade my Kargo agents to a newer version?”
“Can I roll one agent version out to all agents on an instance through the org path?”
Tell an agent
Upgrade Kargo agents {agent_names} on instance {instance_id} in org {organization_id} to version {version}.
Move all agents of organization {organization_id} instance {instance_id} onto agent release {version}.
DELETE /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/{id} Remove an agent from a Kargo instance (org scope) · Delete Instance Agent #
Ask an LLM
“How do I remove a Kargo agent for a cluster I've decommissioned?”
“Can I delete one agent from a Kargo instance using only the organization route?”
Tell an agent destructive · confirm first
Delete Kargo agent {id} from instance {instance_id} in organization {organization_id}.
Unregister agent {id} of org {organization_id} instance {instance_id}, with workspaceId {workspace}.
GET /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/{id} Get one Kargo agent's details (org scope) · Get Kargo Instance Agent #
Ask an LLM
“What is the current state of a specific Kargo agent?”
“Can I look up a single Kargo agent by its ID using the organization path?”
Tell an agent
Show Kargo agent {id} on instance {instance_id} in organization {organization_id}.
Fetch details of agent {id} from org {organization_id} instance {instance_id}, workspaceId {workspace}.
PUT /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/{id} Update one Kargo agent's settings (org scope) · Update Kargo Instance Agent #
Ask an LLM
“How do I change the description or data of a single Kargo agent?”
“Can one existing agent be edited in place through the org-level Kargo route?”
Tell an agent
Update Kargo agent {id} on instance {instance_id} in org {organization_id} with description {description}.
Replace the data of organization {organization_id} instance {instance_id} agent {id} with {data}.
GET /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/{id}/command Get the install command for a Kargo agent · Get Instance Agent Command #
Ask an LLM
“What command do I run on my cluster to install a Kargo agent?”
“Can the agent install command skip creating the namespace?”
Tell an agent
Give me the install command for Kargo agent {id} on instance {instance_id} in org {organization_id}.
Get the {type} install command for org {organization_id} instance {instance_id} agent {id} with skipNamespace {skip_namespace}.
GET /api/v1/orgs/{organization_id}/kargo/instances/{instance_id}/agents/{id}/manifests Download a Kargo agent's Kubernetes manifests · Get Kargo Instance Agent Manifests #
Ask an LLM
“Where do I get the raw Kubernetes manifests to deploy a Kargo agent myself?”
“Can I download a Kargo agent's manifests without the namespace object via the org route?”
Tell an agent
Download manifests for Kargo agent {id} on instance {instance_id} in organization {organization_id}.
Export org {organization_id} instance {instance_id} agent {id} YAML with skipNamespace {skip_namespace}.
GET /api/v1/orgs/{organization_id}/kargo/instances/{name} Get a Kargo instance by name (org scope) · Get Kargo Instance #
Ask an LLM
“What is the configuration and status of my Kargo instance?”
“Can I look up a Kargo instance by its name using only the organization path?”
Tell an agent
Show Kargo instance {name} in organization {organization_id}.
Retrieve org {organization_id}'s instance called {name} with workspaceId {workspace}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances List Kargo instances in a workspace · List Kargo Instances #
Ask an LLM
“Which Kargo instances live inside one particular workspace?”
“Is there a workspace-scoped route that returns only that workspace's Kargo instances?”
Tell an agent
List Kargo instances in workspace {workspace_id} of organization {organization_id}.
Enumerate what Kargo runs under workspace {workspace_id} for org {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances Create a Kargo instance inside a workspace · Create Kargo Instance #
Ask an LLM
“How do I create a Kargo instance directly inside a specific workspace?”
“Can a workspace-scoped create set the instance's Kargo version and description?”
Tell an agent
Create Kargo instance {name} in workspace {workspace_id} of org {organization_id}.
Launch version {version} of Kargo as {name} within workspace {workspace_id}, organization {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/promotions-events Query Kargo promotion events in a workspace · Get Promotion Events #
Ask an LLM
“What promotion events did the Kargo instances in one workspace produce?”
“Can workspace-level promotion events be filtered with a fuzzy fieldLike match?”
Tell an agent
List promotion events for workspace {workspace_id} in organization {organization_id}.
Search workspace {workspace_id} (org {organization_id}) promotion events where field {field} is like {field_like}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/promotions-stats Get Kargo promotion statistics for a workspace · Get Promotion Stats #
Ask an LLM
“How often are promotions happening in a single workspace's Kargo instances?”
“Can I group one workspace's promotion statistics by a chosen field?”
Tell an agent
Summarize promotion stats for workspace {workspace_id} of org {organization_id} per {interval}.
Count workspace {workspace_id} promotions in organization {organization_id} grouped by {group_by}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/stage-specific-stats Get per-stage Kargo stats for a workspace · Get Stage Specific Stats #
Ask an LLM
“Which stages are busiest in the Kargo instances of one workspace?”
“Can I get stage-level Kargo statistics scoped to a single workspace?”
Tell an agent
Get stage specific stats for workspace {workspace_id} in organization {organization_id}.
Break down workspace {workspace_id} Kargo stages for org {organization_id} with filter {filter}.
DELETE /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{id} Delete a Kargo instance from a workspace · Delete Instance #
Ask an LLM
“How do I delete a Kargo instance that belongs to a specific workspace?”
“Is there a workspace-scoped endpoint for destroying a Kargo instance?”
Tell an agent destructive · confirm first
Delete Kargo instance {id} in workspace {workspace_id} of org {organization_id}.
Destroy workspace {workspace_id}'s instance {id} under organization {organization_id}.
PATCH /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{id} Patch a Kargo instance within a workspace · Patch Kargo Instance #
Ask an LLM
“Can I partially update a Kargo instance through its workspace path?”
“What's the workspace-scoped way to PATCH a Kargo instance's settings?”
Tell an agent
Patch Kargo instance {id} in workspace {workspace_id} of organization {organization_id}.
Partially modify workspace {workspace_id} instance {id} config for org {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{id}/apply Apply a declarative Kargo instance configuration · Apply Kargo Instance #
Ask an LLM
“How do I declaratively apply projects, stages and warehouses to a Kargo instance in one call?”
“Can an apply prune resource types that are no longer in my Kargo configuration?”
Tell an agent
Apply stages {stages} and warehouses {warehouses} to Kargo instance {id} in workspace {workspace_id}, org {organization_id}.
Apply projects {projects} to instance {id} in workspace {workspace_id} of {organization_id} and prune {prune_types}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{id}/export Export a Kargo instance's full configuration · Export Kargo Instance #
Ask an LLM
“How do I export a Kargo instance's configuration so I can keep it in Git?”
“Can I dump everything defined on a Kargo instance for backup?”
Tell an agent
Export Kargo instance {id} from workspace {workspace_id} in organization {organization_id}.
Back up the declarative config of instance {id}, workspace {workspace_id}, org {organization_id}.
PUT /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{id}/transfer Transfer a Kargo instance out of its current workspace · Update Kargo Instance Workspace #
Ask an LLM
“How do I move a Kargo instance out of the workspace it currently sits in?”
“Can I hand a Kargo instance over to another workspace starting from its existing workspace path?”
Tell an agent
Move instance {id} from workspace {workspace_id} to workspace {new_workspace} in org {organization_id}.
Hand Kargo instance {id} currently in {workspace_id} over to {new_workspace}, organization {organization_id}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents List agents on a Kargo instance in a workspace · List Kargo Instance Agents #
Ask an LLM
“What agents are attached to a Kargo instance in a given workspace?”
“Is there a workspace-scoped list of a Kargo instance's agents?”
Tell an agent
List agents for instance {instance_id} in workspace {workspace_id} of org {organization_id}.
Enumerate the connected clusters of workspace {workspace_id} Kargo instance {instance_id}, organization {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents Add an agent to a workspace's Kargo instance · Create Kargo Instance Agent #
Ask an LLM
“How do I connect a new cluster agent to a Kargo instance in a workspace?”
“Can I create or upsert an agent on a Kargo instance through the workspace route?”
Tell an agent
Add agent {name} to instance {instance_id} in workspace {workspace_id} of org {organization_id}.
Upsert {upsert} a workspace {workspace_id} agent {name} in namespace {namespace} on instance {instance_id}, org {organization_id}.
PUT /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents Customize all agents of a workspace's Kargo instance · Update Kargo Instance Agents #
Ask an LLM
“Can I change agent customizations for a whole Kargo instance through its workspace path?”
“Where do I set shared agent customizations for an instance that lives in a workspace?”
Tell an agent
Apply agent customizations {customizations} to instance {instance_id} in workspace {workspace_id}, org {organization_id}.
Update every agent's customization on workspace {workspace_id} instance {instance_id} for {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/regenerate-manifests Regenerate agent manifests for a workspace instance · Regenerate Manifests #
Ask an LLM
“Can I regenerate Kargo agent manifests for an instance through its workspace path?”
“Is there a workspace-scoped way to rebuild agent install manifests after a config change?”
Tell an agent
Regenerate agent manifests {agent_names} for instance {instance_id} in workspace {workspace_id}, org {organization_id}.
Recreate every agent's manifests on workspace {workspace_id} instance {instance_id} for {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/rotate-credentials Rotate agent credentials for a workspace instance · Rotate Instance Agent Credentials #
Ask an LLM
“Can I rotate agent credentials for a Kargo instance through its workspace path?”
“Is there a workspace-scoped route to refresh the secrets my agents use?”
Tell an agent
Rotate credentials of agents {agent_names} on instance {instance_id} in workspace {workspace_id}, org {organization_id}.
Refresh secrets for all agents of workspace {workspace_id} Kargo instance {instance_id}, {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/set-maintenance-mode Set maintenance mode on a workspace instance's agents · Set Agent Maintenance Mode #
Ask an LLM
“Can I set maintenance mode on Kargo agents through the workspace path?”
“Is there a workspace-scoped way to pause agents with an expiry?”
Tell an agent
Set maintenance mode {mode} on agents {agent_names} of instance {instance_id}, workspace {workspace_id}, org {organization_id}.
Hold all workspace {workspace_id} agents on instance {instance_id} in maintenance until {expiry} for {organization_id}.
POST /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/version Upgrade agents of a workspace's Kargo instance · Update Instance Agent Version #
Ask an LLM
“Can I change the Kargo agent version through the workspace route?”
“Is there a workspace-scoped endpoint for rolling agents onto a new release?”
Tell an agent
Set agents {agent_names} on instance {instance_id} in workspace {workspace_id}, org {organization_id} to {version}.
Roll workspace {workspace_id} instance {instance_id} agents forward to {version} in {organization_id}.
DELETE /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/{id} Delete an agent from a workspace's Kargo instance · Delete Instance Agent #
Ask an LLM
“Can I delete a Kargo agent through its workspace path?”
“Is there a workspace-scoped endpoint to drop a cluster agent from an instance?”
Tell an agent destructive · confirm first
Remove agent {id} from instance {instance_id} in workspace {workspace_id}, org {organization_id}.
Drop workspace {workspace_id} Kargo agent {id} from {instance_id} for {organization_id}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/{id} Get one agent of a workspace's Kargo instance · Get Kargo Instance Agent #
Ask an LLM
“Can I look up a single Kargo agent through its workspace path?”
“Where do I check the status of one agent on a workspace-owned Kargo instance?”
Tell an agent
Get agent {id} of instance {instance_id} in workspace {workspace_id}, organization {organization_id}.
Check the status of workspace {workspace_id} Kargo agent {id} on {instance_id} for {organization_id}.
PUT /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/{id} Edit one agent of a workspace's Kargo instance · Update Kargo Instance Agent #
Ask an LLM
“Can I edit a single Kargo agent through its workspace path?”
“Is there a workspace-scoped route to change one agent's description?”
Tell an agent
Edit agent {id} on instance {instance_id} in workspace {workspace_id}, org {organization_id}: description {description}.
Overwrite workspace {workspace_id} agent {id} data with {data} on instance {instance_id} for {organization_id}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/{id}/command Get an agent install command via a workspace · Get Instance Agent Command #
Ask an LLM
“Can I fetch the Kargo agent install command through the workspace route?”
“Does the workspace-scoped command lookup accept a location origin?”
Tell an agent
Fetch the install command for agent {id}, instance {instance_id}, workspace {workspace_id}, org {organization_id}.
Build the workspace {workspace_id} agent {id} setup command on {instance_id} for {organization_id} with origin {origin}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents/{id}/manifests Get agent manifests via a workspace · Get Kargo Instance Agent Manifests #
Ask an LLM
“Can I pull Kargo agent manifests through the workspace path?”
“Is there a workspace-scoped download of an agent's deployment YAML?”
Tell an agent
Pull manifests for agent {id}, instance {instance_id}, workspace {workspace_id}, organization {organization_id}.
Save workspace {workspace_id} agent {id} deployment YAML from {instance_id} in {organization_id}, skipNamespace {skip_namespace}.
GET /api/v1/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{name} Get a Kargo instance by name within a workspace · Get Kargo Instance #
Ask an LLM
“Can I look up a Kargo instance by name inside a particular workspace?”
“Is there a workspace-scoped way to read one Kargo instance's details?”
Tell an agent
Get Kargo instance {name} from workspace {workspace_id} of org {organization_id}.
Read details of workspace {workspace_id}'s instance named {name}, organization {organization_id}.
GET /api/v1/stream/orgs/{organization_id}/kargo/instances Stream changes to Kargo instances in an organization · Watch Kargo Instances #
Ask an LLM
“How can I get live updates when any Kargo instance in my organization changes?”
“Can I watch a single Kargo instance's changes as a stream?”
Tell an agent
Watch organization {organization_id} for Kargo instance changes.
Stream live updates for Kargo instance {instance} in org {organization_id}.
GET /api/v1/stream/orgs/{organization_id}/kargo/instances/{instance_id}/agents Stream changes to a Kargo instance's agents · Watch Kargo Instance Agents #
Ask an LLM
“How do I subscribe to live agent status changes on a Kargo instance?”
“Can I watch only agents whose names fall in a range?”
Tell an agent
Watch the agents of Kargo instance {instance_id} in organization {organization_id}.
Stream updates for agent {agent} on org {organization_id} instance {instance_id}.
GET /api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances Stream changes to Kargo instances in a workspace · Watch Kargo Instances #
Ask an LLM
“Can I get a live feed of Kargo instance changes limited to one workspace?”
“Is there a workspace-scoped stream for instance updates?”
Tell an agent
Subscribe to Kargo instance events in workspace {workspace_id} of {organization_id}.
Follow workspace {workspace_id} instance {instance} live for organization {organization_id}.
GET /api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/kargo/instances/{instance_id}/agents Stream agent changes for a workspace's instance · Watch Kargo Instance Agents #
Ask an LLM
“Can I stream Kargo agent updates through the workspace path?”
“Is there a workspace-scoped live feed of an instance's agents?”
Tell an agent
Subscribe to agent events on instance {instance_id} in workspace {workspace_id}, org {organization_id}.
Tail workspace {workspace_id} agent {agent} on {instance_id} live for {organization_id}.
POST /ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/kargo/instances/promotions-events Get promotion events via the KubeVision extension · Get Promotion Events #
Ask an LLM
“Can the Argo CD KubeVision extension show Kargo promotion events?”
“Is there a promotion-event feed served under the Argo CD extension API?”
Tell an agent
Through the KubeVision extension, fetch Kargo promotion events for organization {organization_id}.
Via the Argo CD extension API, page {limit} promotion events for {organization_id} from offset {offset}.
POST /ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/kargo/instances/promotions-stats Get promotion stats via the KubeVision extension · Get Promotion Stats #
Ask an LLM
“Can I read Kargo promotion statistics from inside the Argo CD KubeVision extension?”
“Does the extension API support interval bucketing for promotion counts?”
Tell an agent
Through KubeVision, get promotion stats for org {organization_id} per {interval}.
Via the Argo CD extension route, total {organization_id} promotions grouped by {group_by}.
POST /ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/kargo/instances/stage-specific-stats Get per-stage stats via the KubeVision extension · Get Stage Specific Stats #
Ask an LLM
“Can the KubeVision extension in Argo CD show Kargo stats per stage?”
“Is there an extension-API route for stage-level Kargo statistics?”
Tell an agent
Through KubeVision, get stage specific Kargo stats for organization {organization_id}.
Via the Argo CD extension API, split {organization_id} Kargo activity by stage with filter {filter}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/openapi/akuity-kargoservice-api-openapi.yml

Other Resources

🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-organization.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-argocd.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-kargo.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-system.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-apikey.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-customrole.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-auth.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/grpc/akuity-extension.proto

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/akuity:akuity-kargoservice-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

akuity-kargoservice-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: info@akuity.io
    name: Akuity
    url: https://docs.akuity.io/akuity-portal/automation/api
  description: The Kargo surface of the Akuity Platform REST API (grpc-gateway projection of kargo/v1). Derived mechanically from the protobuf service descriptors and google.api.http annotations published in the akuity/api-client-go Go module.
  title: Akuity Platform API — Kargo Kargo Service API
  version: v1
servers:
- description: Akuity Platform (SaaS)
  url: https://akuity.cloud
security:
- basicAuth: []
tags:


# --- truncated at 32 KB (119 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/akuity/refs/heads/main/openapi/akuity-kargoservice-api-openapi.yml