Codefresh Favorites API
The favorites API from Codefresh — 3 operation(s) for favorites.
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-favorites-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 Favorites 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: Favorites
paths:
/favorites:
post:
responses:
'200':
content:
application/json:
schema:
properties:
n:
example: 2
type: integer
ok:
example: 1
type: integer
type: object
description: Result of deleting
'500':
content:
application/json:
schema:
properties:
message:
type: string
status:
example: Error
type: string
type: object
description: Error
tags:
- Favorites
operationId: favorites-create
requestBody:
content:
application/json:
schema:
properties:
entities:
type: string
type:
enum:
- repo
- pipeline-branch
- step-type
type: string
type: object
required: true
summary: Create
parameters: []
x-sdk-interface: favorites.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 \"{\\\"entities\\\":\\\"${ENTITIES_STR}\\\",\\\"type\\\":\\\"${TYPE_STR}\\\"}\" \\\n \"https://g.codefresh.io/api/favorites\""
- lang: node.js
source: "sdk.favorites.create({\n entities: `${ENTITIES_STR}`,\n type: `${TYPE_STR}`\n})"
delete:
responses:
'200':
content:
application/json:
schema:
properties:
n:
example: 2
type: integer
ok:
example: 1
type: integer
type: object
description: Result of deleting
'500':
content:
application/json:
schema:
properties:
message:
type: string
status:
example: Error
type: string
type: object
description: Error
tags:
- Favorites
operationId: favorites-delete
summary: Delete favorite entities
parameters: []
requestBody:
content:
application/json:
schema:
properties:
entities:
type: string
type:
enum:
- repo
- pipeline-branch
- step-type
type: string
type: object
required: true
x-sdk-interface: favorites.delete
x-code-samples:
- lang: curl
source: "curl \\\n -X DELETE \\\n -H \"Authorization: ${API_KEY}\" \\\n -H 'Content-Type: application/json; charset=utf-8' \\\n -d \"{\\\"entities\\\":\\\"${ENTITIES_STR}\\\",\\\"type\\\":\\\"${TYPE_STR}\\\"}\" \\\n \"https://g.codefresh.io/api/favorites\""
- lang: node.js
source: "sdk.favorites.delete({\n entities: `${ENTITIES_STR}`,\n type: `${TYPE_STR}`\n})"
/favorites/{type}:
get:
responses:
'200':
content:
application/json:
schema:
items:
properties:
__v:
type: number
_id:
type: string
accountId:
type: string
userId:
type: string
type:
enum:
- repo
- pipeline-branch
- step-type
type: string
data:
type: object
entities:
items:
type: string
type: array
type: object
type: array
description: Array of Favorites objects
'500':
content:
application/json:
schema:
properties:
message:
type: string
status:
example: Error
type: string
type: object
description: Error
tags:
- Favorites
operationId: favorites-list
summary: List
parameters:
- description: Entity type
in: path
name: type
required: true
schema:
enum:
- repo
- pipeline-branch
- step-type
type: string
x-sdk-interface: favorites.list
x-code-samples:
- lang: curl
source: "curl \\\n -X GET \\\n -H \"Authorization: ${API_KEY}\" \\\n \"https://g.codefresh.io/api/favorites/${TYPE}\""
- lang: node.js
source: sdk.favorites.list({ type })
/favorites/type/{type}/entity/{entityId}:
get:
responses:
'200':
content:
application/json:
schema:
items:
properties:
__v:
type: number
_id:
type: string
accountId:
type: string
userId:
type: string
type:
enum:
- repo
- pipeline-branch
- step-type
type: string
data:
type: object
entities:
items:
type: string
type: array
type: object
type: array
description: Array of Favorites objects
'500':
content:
application/json:
schema:
properties:
message:
type: string
status:
example: Error
type: string
type: object
description: Error
tags:
- Favorites
operationId: favorites-getById
summary: getById
parameters:
- description: Entity type
in: path
name: type
required: true
schema:
enum:
- repo
- pipeline-branch
- step-type
type: string
- description: Entity id
in: path
name: entityId
required: true
schema:
type: string
x-sdk-interface: favorites.getById
x-code-samples:
- lang: curl
source: "curl \\\n -X GET \\\n -H \"Authorization: ${API_KEY}\" \\\n \"https://g.codefresh.io/api/favorites/type/${TYPE}/entity/${ENTITY_ID}\""
- lang: node.js
source: sdk.favorites.getById({ type, entityId })
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 (134 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/codefresh/refs/heads/main/openapi/codefresh-favorites-api-openapi.yml