Application
/gitops/v1/project/{project}/applications
get List applications in a project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
200ApplicationList: success
post Create applications in a project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
201Application: success
ApplicationList
apiVersion:stringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
items:[]Applicationkind:stringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata: ListMetaListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.
Application
apiVersion:stringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind:stringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata: ObjectMetaObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
operation: Operationspec: ApplicationSpecstatus: ApplicationStatus
Operation
info:[]InfoinitiatedBy: OperationInitiatorretry: RetryStrategysync: SyncOperation
Info
name:stringvalue:string
OperationInitiator
automated:booleanusername:string
RetryStrategy
backoff: Backofflimit:integer
Backoff
duration:stringfactor:integermaxDuration:string
SyncOperation
autoHealAttemptsCount:integerdryRun:booleanmanifests:[]stringprune:booleanresources:[]SyncOperationResourcerevision:stringrevisions:[]stringsource: ApplicationSourcesources:[]ApplicationSourcesyncOptions:[]stringsyncStrategy: SyncStrategy
SyncOperationResource
group:stringkind:stringname:stringnamespace:string
ApplicationSource
chart:stringdirectory: ApplicationSourceDirectoryhelm: ApplicationSourceHelmkustomize: ApplicationSourceKustomizename:stringpath:stringplugin: ApplicationSourcePluginref:stringrepoURL:stringtargetRevision:string
ApplicationSourceDirectory
exclude:stringinclude:stringjsonnet: ApplicationSourceJsonnetrecurse:boolean
ApplicationSourceJsonnet
extVars:[]JsonnetVarlibs:[]stringtlas:[]JsonnetVar
JsonnetVar
code:booleanname:stringvalue:string
ApplicationSourceHelm
apiVersions:[]stringfileParameters:[]HelmFileParameterignoreMissingValueFiles:booleankubeVersion:stringnamespace:stringparameters:[]HelmParameterpassCredentials:booleanreleaseName:stringskipCrds:booleanskipSchemaValidation:booleanskipTests:booleanvalueFiles:[]stringvalues:stringvaluesObject:stringversion:string
HelmFileParameter
name:stringpath:string
HelmParameter
forceString:booleanname:stringvalue:string
ApplicationSourceKustomize
apiVersions:[]stringcommonAnnotations:map[string]stringcommonAnnotationsEnvsubst:booleancommonLabels:map[string]stringcomponents:[]stringforceCommonAnnotations:booleanforceCommonLabels:booleanimages:[]stringkubeVersion:stringlabelWithoutSelector:booleannamePrefix:stringnameSuffix:stringnamespace:stringpatches:[]KustomizePatchreplicas:[]KustomizeReplicaversion:string
KustomizePatch
options:map[string]booleanpatch:stringpath:stringtarget: KustomizeSelector
KustomizeSelector
annotationSelector:stringgroup:stringkind:stringlabelSelector:stringname:stringnamespace:stringversion:string
KustomizeReplica
count:stringname:string
ApplicationSourcePlugin
env:[]EnvEntryname:stringparameters:[]ApplicationSourcePluginParameter
EnvEntry
name:stringvalue:string
ApplicationSourcePluginParameter
OptionalArray: OptionalArrayOptionalMap: OptionalMapname:stringstring:string
OptionalArray
array:[]string
OptionalMap
map:map[string]string
SyncStrategy
apply: SyncStrategyApplyhook: SyncStrategyHook
SyncStrategyApply
force:boolean
SyncStrategyHook
force:boolean
ApplicationSpec
destination: ApplicationDestinationignoreDifferences:[]ResourceIgnoreDifferencesinfo:[]Infoproject:stringrevisionHistoryLimit:integersource: ApplicationSourcesourceHydrator: SourceHydratorsources:[]ApplicationSourcesyncPolicy: SyncPolicy
ApplicationDestination
name:stringnamespace:stringserver:string
ResourceIgnoreDifferences
group:stringjqPathExpressions:[]stringjsonPointers:[]stringkind:stringmanagedFieldsManagers:[]stringname:stringnamespace:string
SourceHydrator
drySource: DrySourcehydrateTo: HydrateTosyncSource: SyncSource
DrySource
path:stringrepoURL:stringtargetRevision:string
HydrateTo
targetBranch:string
SyncSource
path:stringtargetBranch:string
SyncPolicy
automated: SyncPolicyAutomatedmanagedNamespaceMetadata: ManagedNamespaceMetadataretry: RetryStrategysyncOptions:[]string
SyncPolicyAutomated
allowEmpty:booleanprune:booleanselfHeal:boolean
ManagedNamespaceMetadata
annotations:map[string]stringlabels:map[string]string
ApplicationStatus
conditions:[]ApplicationConditioncontrollerNamespace:stringhealth: HealthStatushistory:[]RevisionHistoryobservedAt:stringoperationState: OperationStatereconciledAt:stringresourceHealthSource:stringresources:[]ResourceStatussourceHydrator: SourceHydratorStatussourceType:stringsourceTypes:[]stringsummary: ApplicationSummarysync: SyncStatus
ApplicationCondition
lastTransitionTime:stringmessage:stringtype:string
HealthStatus
lastTransitionTime:stringmessage:stringstatus:string
RevisionHistory
deployStartedAt:stringdeployedAt:stringid:integerinitiatedBy: OperationInitiatorrevision:stringrevisions:[]stringsource: ApplicationSourcesources:[]ApplicationSource
OperationState
finishedAt:stringmessage:stringoperation: Operationphase:stringretryCount:integerstartedAt:stringsyncResult: SyncOperationResult
SyncOperationResult
managedNamespaceMetadata: ManagedNamespaceMetadataresources:[]ResourceResultrevision:stringrevisions:[]stringsource: ApplicationSourcesources:[]ApplicationSource
ResourceResult
group:stringhookPhase:stringhookType:stringkind:stringmessage:stringname:stringnamespace:stringstatus:stringsyncPhase:stringversion:string
ResourceStatus
group:stringhealth: HealthStatushook:booleankind:stringname:stringnamespace:stringrequiresDeletionConfirmation:booleanrequiresPruning:booleanstatus:stringsyncWave:integerversion:string
SourceHydratorStatus
currentOperation: HydrateOperationlastSuccessfulOperation: SuccessfulHydrateOperation
HydrateOperation
drySHA:stringfinishedAt:stringhydratedSHA:stringmessage:stringphase:stringsourceHydrator: SourceHydratorstartedAt:string
SuccessfulHydrateOperation
drySHA:stringhydratedSHA:stringsourceHydrator: SourceHydrator
ApplicationSummary
externalURLs:[]stringimages:[]string
SyncStatus
comparedTo: ComparedTorevision:stringrevisions:[]stringstatus:string
ComparedTo
destination: ApplicationDestinationignoreDifferences:[]ResourceIgnoreDifferencessource: ApplicationSourcesources:[]ApplicationSource
ListMeta
ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.
continue:stringcontinue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.
remainingItemCount:integerremainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is estimating the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.
resourceVersion:stringString that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
selfLink:stringDeprecated: selfLink is a legacy read-only field that is no longer populated by the system.
/gitops/v1/project/{project}/applications/{name}
get Get an application in a project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
200Application: success
put Update an application in a project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
200Application: success
delete Delete an application in an project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
204: success
Application
apiVersion:stringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind:stringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata: ObjectMetaObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
operation: Operationspec: ApplicationSpecstatus: ApplicationStatus
Operation
info:[]InfoinitiatedBy: OperationInitiatorretry: RetryStrategysync: SyncOperation
Info
name:stringvalue:string
OperationInitiator
automated:booleanusername:string
RetryStrategy
backoff: Backofflimit:integer
Backoff
duration:stringfactor:integermaxDuration:string
SyncOperation
autoHealAttemptsCount:integerdryRun:booleanmanifests:[]stringprune:booleanresources:[]SyncOperationResourcerevision:stringrevisions:[]stringsource: ApplicationSourcesources:[]ApplicationSourcesyncOptions:[]stringsyncStrategy: SyncStrategy
SyncOperationResource
group:stringkind:stringname:stringnamespace:string
ApplicationSource
chart:stringdirectory: ApplicationSourceDirectoryhelm: ApplicationSourceHelmkustomize: ApplicationSourceKustomizename:stringpath:stringplugin: ApplicationSourcePluginref:stringrepoURL:stringtargetRevision:string
ApplicationSourceDirectory
exclude:stringinclude:stringjsonnet: ApplicationSourceJsonnetrecurse:boolean
ApplicationSourceJsonnet
extVars:[]JsonnetVarlibs:[]stringtlas:[]JsonnetVar
JsonnetVar
code:booleanname:stringvalue:string
ApplicationSourceHelm
apiVersions:[]stringfileParameters:[]HelmFileParameterignoreMissingValueFiles:booleankubeVersion:stringnamespace:stringparameters:[]HelmParameterpassCredentials:booleanreleaseName:stringskipCrds:booleanskipSchemaValidation:booleanskipTests:booleanvalueFiles:[]stringvalues:stringvaluesObject:stringversion:string
HelmFileParameter
name:stringpath:string
HelmParameter
forceString:booleanname:stringvalue:string
ApplicationSourceKustomize
apiVersions:[]stringcommonAnnotations:map[string]stringcommonAnnotationsEnvsubst:booleancommonLabels:map[string]stringcomponents:[]stringforceCommonAnnotations:booleanforceCommonLabels:booleanimages:[]stringkubeVersion:stringlabelWithoutSelector:booleannamePrefix:stringnameSuffix:stringnamespace:stringpatches:[]KustomizePatchreplicas:[]KustomizeReplicaversion:string
KustomizePatch
options:map[string]booleanpatch:stringpath:stringtarget: KustomizeSelector
KustomizeSelector
annotationSelector:stringgroup:stringkind:stringlabelSelector:stringname:stringnamespace:stringversion:string
KustomizeReplica
count:stringname:string
ApplicationSourcePlugin
env:[]EnvEntryname:stringparameters:[]ApplicationSourcePluginParameter
EnvEntry
name:stringvalue:string
ApplicationSourcePluginParameter
OptionalArray: OptionalArrayOptionalMap: OptionalMapname:stringstring:string
OptionalArray
array:[]string
OptionalMap
map:map[string]string
SyncStrategy
apply: SyncStrategyApplyhook: SyncStrategyHook
SyncStrategyApply
force:boolean
SyncStrategyHook
force:boolean
ApplicationSpec
destination: ApplicationDestinationignoreDifferences:[]ResourceIgnoreDifferencesinfo:[]Infoproject:stringrevisionHistoryLimit:integersource: ApplicationSourcesourceHydrator: SourceHydratorsources:[]ApplicationSourcesyncPolicy: SyncPolicy
ApplicationDestination
name:stringnamespace:stringserver:string
ResourceIgnoreDifferences
group:stringjqPathExpressions:[]stringjsonPointers:[]stringkind:stringmanagedFieldsManagers:[]stringname:stringnamespace:string
SourceHydrator
drySource: DrySourcehydrateTo: HydrateTosyncSource: SyncSource
DrySource
path:stringrepoURL:stringtargetRevision:string
HydrateTo
targetBranch:string
SyncSource
path:stringtargetBranch:string
SyncPolicy
automated: SyncPolicyAutomatedmanagedNamespaceMetadata: ManagedNamespaceMetadataretry: RetryStrategysyncOptions:[]string
SyncPolicyAutomated
allowEmpty:booleanprune:booleanselfHeal:boolean
ManagedNamespaceMetadata
annotations:map[string]stringlabels:map[string]string
ApplicationStatus
conditions:[]ApplicationConditioncontrollerNamespace:stringhealth: HealthStatushistory:[]RevisionHistoryobservedAt:stringoperationState: OperationStatereconciledAt:stringresourceHealthSource:stringresources:[]ResourceStatussourceHydrator: SourceHydratorStatussourceType:stringsourceTypes:[]stringsummary: ApplicationSummarysync: SyncStatus
ApplicationCondition
lastTransitionTime:stringmessage:stringtype:string
HealthStatus
lastTransitionTime:stringmessage:stringstatus:string
RevisionHistory
deployStartedAt:stringdeployedAt:stringid:integerinitiatedBy: OperationInitiatorrevision:stringrevisions:[]stringsource: ApplicationSourcesources:[]ApplicationSource
OperationState
finishedAt:stringmessage:stringoperation: Operationphase:stringretryCount:integerstartedAt:stringsyncResult: SyncOperationResult
SyncOperationResult
managedNamespaceMetadata: ManagedNamespaceMetadataresources:[]ResourceResultrevision:stringrevisions:[]stringsource: ApplicationSourcesources:[]ApplicationSource
ResourceResult
group:stringhookPhase:stringhookType:stringkind:stringmessage:stringname:stringnamespace:stringstatus:stringsyncPhase:stringversion:string
ResourceStatus
group:stringhealth: HealthStatushook:booleankind:stringname:stringnamespace:stringrequiresDeletionConfirmation:booleanrequiresPruning:booleanstatus:stringsyncWave:integerversion:string
SourceHydratorStatus
currentOperation: HydrateOperationlastSuccessfulOperation: SuccessfulHydrateOperation
HydrateOperation
drySHA:stringfinishedAt:stringhydratedSHA:stringmessage:stringphase:stringsourceHydrator: SourceHydratorstartedAt:string
SuccessfulHydrateOperation
drySHA:stringhydratedSHA:stringsourceHydrator: SourceHydrator
ApplicationSummary
externalURLs:[]stringimages:[]string
SyncStatus
comparedTo: ComparedTorevision:stringrevisions:[]stringstatus:string
ComparedTo
destination: ApplicationDestinationignoreDifferences:[]ResourceIgnoreDifferencessource: ApplicationSourcesources:[]ApplicationSource
/gitops/v1/project/{project}/applications/{name}/events
get Query events of an applications
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
start_time(in query):stringstart time
end_time(in query):stringend time
reason(in query):stringreason
kind(in query):stringkind
name(in query):stringname
event_type(in query):stringevent type
pageno(in query):integerpage number
size(in query):sizesize
Response
200: success
/gitops/v1/project/{project}/applications/{name}/refresh
post Refresh application in an project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
204: success
/gitops/v1/project/{project}/applications/{name}/sync
post Sync resources of application in an project
Parameters
Authorization(in header):stringGiven Bearer token will use this as authorization for the API
project(in path):stringrequiredproject name
name(in path):stringrequiredapp name
Response
204: success