2023-06-30 19:02:44 +03:00
|
|
|
basePath: /api/v1
|
2023-07-05 14:25:31 +03:00
|
|
|
consumes:
|
|
|
|
|
- application/json
|
2023-06-30 19:02:44 +03:00
|
|
|
definitions:
|
|
|
|
|
APIErrorResponse:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: apiserver_params
|
|
|
|
|
package: github.com/cloudbase/garm/apiserver/params
|
|
|
|
|
type: APIErrorResponse
|
2023-08-12 22:41:00 +00:00
|
|
|
ControllerInfo:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: ControllerInfo
|
2023-07-18 20:38:34 +03:00
|
|
|
CreateEnterpriseParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: CreateEnterpriseParams
|
2023-07-10 17:30:59 +03:00
|
|
|
CreateOrgParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: CreateOrgParams
|
2023-07-05 13:20:01 +03:00
|
|
|
CreatePoolParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: CreatePoolParams
|
2023-06-30 19:02:44 +03:00
|
|
|
CreateRepoParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: CreateRepoParams
|
2023-07-10 17:30:59 +03:00
|
|
|
Credentials:
|
|
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/GithubCredentials'
|
|
|
|
|
type: array
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Credentials
|
2023-07-18 20:38:34 +03:00
|
|
|
Enterprise:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Enterprise
|
|
|
|
|
Enterprises:
|
|
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Enterprise'
|
|
|
|
|
type: array
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Enterprises
|
2023-07-10 17:30:59 +03:00
|
|
|
GithubCredentials:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: GithubCredentials
|
2023-08-16 09:11:45 +00:00
|
|
|
HookInfo:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: HookInfo
|
2023-08-15 17:19:06 +00:00
|
|
|
InstallWebhookParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: InstallWebhookParams
|
2023-07-05 13:20:01 +03:00
|
|
|
Instance:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Instance
|
|
|
|
|
Instances:
|
2023-07-10 17:30:59 +03:00
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Instance'
|
|
|
|
|
type: array
|
2023-07-05 13:20:01 +03:00
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Instances
|
2023-07-10 17:30:59 +03:00
|
|
|
JWTResponse:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: JWTResponse
|
2023-07-18 15:20:23 +03:00
|
|
|
Job:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Job
|
|
|
|
|
Jobs:
|
|
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Job'
|
|
|
|
|
type: array
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Jobs
|
2023-07-10 17:30:59 +03:00
|
|
|
NewUserParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: NewUserParams
|
|
|
|
|
Organization:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Organization
|
|
|
|
|
Organizations:
|
|
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Organization'
|
|
|
|
|
type: array
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Organizations
|
|
|
|
|
PasswordLoginParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: PasswordLoginParams
|
2023-07-05 13:20:01 +03:00
|
|
|
Pool:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Pool
|
|
|
|
|
Pools:
|
2023-07-10 17:30:59 +03:00
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
type: array
|
2023-07-05 13:20:01 +03:00
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Pools
|
2023-07-10 17:30:59 +03:00
|
|
|
Provider:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Provider
|
|
|
|
|
Providers:
|
|
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Provider'
|
|
|
|
|
type: array
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Providers
|
2023-06-30 19:02:44 +03:00
|
|
|
Repositories:
|
|
|
|
|
items:
|
|
|
|
|
$ref: '#/definitions/Repository'
|
|
|
|
|
type: array
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Repositories
|
|
|
|
|
Repository:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: Repository
|
2023-07-05 13:20:01 +03:00
|
|
|
UpdateEntityParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: UpdateEntityParams
|
|
|
|
|
UpdatePoolParams:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: UpdatePoolParams
|
2023-07-10 17:30:59 +03:00
|
|
|
User:
|
|
|
|
|
type: object
|
|
|
|
|
x-go-type:
|
|
|
|
|
import:
|
|
|
|
|
alias: garm_params
|
|
|
|
|
package: github.com/cloudbase/garm/params
|
|
|
|
|
type: User
|
2023-06-30 19:02:44 +03:00
|
|
|
info:
|
|
|
|
|
description: The Garm API generated using go-swagger.
|
|
|
|
|
license:
|
|
|
|
|
name: Apache 2.0
|
|
|
|
|
url: https://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
title: Garm API.
|
|
|
|
|
version: 1.0.0
|
|
|
|
|
paths:
|
2023-07-10 17:30:59 +03:00
|
|
|
/auth/login:
|
|
|
|
|
post:
|
|
|
|
|
operationId: Login
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Login information.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/PasswordLoginParams'
|
|
|
|
|
description: Login information.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: JWTResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/JWTResponse'
|
|
|
|
|
"400":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Logs in a user and returns a JWT token.
|
|
|
|
|
tags:
|
|
|
|
|
- login
|
2023-08-12 22:41:00 +00:00
|
|
|
/controller-info:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ControllerInfo
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: ControllerInfo
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/ControllerInfo'
|
|
|
|
|
"409":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get controller info.
|
|
|
|
|
tags:
|
|
|
|
|
- controllerInfo
|
2023-07-10 17:30:59 +03:00
|
|
|
/credentials:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListCredentials
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Credentials
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Credentials'
|
|
|
|
|
"400":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List all credentials.
|
|
|
|
|
tags:
|
|
|
|
|
- credentials
|
2023-07-18 20:38:34 +03:00
|
|
|
/enterprises:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListEnterprises
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Enterprises
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Enterprises'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List all enterprises.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
post:
|
|
|
|
|
operationId: CreateEnterprise
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Parameters used to create the enterprise.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/CreateEnterpriseParams'
|
|
|
|
|
description: Parameters used to create the enterprise.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Enterprise
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Enterprise'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Create enterprise with the given parameters.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
/enterprises/{enterpriseID}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeleteEnterprise
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the enterprise to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete enterprise by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetEnterprise
|
|
|
|
|
parameters:
|
|
|
|
|
- description: The ID of the enterprise to fetch.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Enterprise
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Enterprise'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get enterprise by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
put:
|
|
|
|
|
operationId: UpdateEnterprise
|
|
|
|
|
parameters:
|
|
|
|
|
- description: The ID of the enterprise to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
2023-07-22 22:42:57 +00:00
|
|
|
- description: Parameters used when updating the enterprise.
|
2023-07-18 20:38:34 +03:00
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdateEntityParams'
|
2023-07-22 22:42:57 +00:00
|
|
|
description: Parameters used when updating the enterprise.
|
2023-07-18 20:38:34 +03:00
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Enterprise
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Enterprise'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
2023-07-22 22:42:57 +00:00
|
|
|
summary: Update enterprise with the given parameters.
|
2023-07-18 20:38:34 +03:00
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
/enterprises/{enterpriseID}/instances:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListEnterpriseInstances
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Enterprise ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Instances
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Instances'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List enterprise instances.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
- instances
|
|
|
|
|
/enterprises/{enterpriseID}/pools:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListEnterprisePools
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Enterprise ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pools
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pools'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List enterprise pools.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
- pools
|
|
|
|
|
post:
|
|
|
|
|
operationId: CreateEnterprisePool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Enterprise ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when creating the enterprise pool.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/CreatePoolParams'
|
|
|
|
|
description: Parameters used when creating the enterprise pool.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Create enterprise pool with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
- pools
|
|
|
|
|
/enterprises/{enterpriseID}/pools/{poolID}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeleteEnterprisePool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Enterprise ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: ID of the enterprise pool to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete enterprise pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
- pools
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetEnterprisePool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Enterprise ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Pool ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get enterprise pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
- pools
|
|
|
|
|
put:
|
|
|
|
|
operationId: UpdateEnterprisePool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Enterprise ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: enterpriseID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: ID of the enterprise pool to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when updating the enterprise pool.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdatePoolParams'
|
|
|
|
|
description: Parameters used when updating the enterprise pool.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Update enterprise pool with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- enterprises
|
|
|
|
|
- pools
|
2023-07-10 17:30:59 +03:00
|
|
|
/first-run:
|
|
|
|
|
post:
|
|
|
|
|
operationId: FirstRun
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Create a new user.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/NewUserParams'
|
|
|
|
|
description: Create a new user.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: User
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/User'
|
|
|
|
|
"400":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Initialize the first run of the controller.
|
|
|
|
|
tags:
|
|
|
|
|
- first-run
|
2023-07-05 13:20:01 +03:00
|
|
|
/instances:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListInstances
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Instances
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Instances'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get all runners' instances.
|
|
|
|
|
tags:
|
|
|
|
|
- instances
|
|
|
|
|
/instances/{instanceName}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeleteInstance
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Runner instance name.
|
|
|
|
|
in: path
|
|
|
|
|
name: instanceName
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete runner instance by name.
|
|
|
|
|
tags:
|
|
|
|
|
- instances
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetInstance
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Runner instance name.
|
|
|
|
|
in: path
|
|
|
|
|
name: instanceName
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Instance
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Instance'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get runner instance by name.
|
|
|
|
|
tags:
|
|
|
|
|
- instances
|
2023-07-18 15:20:23 +03:00
|
|
|
/jobs:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListJobs
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Jobs
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Jobs'
|
|
|
|
|
"400":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List all jobs.
|
|
|
|
|
tags:
|
|
|
|
|
- jobs
|
|
|
|
|
/metrics-token:
|
|
|
|
|
get:
|
2023-07-18 18:48:01 +03:00
|
|
|
operationId: GetMetricsToken
|
2023-07-18 15:20:23 +03:00
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: JWTResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/JWTResponse'
|
|
|
|
|
"401":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Returns a JWT token that can be used to access the metrics endpoint.
|
|
|
|
|
tags:
|
|
|
|
|
- metrics-token
|
2023-07-10 17:30:59 +03:00
|
|
|
/organizations:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListOrgs
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Organizations
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Organizations'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List organizations.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
post:
|
|
|
|
|
operationId: CreateOrg
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Parameters used when creating the organization.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/CreateOrgParams'
|
|
|
|
|
description: Parameters used when creating the organization.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Organization
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Organization'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Create organization with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
/organizations/{orgID}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeleteOrg
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the organization to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete organization by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetOrg
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the organization to fetch.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Organization
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Organization'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get organization by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
put:
|
|
|
|
|
operationId: UpdateOrg
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the organization to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when updating the organization.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdateEntityParams'
|
|
|
|
|
description: Parameters used when updating the organization.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Organization
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Organization'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Update organization with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
/organizations/{orgID}/instances:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListOrgInstances
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Instances
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Instances'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List organization instances.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- instances
|
|
|
|
|
/organizations/{orgID}/pools:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListOrgPools
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pools
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pools'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List organization pools.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- pools
|
|
|
|
|
post:
|
|
|
|
|
operationId: CreateOrgPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when creating the organization pool.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/CreatePoolParams'
|
|
|
|
|
description: Parameters used when creating the organization pool.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Create organization pool with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- pools
|
|
|
|
|
/organizations/{orgID}/pools/{poolID}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeleteOrgPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: ID of the organization pool to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete organization pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- pools
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetOrgPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Pool ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get organization pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- pools
|
|
|
|
|
put:
|
|
|
|
|
operationId: UpdateOrgPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: ID of the organization pool to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when updating the organization pool.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdatePoolParams'
|
|
|
|
|
description: Parameters used when updating the organization pool.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Update organization pool with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- pools
|
2023-08-15 17:19:06 +00:00
|
|
|
/organizations/{orgID}/webhook:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: UninstallOrgWebhook
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Uninstall organization webhook.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- hooks
|
2023-08-16 09:11:45 +00:00
|
|
|
get:
|
|
|
|
|
operationId: GetOrgWebhookInfo
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: HookInfo
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/HookInfo'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get information about the GARM installed webhook on an organization.
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- hooks
|
2023-08-15 17:19:06 +00:00
|
|
|
post:
|
|
|
|
|
description: |-
|
|
|
|
|
Install the GARM webhook for an organization. The secret configured on the organization will
|
|
|
|
|
be used to validate the requests.
|
|
|
|
|
operationId: InstallOrgWebhook
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Organization ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: orgID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when creating the organization webhook.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/InstallWebhookParams'
|
|
|
|
|
description: Parameters used when creating the organization webhook.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
2023-08-16 09:11:45 +00:00
|
|
|
description: HookInfo
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/HookInfo'
|
2023-08-15 17:19:06 +00:00
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
tags:
|
|
|
|
|
- organizations
|
|
|
|
|
- hooks
|
2023-07-10 17:30:59 +03:00
|
|
|
/pools:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListPools
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pools
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pools'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List all pools.
|
|
|
|
|
tags:
|
|
|
|
|
- pools
|
|
|
|
|
/pools/{poolID}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeletePool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the pool to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- pools
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the pool to fetch.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- pools
|
|
|
|
|
put:
|
|
|
|
|
operationId: UpdatePool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the pool to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters to update the pool with.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdatePoolParams'
|
|
|
|
|
description: Parameters to update the pool with.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Update pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- pools
|
|
|
|
|
/pools/{poolID}/instances:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListPoolInstances
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Runner pool ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Instances
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Instances'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List runner instances in a pool.
|
|
|
|
|
tags:
|
|
|
|
|
- instances
|
|
|
|
|
/providers:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListProviders
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Providers
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Providers'
|
|
|
|
|
"400":
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List all providers.
|
|
|
|
|
tags:
|
|
|
|
|
- providers
|
2023-06-30 19:02:44 +03:00
|
|
|
/repositories:
|
|
|
|
|
get:
|
2023-07-05 13:20:01 +03:00
|
|
|
operationId: ListRepos
|
2023-06-30 19:02:44 +03:00
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Repositories
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Repositories'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List repositories.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
post:
|
2023-07-05 13:20:01 +03:00
|
|
|
operationId: CreateRepo
|
2023-06-30 19:02:44 +03:00
|
|
|
parameters:
|
|
|
|
|
- description: Parameters used when creating the repository.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/CreateRepoParams'
|
|
|
|
|
description: Parameters used when creating the repository.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Repository
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Repository'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Create repository with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
/repositories/{repoID}:
|
|
|
|
|
delete:
|
2023-07-05 13:20:01 +03:00
|
|
|
operationId: DeleteRepo
|
2023-06-30 19:02:44 +03:00
|
|
|
parameters:
|
|
|
|
|
- description: ID of the repository to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete repository by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
get:
|
2023-07-05 13:20:01 +03:00
|
|
|
operationId: GetRepo
|
2023-06-30 19:02:44 +03:00
|
|
|
parameters:
|
|
|
|
|
- description: ID of the repository to fetch.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Repository
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Repository'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get repository by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
2023-07-05 13:20:01 +03:00
|
|
|
put:
|
|
|
|
|
operationId: UpdateRepo
|
|
|
|
|
parameters:
|
|
|
|
|
- description: ID of the repository to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when updating the repository.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdateEntityParams'
|
|
|
|
|
description: Parameters used when updating the repository.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Repository
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Repository'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Update repository with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
/repositories/{repoID}/instances:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListRepoInstances
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Instances
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Instances'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List repository instances.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- instances
|
|
|
|
|
/repositories/{repoID}/pools:
|
|
|
|
|
get:
|
|
|
|
|
operationId: ListRepoPools
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pools
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pools'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: List repository pools.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- pools
|
|
|
|
|
post:
|
|
|
|
|
operationId: CreateRepoPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when creating the repository pool.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/CreatePoolParams'
|
|
|
|
|
description: Parameters used when creating the repository pool.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Create repository pool with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- pools
|
|
|
|
|
/repositories/{repoID}/pools/{poolID}:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: DeleteRepoPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: ID of the repository pool to delete.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Delete repository pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- pools
|
|
|
|
|
get:
|
|
|
|
|
operationId: GetRepoPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Pool ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get repository pool by ID.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- pools
|
|
|
|
|
put:
|
|
|
|
|
operationId: UpdateRepoPool
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: ID of the repository pool to update.
|
|
|
|
|
in: path
|
|
|
|
|
name: poolID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when updating the repository pool.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/UpdatePoolParams'
|
|
|
|
|
description: Parameters used when updating the repository pool.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: Pool
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/Pool'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Update repository pool with the parameters given.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- pools
|
2023-08-15 17:19:06 +00:00
|
|
|
/repositories/{repoID}/webhook:
|
|
|
|
|
delete:
|
|
|
|
|
operationId: UninstallRepoWebhook
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Uninstall organization webhook.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- hooks
|
2023-08-16 09:11:45 +00:00
|
|
|
get:
|
|
|
|
|
operationId: GetRepoWebhookInfo
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
|
|
|
|
description: HookInfo
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/HookInfo'
|
|
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
summary: Get information about the GARM installed webhook on a repository.
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- hooks
|
2023-08-15 17:19:06 +00:00
|
|
|
post:
|
|
|
|
|
description: |-
|
|
|
|
|
Install the GARM webhook for an organization. The secret configured on the organization will
|
|
|
|
|
be used to validate the requests.
|
|
|
|
|
operationId: InstallRepoWebhook
|
|
|
|
|
parameters:
|
|
|
|
|
- description: Repository ID.
|
|
|
|
|
in: path
|
|
|
|
|
name: repoID
|
|
|
|
|
required: true
|
|
|
|
|
type: string
|
|
|
|
|
- description: Parameters used when creating the repository webhook.
|
|
|
|
|
in: body
|
|
|
|
|
name: Body
|
|
|
|
|
required: true
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/InstallWebhookParams'
|
|
|
|
|
description: Parameters used when creating the repository webhook.
|
|
|
|
|
type: object
|
|
|
|
|
responses:
|
|
|
|
|
"200":
|
2023-08-16 09:11:45 +00:00
|
|
|
description: HookInfo
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/HookInfo'
|
2023-08-15 17:19:06 +00:00
|
|
|
default:
|
|
|
|
|
description: APIErrorResponse
|
|
|
|
|
schema:
|
|
|
|
|
$ref: '#/definitions/APIErrorResponse'
|
|
|
|
|
tags:
|
|
|
|
|
- repositories
|
|
|
|
|
- hooks
|
2023-07-05 14:25:31 +03:00
|
|
|
produces:
|
|
|
|
|
- application/json
|
|
|
|
|
security:
|
|
|
|
|
- Bearer: []
|
|
|
|
|
securityDefinitions:
|
|
|
|
|
Bearer:
|
|
|
|
|
description: 'The token with the `Bearer: ` prefix, e.g. "Bearer abcde12345".'
|
|
|
|
|
in: header
|
|
|
|
|
name: Authorization
|
|
|
|
|
type: apiKey
|
2023-06-30 19:02:44 +03:00
|
|
|
swagger: "2.0"
|
