Codefresh Gitops Application API
The gitops-application API from Codefresh — 5 operation(s) for gitops-application.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/codefresh:codefresh-gitops-application-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
name: Codefresh
url: https://www.codefresh.io
description: Codefresh API openAPI 3.0 specification
termsOfService: https://codefresh.io/docs/docs/terms-and-privacy-policy/terms-of-service/
title: Codefresh Gitops Application API
version: 0.0.2
x-logo:
url: https://g.codefresh.io/modules/cf.resources/codefresh-api-docs-images/codefresh-logo-api.svg
backgroundColor: '#FFFFFF'
altText: Codefresh
servers:
- url: https://g.codefresh.io/api
security:
- API-key: []
tags:
- name: gitops-application
paths:
/gitops/application:
post:
x-action: create
x-audit:
name:
path: body.metadata.name
source: req
id:
path: _id
source: res
responses:
'200':
content:
application/json:
schema:
type: object
description: json
tags:
- gitops-application
operationId: gitops-application-create
requestBody:
content:
application/json:
schema:
type: object
summary: Create argo application
parameters: []
x-sdk-interface: gitops-application.create
x-endpoint:
isEndpoint: false
auth:
middleware:
- auth.isAuthenticated
acl:
resource: environments-v2
postMiddleware:
- global.iseMiddleware
handler: argo.application.create
x-code-samples:
- lang: curl
source: "curl \\\n -X POST \\\n -H \"Authorization: ${API_KEY}\" \\\n -H 'Content-Type: application/json; charset=utf-8' \\\n -d \"${REQUEST_BODY_OBJ}\" \\\n \"https://g.codefresh.io/api/gitops/application\""
- lang: node.js
source: sdk.gitops-application.create({ ...REQUEST_BODY_OBJ })
/gitops/application/{name}:
put:
x-entityId:
pathId: params.name
pathName: body.metadata.name
x-action: replace
parameters:
- description: Name of environment
in: path
name: name
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
kind:
type: string
metadata:
type: object
properties:
name:
type: string
spec:
type: object
properties: {}
responses:
'200':
description: ok
content:
application/json:
schema:
type: object
properties:
kind:
type: string
metadata:
type: object
properties:
name:
type: string
spec:
type: object
properties: {}
tags:
- gitops-application
operationId: gitops-application-replace
summary: Replace argo application
x-sdk-interface: gitops-application.replace
x-endpoint:
isEndpoint: false
auth:
middleware:
- auth.isAuthenticated
acl:
resource: environments-v2
postMiddleware:
- global.iseMiddleware
handler: argo.application.replace
x-code-samples:
- lang: curl
source: "curl \\\n -X PUT \\\n -H \"Authorization: ${API_KEY}\" \\\n -H 'Content-Type: application/json; charset=utf-8' \\\n -d \"{\\\"kind\\\":\\\"${KIND_STR}\\\",\\\"metadata\\\":{\\\"name\\\":\\\"${NAME_STR}\\\"},\\\"spec\\\":${SPEC_OBJ}}\" \\\n \"https://g.codefresh.io/api/gitops/application/${NAME}\""
- lang: node.js
source: "sdk.gitops-application.replace({ name }, {\n kind: `${KIND_STR}`,\n metadata: {\n name: `${NAME_STR}`\n },\n spec: { ...SPEC_OBJ }\n})"
delete:
x-entityId:
pathId: params.name
x-action: remove
parameters:
- description: Name of environment
in: path
name: name
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
type: object
description: json
tags:
- gitops-application
operationId: gitops-application-remove
summary: Delete
x-sdk-interface: gitops-application.remove
x-endpoint:
isEndpoint: false
auth:
middleware:
- auth.isAuthenticated
acl:
resource: environments-v2
postMiddleware:
- global.iseMiddleware
handler: argo.application.remove
x-code-samples:
- lang: curl
source: "curl \\\n -X DELETE \\\n -H \"Authorization: ${API_KEY}\" \\\n \"https://g.codefresh.io/api/gitops/application/${NAME}\""
- lang: node.js
source: sdk.gitops-application.remove({ name })
/gitops/application/{name}/update:
put:
x-entityId:
pathId: params.name
pathName: body.metadata.name
x-action: replace
parameters:
- description: Name of environment
in: path
name: name
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
kind:
type: string
metadata:
type: object
properties:
name:
type: string
spec:
type: object
properties: {}
responses:
'200':
description: ok
content:
application/json:
schema:
type: object
properties:
kind:
type: string
metadata:
type: object
properties:
name:
type: string
spec:
type: object
properties: {}
tags:
- gitops-application
operationId: gitops-application-update
summary: Replace
x-sdk-interface: gitops-application.update
x-endpoint:
isEndpoint: false
auth:
middleware:
- auth.isAuthenticated
acl:
resource: environments-v2
postMiddleware:
- global.iseMiddleware
handler: argo.application.update
x-code-samples:
- lang: curl
source: "curl \\\n -X PUT \\\n -H \"Authorization: ${API_KEY}\" \\\n -H 'Content-Type: application/json; charset=utf-8' \\\n -d \"{\\\"kind\\\":\\\"${KIND_STR}\\\",\\\"metadata\\\":{\\\"name\\\":\\\"${NAME_STR}\\\"},\\\"spec\\\":${SPEC_OBJ}}\" \\\n \"https://g.codefresh.io/api/gitops/application/${NAME}/update\""
- lang: node.js
source: "sdk.gitops-application.update({ name }, {\n kind: `${KIND_STR}`,\n metadata: {\n name: `${NAME_STR}`\n },\n spec: { ...SPEC_OBJ }\n})"
/gitops/application/all/tags:
get:
parameters: []
responses:
'200':
content:
application/json:
schema:
type: object
description: json
tags:
- gitops-application
operationId: gitops-application-get-tags
summary: Get
x-sdk-interface: gitops-application.get-tags
x-endpoint:
isEndpoint: false
auth:
middleware:
- auth.isAuthenticated
acl:
resource: gitops
postMiddleware:
- global.iseMiddleware
handler: argo.application.getAllTags
x-code-samples:
- lang: curl
source: "curl \\\n -X GET \\\n -H \"Authorization: ${API_KEY}\" \\\n \"https://g.codefresh.io/api/gitops/application/all/tags\""
- lang: node.js
source: sdk.gitops-application.get-tags()
/gitops/application/{name}/set/tags:
post:
responses:
'200':
content:
application/json:
schema:
type: object
description: json
tags:
- gitops-application
operationId: gitops-application.setTags
requestBody:
content:
application/json:
schema:
type: object
summary: Set tags for environment
parameters:
- description: Name of environment
in: path
name: name
required: true
schema:
type: string
x-sdk-interface: gitops-application.setTags
x-endpoint:
isEndpoint: false
auth:
middleware:
- auth.isAuthenticated
acl:
resource: gitops
postMiddleware:
- global.iseMiddleware
handler: argo.application.setTags
x-code-samples:
- lang: curl
source: "curl \\\n -X POST \\\n -H \"Authorization: ${API_KEY}\" \\\n -H 'Content-Type: application/json; charset=utf-8' \\\n -d \"${REQUEST_BODY_OBJ}\" \\\n \"https://g.codefresh.io/api/gitops/application/${NAME}/set/tags\""
- lang: node.js
source: sdk.gitops-application.setTags({ name }, { ...REQUEST_BODY_OBJ })
components:
securitySchemes:
API-key:
in: header
name: Authorization
description: 'An api key got from: User Settings -> API keys -> Generate'
type: apiKey
x-service-name: api-public
x-base-path: /api
x-internal-services:
- pipeline-manager
- api
x-endpoint-conditions:
- weight: 0
condition: global.has-general-service-role
handlerRegex: (.*)
- weight: 1
condition: global.has-kubernetes-endpoints-service-role
handlerRegex: kubernetes\.\w+
- weight: 2
condition: global.has-auth-service-role
handlerRegex: api-key\.\w+
x-tagGroups:
- name: Pipelines / Builds
tags:
- Annotations
- Builds
- Execution Contexts
- Images
- Pipelines
- Progress
- Projects
- Step-types
- Triggers
- Triggers Events
- Triggers Types
- name: Kubernetes / Helm
tags:
- Environments V2
- Helm Boards
- Helm Charts
- Helm Releases
- Helm Sections
- Kubernetes
- name: Swarm
tags:
- Compositions
- Environments
- name: Integrations / Contexts
tags:
- Clusters
- Contexts
- Helm Cluster Configs
- Helm Repos
- Registries
- Repos
- name: Account Management
tags:
- Abac
- Accounts
- Agents
- Audit
- Runtime Environments
- Teams
- Tokens
- Views
- name: User Properties
tags:
- favorites
- name: On-Premise
tags:
- Features
- Runtime Environments (Account)
- Runtime Environments (Plan)
- Runtime Environments (System)
- Runtime Environments.
- name: Platform Analytics
tags:
# --- truncated at 32 KB (136 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/codefresh/refs/heads/main/openapi/codefresh-gitops-application-api-openapi.yml