> AI tools were used to create this PR Removes deprecated AI provider configuration through environment variables, CLI flags, and YAML. Deletion includes indexed providers and legacy OpenAI, Anthropic, and Bedrock options under both AI Gateway and AI Bridge branding, eg. `CODER_AI_GATEWAY_PROVIDER_<N>_*` or `CODER_AI_GATEWAY_ANTHROPIC_KEY`. Removes the associated startup-seeding code. Updates tests and documentation. **Breaking change:** Remove [obsolete AI provider CLI flags and YAML keys](https://coder.com/docs/ai-coder/ai-gateway/providers#database-management-of-providers) before upgrading, otherwise Coder will fail to start with an `unknown flag` or `unknown option` error. Provider environment variables are ignored and no longer seed the database. Existing database-stored provider configuration is preserved.
969 lines
25 KiB
Markdown
Generated
969 lines
25 KiB
Markdown
Generated
---
|
|
# Code generated by make gen. DO NOT EDIT.
|
|
title: General
|
|
---
|
|
|
|
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
|
|
|
## API root handler
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/ \
|
|
-H 'Accept: application/json'
|
|
```
|
|
|
|
`GET /api/v2/`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"detail": "string",
|
|
"message": "string",
|
|
"validations": [
|
|
{
|
|
"detail": "string",
|
|
"field": "string"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|--------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.Response](schemas.md#codersdkresponse) |
|
|
|
|
## Build info
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/buildinfo \
|
|
-H 'Accept: application/json'
|
|
```
|
|
|
|
`GET /api/v2/buildinfo`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"agent_api_version": "string",
|
|
"dashboard_url": "string",
|
|
"deployment_id": "string",
|
|
"external_url": "string",
|
|
"provisioner_api_version": "string",
|
|
"telemetry": true,
|
|
"upgrade_message": "string",
|
|
"version": "string",
|
|
"webpush_public_key": "string",
|
|
"workspace_proxy": true
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|--------------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.BuildInfoResponse](schemas.md#codersdkbuildinforesponse) |
|
|
|
|
## Report CSP violations
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X POST http://coder-server:8080/api/v2/csp/reports \
|
|
-H 'Content-Type: application/json' \
|
|
-H 'Accept: */*' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`POST /api/v2/csp/reports`
|
|
|
|
> Body parameter
|
|
|
|
```json
|
|
{
|
|
"csp-report": {}
|
|
}
|
|
```
|
|
|
|
### Parameters
|
|
|
|
| Name | In | Type | Required | Description |
|
|
|--------|------|------------------------------------------------------|----------|------------------|
|
|
| `body` | body | [coderd.cspViolation](schemas.md#coderdcspviolation) | true | Violation report |
|
|
|
|
### Example responses
|
|
|
|
> 413 Response
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|-------------------------------------------------------------------------|-----------------------------|--------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | |
|
|
| 413 | [Payload Too Large](https://tools.ietf.org/html/rfc7231#section-6.5.11) | Request body exceeds 64 KiB | [codersdk.Response](schemas.md#codersdkresponse) |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## Get deployment config
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/deployment/config \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/deployment/config`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"config": {
|
|
"access_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
},
|
|
"additional_csp_policy": [
|
|
"string"
|
|
],
|
|
"address": {
|
|
"host": "string",
|
|
"port": "string"
|
|
},
|
|
"agent_fallback_troubleshooting_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
},
|
|
"agent_stat_refresh_interval": 0,
|
|
"ai": {
|
|
"aibridge_proxy": {
|
|
"allowed_private_cidrs": [
|
|
"string"
|
|
],
|
|
"api_dump_dir": "string",
|
|
"cert_file": "string",
|
|
"domain_allowlist": [
|
|
"string"
|
|
],
|
|
"enabled": true,
|
|
"key_file": "string",
|
|
"listen_addr": "string",
|
|
"target": "string",
|
|
"tls_cert_file": "string",
|
|
"tls_key_file": "string",
|
|
"upstream_proxy": "string",
|
|
"upstream_proxy_ca": "string"
|
|
},
|
|
"bridge": {
|
|
"allow_byok": true,
|
|
"api_dump_dir": "string",
|
|
"budget_period": "string",
|
|
"budget_policy": "string",
|
|
"circuit_breaker_enabled": true,
|
|
"circuit_breaker_failure_threshold": 0,
|
|
"circuit_breaker_interval": 0,
|
|
"circuit_breaker_max_requests": 0,
|
|
"circuit_breaker_timeout": 0,
|
|
"enabled": true,
|
|
"inject_coder_mcp_tools": true,
|
|
"max_concurrency": 0,
|
|
"rate_limit": 0,
|
|
"retention": 0,
|
|
"send_actor_headers": true,
|
|
"structured_logging": true
|
|
},
|
|
"chat": {
|
|
"acquire_batch_size": 0,
|
|
"debug_logging_enabled": true,
|
|
"hook_allow_insecure": true,
|
|
"hook_enabled": true,
|
|
"hook_secret": "string",
|
|
"hook_timeout": 0,
|
|
"hook_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
}
|
|
}
|
|
},
|
|
"allow_workspace_renames": true,
|
|
"autobuild_poll_interval": 0,
|
|
"browser_only": true,
|
|
"cache_directory": "string",
|
|
"cli_upgrade_message": "string",
|
|
"cluster": {
|
|
"host": "string"
|
|
},
|
|
"config": "string",
|
|
"config_ssh": {
|
|
"deploymentName": "string",
|
|
"sshconfigOptions": [
|
|
"string"
|
|
]
|
|
},
|
|
"dangerous": {
|
|
"allow_all_cors": true,
|
|
"allow_path_app_sharing": true,
|
|
"allow_path_app_site_owner_access": true
|
|
},
|
|
"derp": {
|
|
"config": {
|
|
"block_direct": true,
|
|
"force_websockets": true,
|
|
"path": "string",
|
|
"url": "string"
|
|
},
|
|
"server": {
|
|
"enable": true,
|
|
"region_code": "string",
|
|
"region_id": 0,
|
|
"region_name": "string",
|
|
"relay_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
},
|
|
"stun_addresses": [
|
|
"string"
|
|
]
|
|
}
|
|
},
|
|
"disable_chat_sharing": true,
|
|
"disable_owner_workspace_exec": true,
|
|
"disable_password_auth": true,
|
|
"disable_path_apps": true,
|
|
"disable_user_secret_file_path": true,
|
|
"disable_workspace_agent_context_sync": true,
|
|
"disable_workspace_sharing": true,
|
|
"docs_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
},
|
|
"enable_ai_tasks": true,
|
|
"enable_authz_recording": true,
|
|
"enable_terraform_debug_mode": true,
|
|
"ephemeral_deployment": true,
|
|
"experiments": [
|
|
"string"
|
|
],
|
|
"external_auth": {
|
|
"value": [
|
|
{
|
|
"api_base_url": "string",
|
|
"app_install_url": "string",
|
|
"app_installations_url": "string",
|
|
"auth_url": "string",
|
|
"client_id": "string",
|
|
"code_challenge_methods_supported": [
|
|
"string"
|
|
],
|
|
"device_code_url": "string",
|
|
"device_flow": true,
|
|
"display_icon": "string",
|
|
"display_name": "string",
|
|
"id": "string",
|
|
"mcp_tool_allow_regex": "string",
|
|
"mcp_tool_deny_regex": "string",
|
|
"mcp_url": "string",
|
|
"no_refresh": true,
|
|
"redirect_url": "string",
|
|
"regex": "string",
|
|
"revoke_url": "string",
|
|
"scopes": [
|
|
"string"
|
|
],
|
|
"token_url": "string",
|
|
"type": "string",
|
|
"validate_url": "string"
|
|
}
|
|
]
|
|
},
|
|
"external_auth_github_default_provider_enable": true,
|
|
"external_token_encryption_keys": [
|
|
"string"
|
|
],
|
|
"healthcheck": {
|
|
"refresh": 0,
|
|
"threshold_database": 0
|
|
},
|
|
"http_address": "string",
|
|
"http_cookies": {
|
|
"host_prefix": true,
|
|
"same_site": "string",
|
|
"secure_auth_cookie": true
|
|
},
|
|
"job_hang_detector_interval": 0,
|
|
"logging": {
|
|
"human": "string",
|
|
"json": "string",
|
|
"log_filter": [
|
|
"string"
|
|
],
|
|
"stackdriver": "string"
|
|
},
|
|
"mcp_allowed_private_cidrs": [
|
|
"string"
|
|
],
|
|
"metrics_cache_refresh_interval": 0,
|
|
"notifications": {
|
|
"dispatch_timeout": 0,
|
|
"email": {
|
|
"auth": {
|
|
"identity": "string",
|
|
"password": "string",
|
|
"password_file": "string",
|
|
"username": "string"
|
|
},
|
|
"force_tls": true,
|
|
"from": "string",
|
|
"hello": "string",
|
|
"smarthost": "string",
|
|
"tls": {
|
|
"ca_file": "string",
|
|
"cert_file": "string",
|
|
"insecure_skip_verify": true,
|
|
"key_file": "string",
|
|
"server_name": "string",
|
|
"start_tls": true
|
|
}
|
|
},
|
|
"fetch_interval": 0,
|
|
"inbox": {
|
|
"enabled": true
|
|
},
|
|
"lease_count": 0,
|
|
"lease_period": 0,
|
|
"max_send_attempts": 0,
|
|
"method": "string",
|
|
"retry_interval": 0,
|
|
"sync_buffer_size": 0,
|
|
"sync_interval": 0,
|
|
"webhook": {
|
|
"endpoint": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
}
|
|
}
|
|
},
|
|
"oauth2": {
|
|
"github": {
|
|
"allow_everyone": true,
|
|
"allow_signups": true,
|
|
"allowed_orgs": [
|
|
"string"
|
|
],
|
|
"allowed_teams": [
|
|
"string"
|
|
],
|
|
"client_id": "string",
|
|
"client_secret": "string",
|
|
"default_provider_enable": true,
|
|
"device_flow": true,
|
|
"enterprise_base_url": "string"
|
|
}
|
|
},
|
|
"oidc": {
|
|
"allow_signups": true,
|
|
"auth_url_params": {},
|
|
"auto_repair_links": true,
|
|
"client_cert_file": "string",
|
|
"client_id": "string",
|
|
"client_key_file": "string",
|
|
"client_secret": "string",
|
|
"email_domain": [
|
|
"string"
|
|
],
|
|
"email_fallback": true,
|
|
"email_field": "string",
|
|
"group_allow_list": [
|
|
"string"
|
|
],
|
|
"group_auto_create": true,
|
|
"group_mapping": {},
|
|
"group_regex_filter": {},
|
|
"groups_field": "string",
|
|
"icon_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
},
|
|
"ignore_email_verified": true,
|
|
"ignore_user_info": true,
|
|
"issuer_url": "string",
|
|
"name_field": "string",
|
|
"organization_assign_default": true,
|
|
"organization_field": "string",
|
|
"organization_mapping": {},
|
|
"redirect_allowed_hosts": [
|
|
"string"
|
|
],
|
|
"redirect_url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
},
|
|
"scopes": [
|
|
"string"
|
|
],
|
|
"sign_in_text": "string",
|
|
"signups_disabled_text": "string",
|
|
"skip_issuer_checks": true,
|
|
"source_user_info_from_access_token": true,
|
|
"user_role_field": "string",
|
|
"user_role_mapping": {},
|
|
"user_roles_default": [
|
|
"string"
|
|
],
|
|
"username_field": "string"
|
|
},
|
|
"pg_auth": "string",
|
|
"pg_conn_max_idle": "string",
|
|
"pg_conn_max_open": 0,
|
|
"pg_connection_url": "string",
|
|
"pprof": {
|
|
"address": {
|
|
"host": "string",
|
|
"port": "string"
|
|
},
|
|
"enable": true
|
|
},
|
|
"prometheus": {
|
|
"address": {
|
|
"host": "string",
|
|
"port": "string"
|
|
},
|
|
"aggregate_agent_stats_by": [
|
|
"string"
|
|
],
|
|
"collect_agent_stats": true,
|
|
"collect_db_metrics": true,
|
|
"enable": true
|
|
},
|
|
"provisioner": {
|
|
"daemon_poll_interval": 0,
|
|
"daemon_poll_jitter": 0,
|
|
"daemon_psk": "string",
|
|
"daemon_types": [
|
|
"string"
|
|
],
|
|
"daemons": 0,
|
|
"force_cancel_interval": 0
|
|
},
|
|
"proxy_health_status_interval": 0,
|
|
"proxy_trusted_headers": [
|
|
"string"
|
|
],
|
|
"proxy_trusted_origins": [
|
|
"string"
|
|
],
|
|
"rate_limit": {
|
|
"api": 0,
|
|
"disable_all": true
|
|
},
|
|
"redirect_to_access_url": true,
|
|
"retention": {
|
|
"api_keys": 0,
|
|
"audit_logs": 0,
|
|
"boundary_logs": 0,
|
|
"connection_logs": 0,
|
|
"workspace_agent_logs": 0
|
|
},
|
|
"scim_api_key": "string",
|
|
"scim_use_legacy": true,
|
|
"session_lifetime": {
|
|
"default_duration": 0,
|
|
"default_token_lifetime": 0,
|
|
"disable_expiry_refresh": true,
|
|
"max_admin_token_lifetime": 0,
|
|
"max_token_lifetime": 0,
|
|
"refresh_default_duration": 0
|
|
},
|
|
"ssh_keygen_algorithm": "string",
|
|
"stats_collection": {
|
|
"usage_stats": {
|
|
"enable": true
|
|
}
|
|
},
|
|
"strict_transport_security": 0,
|
|
"strict_transport_security_options": [
|
|
"string"
|
|
],
|
|
"support": {
|
|
"links": {
|
|
"value": [
|
|
{
|
|
"icon": "bug",
|
|
"location": "navbar",
|
|
"name": "string",
|
|
"target": "string"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"swagger": {
|
|
"enable": true
|
|
},
|
|
"telemetry": {
|
|
"enable": true,
|
|
"trace": true,
|
|
"url": {
|
|
"forceQuery": true,
|
|
"fragment": "string",
|
|
"host": "string",
|
|
"omitHost": true,
|
|
"opaque": "string",
|
|
"path": "string",
|
|
"rawFragment": "string",
|
|
"rawPath": "string",
|
|
"rawQuery": "string",
|
|
"scheme": "string",
|
|
"user": {}
|
|
}
|
|
},
|
|
"template_builder": {
|
|
"disabled": true,
|
|
"registry_url": "string"
|
|
},
|
|
"terms_of_service_url": "string",
|
|
"tls": {
|
|
"address": {
|
|
"host": "string",
|
|
"port": "string"
|
|
},
|
|
"allow_insecure_ciphers": true,
|
|
"cert_file": [
|
|
"string"
|
|
],
|
|
"client_auth": "string",
|
|
"client_ca_file": "string",
|
|
"client_cert_file": "string",
|
|
"client_key_file": "string",
|
|
"enable": true,
|
|
"key_file": [
|
|
"string"
|
|
],
|
|
"min_version": "string",
|
|
"redirect_http": true,
|
|
"supported_ciphers": [
|
|
"string"
|
|
]
|
|
},
|
|
"trace": {
|
|
"capture_logs": true,
|
|
"data_dog": true,
|
|
"enable": true,
|
|
"honeycomb_api_key": "string"
|
|
},
|
|
"update_check": true,
|
|
"user_quiet_hours_schedule": {
|
|
"allow_user_custom": true,
|
|
"default_schedule": "string"
|
|
},
|
|
"verbose": true,
|
|
"web_terminal_renderer": "string",
|
|
"wgtunnel_host": "string",
|
|
"wildcard_access_url": "string",
|
|
"workspace_hostname_suffix": "string",
|
|
"workspace_prebuilds": {
|
|
"failure_hard_limit": 0,
|
|
"reconciliation_backoff_interval": 0,
|
|
"reconciliation_backoff_lookback": 0,
|
|
"reconciliation_interval": 0
|
|
},
|
|
"write_config": true
|
|
},
|
|
"options": [
|
|
{
|
|
"annotations": {
|
|
"property1": "string",
|
|
"property2": "string"
|
|
},
|
|
"default": "string",
|
|
"description": "string",
|
|
"env": "string",
|
|
"flag": "string",
|
|
"flag_shorthand": "string",
|
|
"group": {
|
|
"description": "string",
|
|
"name": "string",
|
|
"parent": {
|
|
"description": "string",
|
|
"name": "string",
|
|
"parent": {},
|
|
"yaml": "string"
|
|
},
|
|
"yaml": "string"
|
|
},
|
|
"hidden": true,
|
|
"name": "string",
|
|
"required": true,
|
|
"use_instead": [
|
|
{}
|
|
],
|
|
"value": null,
|
|
"value_source": "",
|
|
"yaml": "string"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|------------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.DeploymentConfig](schemas.md#codersdkdeploymentconfig) |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## SSH Config
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/deployment/ssh \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/deployment/ssh`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"hostname_prefix": "string",
|
|
"hostname_suffix": "string",
|
|
"ssh_config_options": {
|
|
"property1": "string",
|
|
"property2": "string"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|--------------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.SSHConfigResponse](schemas.md#codersdksshconfigresponse) |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## Get deployment stats
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/deployment/stats \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/deployment/stats`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"aggregated_from": "2019-08-24T14:15:22Z",
|
|
"collected_at": "2019-08-24T14:15:22Z",
|
|
"next_update_at": "2019-08-24T14:15:22Z",
|
|
"session_count": {
|
|
"jetbrains": 0,
|
|
"reconnecting_pty": 0,
|
|
"ssh": 0,
|
|
"vscode": 0
|
|
},
|
|
"workspaces": {
|
|
"building": 0,
|
|
"connection_latency_ms": {
|
|
"p50": 0,
|
|
"p95": 0
|
|
},
|
|
"failed": 0,
|
|
"pending": 0,
|
|
"running": 0,
|
|
"rx_bytes": 0,
|
|
"stopped": 0,
|
|
"tx_bytes": 0
|
|
}
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|----------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.DeploymentStats](schemas.md#codersdkdeploymentstats) |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## Get user secrets capabilities
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/deployment/user-secrets/capabilities \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/deployment/user-secrets/capabilities`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"file_path_delivery_enabled": true
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|--------------------------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.UserSecretsCapabilities](schemas.md#codersdkusersecretscapabilities) |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## Get enabled experiments
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/experiments \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/experiments`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
[
|
|
"example"
|
|
]
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|---------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | array of [codersdk.Experiment](schemas.md#codersdkexperiment) |
|
|
|
|
<h3 id="get-enabled-experiments-responseschema">Response Schema</h3>
|
|
|
|
Status Code **200**
|
|
|
|
| Name | Type | Required | Restrictions | Description |
|
|
|----------------|-------|----------|--------------|-------------|
|
|
| `[array item]` | array | false | | |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## Get safe experiments
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/experiments/available \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/experiments/available`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
[
|
|
"example"
|
|
]
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|---------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | array of [codersdk.Experiment](schemas.md#codersdkexperiment) |
|
|
|
|
<h3 id="get-safe-experiments-responseschema">Response Schema</h3>
|
|
|
|
Status Code **200**
|
|
|
|
| Name | Type | Required | Restrictions | Description |
|
|
|----------------|-------|----------|--------------|-------------|
|
|
| `[array item]` | array | false | | |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|
|
|
|
## Update check
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/updatecheck \
|
|
-H 'Accept: application/json'
|
|
```
|
|
|
|
`GET /api/v2/updatecheck`
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"current": true,
|
|
"url": "string",
|
|
"version": "string"
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|------------------------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.UpdateCheckResponse](schemas.md#codersdkupdatecheckresponse) |
|
|
|
|
## Get token config
|
|
|
|
### Code samples
|
|
|
|
```sh
|
|
# Example request using curl
|
|
curl -X GET http://coder-server:8080/api/v2/users/{user}/keys/tokens/tokenconfig \
|
|
-H 'Accept: application/json' \
|
|
-H 'Coder-Session-Token: API_KEY'
|
|
```
|
|
|
|
`GET /api/v2/users/{user}/keys/tokens/tokenconfig`
|
|
|
|
### Parameters
|
|
|
|
| Name | In | Type | Required | Description |
|
|
|--------|------|--------|----------|----------------------|
|
|
| `user` | path | string | true | User ID, name, or me |
|
|
|
|
### Example responses
|
|
|
|
> 200 Response
|
|
|
|
```json
|
|
{
|
|
"max_token_lifetime": 0
|
|
}
|
|
```
|
|
|
|
### Responses
|
|
|
|
| Status | Meaning | Description | Schema |
|
|
|--------|---------------------------------------------------------|-------------|--------------------------------------------------------|
|
|
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [codersdk.TokenConfig](schemas.md#codersdktokenconfig) |
|
|
|
|
To perform this operation, you must be authenticated. [Learn more](authentication.md).
|