CanaryCD API 0.1.dev3
Continuous Deployment API for Container and Static Pages
License: Apache 2.0
Canary Config
GET /config
List Full Configuration
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No |
Response 200 OK
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Response 404 Not Found
PUT /config
Update Configuration
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"key": {
"type": "string",
"title": "Key",
"examples": [
"ROOT_KEY",
"SLACK_WEBHOOK",
"DISCORD_WEBHOOK",
"GITHUB_APP_ID",
"GITHUB_SECRET_FILE",
"GITHUB_WEBHOOK_SECRET"
]
},
"value": {
"type": "string",
"title": "Value",
"examples": [
"config-value"
]
}
},
"type": "object",
"required": [
"key",
"value"
],
"title": "ConfigUpdate"
}
Response 200 OK
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the response body
{
"properties": {
"key": {
"type": "string",
"title": "Key",
"examples": [
"ROOT_KEY",
"SLACK_WEBHOOK",
"DISCORD_WEBHOOK",
"GITHUB_APP_ID",
"GITHUB_SECRET_FILE",
"GITHUB_WEBHOOK_SECRET"
]
},
"value": {
"type": "string",
"title": "Value",
"examples": [
"config-value"
]
}
},
"type": "object",
"required": [
"key",
"value"
],
"title": "ConfigUpdate"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
DELETE /config/{key}
Delete Configuration
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
key |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Authentication
GET /auth
List all Authentication Keys
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
filter_by |
query | None | No | ||
limit |
query | integer | 100 | No | |
offset |
query | None | 0 | No | |
ordering |
query | None | updated_at | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
POST /auth
Create Authentication Key
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$"
},
{
"type": "null"
}
],
"title": "Name",
"examples": [
"example-name"
]
},
"auth_type": {
"type": "string",
"title": "Auth Type",
"examples": [
"ssh",
"pat",
"token"
]
},
"auth_key": {
"anyOf": [
{
"type": "string",
"pattern": ".*"
},
{
"type": "null"
}
],
"title": "Auth Key",
"examples": [
"ssh-private-key",
"ghp_1234"
]
}
},
"type": "object",
"required": [
"name",
"auth_type"
],
"title": "AuthCreate"
}
Response 201 Created
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"name": null,
"auth_type": "string",
"public_key": null
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$"
},
{
"type": "null"
}
],
"title": "Name",
"examples": [
"example-name"
]
},
"auth_type": {
"type": "string",
"title": "Auth Type",
"examples": [
"ssh"
]
},
"public_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Public Key",
"examples": [
"ssh-ed25519 AAAAC..lGM key"
]
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"name",
"auth_type",
"public_key"
],
"title": "AuthDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /auth/{name}
Get Authentication Key Details
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"name": null,
"auth_type": "string",
"public_key": null,
"project_count": 0
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$"
},
{
"type": "null"
}
],
"title": "Name",
"examples": [
"example-name"
]
},
"auth_type": {
"type": "string",
"title": "Auth Type",
"examples": [
"ssh"
]
},
"public_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Public Key",
"examples": [
"ssh-ed25519 AAAAC..lGM key"
]
},
"project_count": {
"type": "integer",
"title": "Project Count"
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"name",
"auth_type",
"public_key"
],
"title": "AuthDetailsCount"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
DELETE /auth/{name}
Delete Authentication Key
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Project
GET /project
List Projects
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
filter_by |
query | None | No | ||
limit |
query | integer | 100 | No | |
offset |
query | None | 0 | No | |
ordering |
query | None | updated_at | No |
Response 200 OK
[
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"id": "703ba94e-648d-4293-84f8-4d10f32c8681",
"name": "string",
"remote": null,
"branch": null,
"auth_id": null,
"key": null
}
]
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
POST /project
Create a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"remote": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?P<protocol>[https?|git|ssh]+:\\/\\/))?(?:(?P<login_user>[\\w\\d]+)@)?(?P<host>[\\w\\d.-]+)([:\\/])(?P<user>[\\w\\d-]+)(?:(?P<namespace>\\/[\\w\\d-]+))?/(?P<repo>[\\w\\d-]+)(?:\\.git)?(?:@(?P<branch>[\\w.\\-/]+))?$"
},
{
"type": "null"
}
],
"title": "Remote",
"examples": [
"git@github.com:user/repo.git",
"https://github.com/user/repo.git",
"git@gitlab.com:user/namespace/repo.git",
"https://gitlab.com/user/namespace/repo.git",
"ssh://git@example.com:2222/user/repo.git"
]
},
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Branch",
"examples": [
"main"
]
},
"key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key",
"examples": [
"key-name"
]
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$"
},
{
"type": "null"
}
],
"title": "Name",
"examples": [
"example-name"
]
}
},
"type": "object",
"required": [
"name"
],
"title": "ProjectCreate"
}
Response 201 Created
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"id": "62db3ccf-2e03-4a8c-81fb-6fdd4d5f0f39",
"name": "string",
"remote": null,
"branch": null,
"auth_id": null,
"key": null
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
},
"name": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$",
"title": "Name",
"examples": [
"example-name"
]
},
"remote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Remote",
"examples": [
"git@github.com:user/repo.git",
"https://github.com/user/repo.git",
"git@gitlab.com:user/namespace/repo.git",
"https://gitlab.com/user/namespace/repo.git",
"ssh://git@example.com:2222/user/repo.git"
]
},
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Branch",
"examples": [
"main"
]
},
"auth_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Auth Id"
},
"key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key",
"examples": [
"key-name"
]
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"id",
"name",
"auth_id"
],
"title": "ProjectDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /project/{name}
Get Project Details
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"id": "9657c005-03f7-4333-b41b-702ecfac2479",
"name": "string",
"remote": null,
"branch": null,
"auth_id": null,
"key": null
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
},
"name": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$",
"title": "Name",
"examples": [
"example-name"
]
},
"remote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Remote",
"examples": [
"git@github.com:user/repo.git",
"https://github.com/user/repo.git",
"git@gitlab.com:user/namespace/repo.git",
"https://gitlab.com/user/namespace/repo.git",
"ssh://git@example.com:2222/user/repo.git"
]
},
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Branch",
"examples": [
"main"
]
},
"auth_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Auth Id"
},
"key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key",
"examples": [
"key-name"
]
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"id",
"name",
"auth_id"
],
"title": "ProjectDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
PUT /project/{name}
Update a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"remote": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?P<protocol>[https?|git|ssh]+:\\/\\/))?(?:(?P<login_user>[\\w\\d]+)@)?(?P<host>[\\w\\d.-]+)([:\\/])(?P<user>[\\w\\d-]+)(?:(?P<namespace>\\/[\\w\\d-]+))?/(?P<repo>[\\w\\d-]+)(?:\\.git)?(?:@(?P<branch>[\\w.\\-/]+))?$"
},
{
"type": "null"
}
],
"title": "Remote",
"examples": [
"git@github.com:user/repo.git",
"https://github.com/user/repo.git",
"git@gitlab.com:user/namespace/repo.git",
"https://gitlab.com/user/namespace/repo.git",
"ssh://git@example.com:2222/user/repo.git"
]
},
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Branch",
"examples": [
"main"
]
},
"key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key",
"examples": [
"key-name"
]
}
},
"type": "object",
"title": "ProjectUpdate"
}
Response 200 OK
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"id": "9ea3ad3b-9119-457e-9471-08322c10c82e",
"name": "string",
"remote": null,
"branch": null,
"auth_id": null,
"key": null
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
},
"name": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[\\w-]+$",
"title": "Name",
"examples": [
"example-name"
]
},
"remote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Remote",
"examples": [
"git@github.com:user/repo.git",
"https://github.com/user/repo.git",
"git@gitlab.com:user/namespace/repo.git",
"https://gitlab.com/user/namespace/repo.git",
"ssh://git@example.com:2222/user/repo.git"
]
},
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Branch",
"examples": [
"main"
]
},
"auth_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Auth Id"
},
"key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key",
"examples": [
"key-name"
]
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"id",
"name",
"auth_id"
],
"title": "ProjectDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
DELETE /project/{name}
Delete a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /project/{name}/refresh-token
Refresh Deploy Token
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Secrets
GET /secret/{project}
List Secrets
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
limit |
query | integer | 100 | No | |
offset |
query | integer | 0 | No | |
project |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
PUT /secret/{project}
Update Secret
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
project |
path | string | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"key": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[A-Z0-9_]+$",
"title": "Key",
"examples": [
"HOST"
]
},
"value": {
"type": "string",
"maxLength": 1024,
"minLength": 1,
"title": "Value",
"examples": [
"example.com"
]
}
},
"type": "object",
"required": [
"key",
"value"
],
"title": "VariableUpdate"
}
Response 200 OK
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"key": "string",
"id": "57f17031-b810-4592-b909-5ad70477861d"
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"key": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[A-Z0-9_]+$",
"title": "Key",
"examples": [
"HOST"
]
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"key",
"id"
],
"title": "VariableDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
DELETE /secret/{project}/{variable}
Delete Secret
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
project |
path | string | No | ||
variable |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Page
GET /page
List all pages
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
filter_by |
query | None | No | ||
limit |
query | integer | 100 | No | |
offset |
query | None | 0 | No | |
ordering |
query | None | fqdn | No |
Response 200 OK
[
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"fqdn": "string",
"cors_hosts": null,
"id": "366eebe8-3eaf-4269-bce0-4a302f841753"
}
]
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
POST /page
Create a new page
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"fqdn": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Fqdn",
"examples": [
"example.com",
"www.example.com"
]
},
"cors_hosts": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cors Hosts"
}
},
"type": "object",
"required": [
"fqdn"
],
"title": "PageCreate"
}
Response 201 Created
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"fqdn": "string",
"cors_hosts": null,
"id": "8770f855-a8ee-4b32-9e7c-6791f57c8b2d"
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"fqdn": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Fqdn",
"examples": [
"example.com",
"www.example.com"
]
},
"cors_hosts": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cors Hosts"
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"fqdn",
"id"
],
"title": "PageDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /page/{fqdn}
Get Page Details
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
fqdn |
path | string | No |
Response 200 OK
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"fqdn": "string",
"cors_hosts": null,
"id": "4ab840e2-7d20-456b-b3df-777b053673d7"
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"fqdn": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Fqdn",
"examples": [
"example.com",
"www.example.com"
]
},
"cors_hosts": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cors Hosts"
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"fqdn",
"id"
],
"title": "PageDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
DELETE /page/{fqdn}
Page Delete
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
fqdn |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /page/{fqdn}/refresh-token
Page Deploy Key
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
fqdn |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Redirect
GET /redirect
List Redirects
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
limit |
query | integer | 100 | No | |
offset |
query | integer | 0 | No |
Response 200 OK
[
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"source": "string",
"destination": "string",
"id": "65ff0a89-caa0-40ee-a52f-5f327dc9a748"
}
]
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
POST /redirect
Create a new Redirect
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"source": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Source",
"examples": [
"www.example.com"
]
},
"destination": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Destination",
"examples": [
"example.com",
"www.example.com"
]
}
},
"type": "object",
"required": [
"source",
"destination"
],
"title": "RedirectCreate"
}
Response 201 Created
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"source": "string",
"destination": "string",
"id": "fa4c93c6-fabb-4955-b452-d30ba61f911f"
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"source": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Source",
"examples": [
"www.example.com"
]
},
"destination": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Destination",
"examples": [
"example.com",
"www.example.com"
]
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"source",
"destination",
"id"
],
"title": "RedirectDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
PUT /redirect/{fqdn}
Update a Redirect
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
fqdn |
path | string | No |
Request body
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Schema of the request body
{
"properties": {
"destination": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Destination",
"examples": [
"example.com",
"www.example.com"
]
}
},
"type": "object",
"required": [
"destination"
],
"title": "RedirectUpdate"
}
Response 200 OK
{
"created_at": "2022-04-13T15:42:05.901Z",
"updated_at": "2022-04-13T15:42:05.901Z",
"source": "string",
"destination": "string",
"id": "c5a54e40-2ad7-4e7e-8521-9cb179cba167"
}
Schema of the response body
{
"properties": {
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"examples": [
"1999-12-31T23:59:59.000Z"
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At",
"examples": [
"2000-01-01T00:00:00.000Z"
]
},
"source": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Source",
"examples": [
"www.example.com"
]
},
"destination": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"title": "Destination",
"examples": [
"example.com",
"www.example.com"
]
},
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
}
},
"type": "object",
"required": [
"created_at",
"updated_at",
"source",
"destination",
"id"
],
"title": "RedirectDetails"
}
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
DELETE /redirect/{fqdn}
Delete a Redirect
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
fqdn |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Deployment
GET /deploy/{name}/start
Deploy a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /deploy/{name}/stop
Stop a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
GET /deploy/{name}/status
Status of a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
name |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
POST /upload/{page}
Upload Page Payload
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
OAuth2PasswordBearer |
header | string | N/A | No | |
page |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
Webhooks
POST /webhook/project/{token}
Deploy a Project
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
token |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
POST /webhook/page/{token}
Upload Page Payload
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
token |
path | string | No |
Response 200 OK
Response 404 Not Found
Response 422 Unprocessable Content
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.
export
GET /export/traefik.json
traefik config provider
Response 200 OK
Response 404 Not Found
Schemas
AuthCreate
| Name | Type |
|---|---|
auth_key |
|
auth_type |
string |
name |
AuthDetails
| Name | Type |
|---|---|
auth_type |
string |
created_at |
string(date-time) |
name |
|
public_key |
|
updated_at |
string(date-time) |
AuthDetailsCount
| Name | Type |
|---|---|
auth_type |
string |
created_at |
string(date-time) |
name |
|
project_count |
integer |
public_key |
|
updated_at |
string(date-time) |
ConfigUpdate
| Name | Type |
|---|---|
key |
string |
value |
string |
HTTPValidationError
| Name | Type |
|---|---|
detail |
Array<ValidationError> |
PageCreate
| Name | Type |
|---|---|
cors_hosts |
|
fqdn |
string |
PageDetails
| Name | Type |
|---|---|
cors_hosts |
|
created_at |
string(date-time) |
fqdn |
string |
id |
string(uuid) |
updated_at |
string(date-time) |
ProjectCreate
| Name | Type |
|---|---|
branch |
|
key |
|
name |
|
remote |
ProjectDetails
| Name | Type |
|---|---|
auth_id |
|
branch |
|
created_at |
string(date-time) |
id |
string(uuid) |
key |
|
name |
string |
remote |
|
updated_at |
string(date-time) |
ProjectUpdate
| Name | Type |
|---|---|
branch |
|
key |
|
remote |
RedirectCreate
| Name | Type |
|---|---|
destination |
string |
source |
string |
RedirectDetails
| Name | Type |
|---|---|
created_at |
string(date-time) |
destination |
string |
id |
string(uuid) |
source |
string |
updated_at |
string(date-time) |
RedirectUpdate
| Name | Type |
|---|---|
destination |
string |
ValidationError
| Name | Type |
|---|---|
loc |
Array<> |
msg |
string |
type |
string |
VariableDetails
| Name | Type |
|---|---|
created_at |
string(date-time) |
id |
string(uuid) |
key |
string |
updated_at |
string(date-time) |
VariableUpdate
| Name | Type |
|---|---|
key |
string |
value |
string |
VariableValueDetails
| Name | Type |
|---|---|
created_at |
string(date-time) |
id |
string(uuid) |
key |
string |
updated_at |
string(date-time) |
value |
Security schemes
| Name | Type | Scheme | Description |
|---|---|---|---|
| OAuth2PasswordBearer | oauth2 |
Was this page helpful?