coder/docs/reference/api/schemas.md

Schemas

agentsdk.AWSInstanceIdentityToken

{
  "agent_name": "string",
  "document": "string",
  "signature": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false		Agent name optionally selects a specific agent when multiple agents share the same instance identity. An empty string is treated as unspecified.
document	string	true
signature	string	true

agentsdk.AuthenticateResponse

{
  "session_token": "string"
}

Properties

Name	Type	Required	Restrictions	Description
session_token	string	false

agentsdk.AzureInstanceIdentityToken

{
  "agent_name": "string",
  "encoding": "string",
  "signature": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false		Agent name optionally selects a specific agent when multiple agents share the same instance identity. An empty string is treated as unspecified.
encoding	string	true
signature	string	true

agentsdk.ExternalAuthResponse

{
  "access_token": "string",
  "password": "string",
  "token_extra": {},
  "type": "string",
  "url": "string",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
access_token	string	false
password	string	false
token_extra	object	false
type	string	false
url	string	false
username	string	false		Deprecated: Only supported on /workspaceagents/me/gitauth for backwards compatibility.

agentsdk.GitSSHKey

{
  "private_key": "string",
  "public_key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
private_key	string	false
public_key	string	false

agentsdk.GoogleInstanceIdentityToken

{
  "agent_name": "string",
  "json_web_token": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false		Agent name optionally selects a specific agent when multiple agents share the same instance identity. An empty string is treated as unspecified.
json_web_token	string	true

agentsdk.Log

{
  "created_at": "string",
  "level": "trace",
  "output": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
level	codersdk.LogLevel	false
output	string	false

agentsdk.PatchAppStatus

{
  "app_slug": "string",
  "icon": "string",
  "message": "string",
  "needs_user_attention": true,
  "state": "working",
  "uri": "string"
}

Properties

Name	Type	Required	Restrictions	Description
app_slug	string	false
icon	string	false		Deprecated: this field is unused and will be removed in a future version.
message	string	false
needs_user_attention	boolean	false		Deprecated: this field is unused and will be removed in a future version.
state	codersdk.WorkspaceAppStatusState	false
uri	string	false

agentsdk.PatchLogs

{
  "log_source_id": "string",
  "logs": [
    {
      "created_at": "string",
      "level": "trace",
      "output": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
log_source_id	string	false
logs	array of agentsdk.Log	false

agentsdk.PostLogSourceRequest

{
  "display_name": "string",
  "icon": "string",
  "id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
icon	string	false
id	string	false		ID is a unique identifier for the log source. It is scoped to a workspace agent, and can be statically defined inside code to prevent duplicate sources from being created for the same agent.

agentsdk.ReinitializationEvent

{
  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
  "reason": "prebuild_claimed",
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}

Properties

Name	Type	Required	Restrictions	Description
owner_id	string	false
reason	agentsdk.ReinitializationReason	false
workspace_id	string	false

agentsdk.ReinitializationReason

"prebuild_claimed"

Properties

Enumerated Values

Value(s)
prebuild_claimed

coderd.cspViolation

{
  "csp-report": {}
}

Properties

Name	Type	Required	Restrictions	Description
csp-report	object	false

codersdk.ACLAvailable

{
  "groups": [
    {
      "avatar_url": "http://example.com",
      "display_name": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "members": [
        {
          "avatar_url": "http://example.com",
          "created_at": "2019-08-24T14:15:22Z",
          "email": "user@example.com",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "is_service_account": true,
          "last_seen_at": "2019-08-24T14:15:22Z",
          "login_type": "",
          "name": "string",
          "status": "active",
          "theme_preference": "string",
          "updated_at": "2019-08-24T14:15:22Z",
          "username": "string"
        }
      ],
      "name": "string",
      "organization_display_name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "organization_name": "string",
      "quota_allowance": 0,
      "source": "user",
      "total_member_count": 0
    }
  ],
  "users": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
groups	array of codersdk.Group	false
users	array of codersdk.ReducedUser	false

codersdk.AIBridgeAgenticAction

{
  "model": "string",
  "thinking": [
    {
      "text": "string"
    }
  ],
  "token_usage": {
    "cache_read_input_tokens": 0,
    "cache_write_input_tokens": 0,
    "input_tokens": 0,
    "metadata": {
      "property1": null,
      "property2": null
    },
    "output_tokens": 0
  },
  "tool_calls": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "injected": true,
      "input": "string",
      "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
      "metadata": {
        "property1": null,
        "property2": null
      },
      "provider_response_id": "string",
      "server_url": "string",
      "tool": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
model	string	false
thinking	array of codersdk.AIBridgeModelThought	false
token_usage	codersdk.AIBridgeSessionThreadsTokenUsage	false
tool_calls	array of codersdk.AIBridgeToolCall	false

codersdk.AIBridgeAnthropicConfig

{
  "base_url": "string",
  "key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
base_url	string	false
key	string	false

codersdk.AIBridgeBedrockConfig

{
  "access_key": "string",
  "access_key_secret": "string",
  "base_url": "string",
  "model": "string",
  "region": "string",
  "small_fast_model": "string"
}

Properties

Name	Type	Required	Restrictions	Description
access_key	string	false
access_key_secret	string	false
base_url	string	false
model	string	false
region	string	false
small_fast_model	string	false

codersdk.AIBridgeConfig

{
  "allow_byok": true,
  "anthropic": {
    "base_url": "string",
    "key": "string"
  },
  "api_dump_dir": "string",
  "bedrock": {
    "access_key": "string",
    "access_key_secret": "string",
    "base_url": "string",
    "model": "string",
    "region": "string",
    "small_fast_model": "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,
  "openai": {
    "base_url": "string",
    "key": "string"
  },
  "providers": [
    {
      "base_url": "string",
      "bedrock_model": "string",
      "bedrock_region": "string",
      "bedrock_small_fast_model": "string",
      "name": "string",
      "type": "string"
    }
  ],
  "rate_limit": 0,
  "retention": 0,
  "send_actor_headers": true,
  "structured_logging": true
}

Properties

Name	Type	Required	Restrictions	Description
allow_byok	boolean	false
anthropic	codersdk.AIBridgeAnthropicConfig	false		Deprecated: Use Providers with indexed CODER_AI_GATEWAY_PROVIDER__* env vars instead.
api_dump_dir	string	false		Api dump dir is the base directory under which each provider's request/response dumps are written, in a subdirectory named after the provider. Empty disables dumping.
bedrock	codersdk.AIBridgeBedrockConfig	false		Deprecated: Use Providers with indexed CODER_AI_GATEWAY_PROVIDER__* env vars instead.
budget_period	string	false
budget_policy	string	false		Budget settings for AI Governance cost controls.
circuit_breaker_enabled	boolean	false		Circuit breaker protects against cascading failures from upstream AI provider overload (503, 529).
circuit_breaker_failure_threshold	integer	false
circuit_breaker_interval	integer	false
circuit_breaker_max_requests	integer	false
circuit_breaker_timeout	integer	false
enabled	boolean	false
inject_coder_mcp_tools	boolean	false		Deprecated: Injected MCP in AI Bridge is deprecated and will be removed in a future release.
max_concurrency	integer	false
openai	codersdk.AIBridgeOpenAIConfig	false		Deprecated: Use Providers with indexed CODER_AI_GATEWAY_PROVIDER__* env vars instead.
providers	array of codersdk.AIProviderConfig	false		Providers holds provider instances populated from CODER_AI_GATEWAY_PROVIDER__ env vars and/or the deprecated LegacyOpenAI/LegacyAnthropic/LegacyBedrock fields above.
rate_limit	integer	false
retention	integer	false
send_actor_headers	boolean	false
structured_logging	boolean	false

codersdk.AIBridgeInterception

{
  "api_key_id": "string",
  "client": "string",
  "ended_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "initiator": {
    "avatar_url": "http://example.com",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "username": "string"
  },
  "metadata": {
    "property1": null,
    "property2": null
  },
  "model": "string",
  "provider": "string",
  "provider_name": "string",
  "started_at": "2019-08-24T14:15:22Z",
  "token_usages": [
    {
      "cache_read_input_tokens": 0,
      "cache_write_input_tokens": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "input_tokens": 0,
      "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
      "metadata": {
        "property1": null,
        "property2": null
      },
      "output_tokens": 0,
      "provider_response_id": "string"
    }
  ],
  "tool_usages": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "injected": true,
      "input": "string",
      "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
      "invocation_error": "string",
      "metadata": {
        "property1": null,
        "property2": null
      },
      "provider_response_id": "string",
      "server_url": "string",
      "tool": "string"
    }
  ],
  "user_prompts": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
      "metadata": {
        "property1": null,
        "property2": null
      },
      "prompt": "string",
      "provider_response_id": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
api_key_id	string	false
client	string	false
ended_at	string	false
id	string	false
initiator	codersdk.MinimalUser	false
metadata	object	false
» [any property]	any	false
model	string	false
provider	string	false
provider_name	string	false
started_at	string	false
token_usages	array of codersdk.AIBridgeTokenUsage	false
tool_usages	array of codersdk.AIBridgeToolUsage	false
user_prompts	array of codersdk.AIBridgeUserPrompt	false

codersdk.AIBridgeListInterceptionsResponse

{
  "count": 0,
  "results": [
    {
      "api_key_id": "string",
      "client": "string",
      "ended_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "initiator": {
        "avatar_url": "http://example.com",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "username": "string"
      },
      "metadata": {
        "property1": null,
        "property2": null
      },
      "model": "string",
      "provider": "string",
      "provider_name": "string",
      "started_at": "2019-08-24T14:15:22Z",
      "token_usages": [
        {
          "cache_read_input_tokens": 0,
          "cache_write_input_tokens": 0,
          "created_at": "2019-08-24T14:15:22Z",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "input_tokens": 0,
          "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
          "metadata": {
            "property1": null,
            "property2": null
          },
          "output_tokens": 0,
          "provider_response_id": "string"
        }
      ],
      "tool_usages": [
        {
          "created_at": "2019-08-24T14:15:22Z",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "injected": true,
          "input": "string",
          "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
          "invocation_error": "string",
          "metadata": {
            "property1": null,
            "property2": null
          },
          "provider_response_id": "string",
          "server_url": "string",
          "tool": "string"
        }
      ],
      "user_prompts": [
        {
          "created_at": "2019-08-24T14:15:22Z",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
          "metadata": {
            "property1": null,
            "property2": null
          },
          "prompt": "string",
          "provider_response_id": "string"
        }
      ]
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
results	array of codersdk.AIBridgeInterception	false

codersdk.AIBridgeListSessionsResponse

{
  "count": 0,
  "sessions": [
    {
      "client": "string",
      "ended_at": "2019-08-24T14:15:22Z",
      "id": "string",
      "initiator": {
        "avatar_url": "http://example.com",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "username": "string"
      },
      "last_active_at": "2019-08-24T14:15:22Z",
      "last_prompt": "string",
      "metadata": {
        "property1": null,
        "property2": null
      },
      "models": [
        "string"
      ],
      "providers": [
        "string"
      ],
      "started_at": "2019-08-24T14:15:22Z",
      "threads": 0,
      "token_usage_summary": {
        "cache_read_input_tokens": 0,
        "cache_write_input_tokens": 0,
        "input_tokens": 0,
        "output_tokens": 0
      }
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
sessions	array of codersdk.AIBridgeSession	false

codersdk.AIBridgeModelThought

{
  "text": "string"
}

Properties

Name	Type	Required	Restrictions	Description
text	string	false

codersdk.AIBridgeOpenAIConfig

{
  "base_url": "string",
  "key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
base_url	string	false
key	string	false

codersdk.AIBridgeProxyConfig

{
  "allowed_private_cidrs": [
    "string"
  ],
  "api_dump_dir": "string",
  "cert_file": "string",
  "domain_allowlist": [
    "string"
  ],
  "enabled": true,
  "key_file": "string",
  "listen_addr": "string",
  "tls_cert_file": "string",
  "tls_key_file": "string",
  "upstream_proxy": "string",
  "upstream_proxy_ca": "string"
}

Properties

Name	Type	Required	Restrictions	Description
allowed_private_cidrs	array of string	false
api_dump_dir	string	false
cert_file	string	false
domain_allowlist	array of string	false
enabled	boolean	false
key_file	string	false
listen_addr	string	false
tls_cert_file	string	false
tls_key_file	string	false
upstream_proxy	string	false
upstream_proxy_ca	string	false

codersdk.AIBridgeSession

{
  "client": "string",
  "ended_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "initiator": {
    "avatar_url": "http://example.com",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "username": "string"
  },
  "last_active_at": "2019-08-24T14:15:22Z",
  "last_prompt": "string",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "models": [
    "string"
  ],
  "providers": [
    "string"
  ],
  "started_at": "2019-08-24T14:15:22Z",
  "threads": 0,
  "token_usage_summary": {
    "cache_read_input_tokens": 0,
    "cache_write_input_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0
  }
}

Properties

Name	Type	Required	Restrictions	Description
client	string	false
ended_at	string	false
id	string	false
initiator	codersdk.MinimalUser	false
last_active_at	string	false
last_prompt	string	false
metadata	object	false
» [any property]	any	false
models	array of string	false
providers	array of string	false
started_at	string	false
threads	integer	false
token_usage_summary	codersdk.AIBridgeSessionTokenUsageSummary	false

codersdk.AIBridgeSessionThreadsResponse

{
  "client": "string",
  "ended_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "initiator": {
    "avatar_url": "http://example.com",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "username": "string"
  },
  "metadata": {
    "property1": null,
    "property2": null
  },
  "models": [
    "string"
  ],
  "page_ended_at": "2019-08-24T14:15:22Z",
  "page_started_at": "2019-08-24T14:15:22Z",
  "providers": [
    "string"
  ],
  "started_at": "2019-08-24T14:15:22Z",
  "threads": [
    {
      "agentic_actions": [
        {
          "model": "string",
          "thinking": [
            {
              "text": "string"
            }
          ],
          "token_usage": {
            "cache_read_input_tokens": 0,
            "cache_write_input_tokens": 0,
            "input_tokens": 0,
            "metadata": {
              "property1": null,
              "property2": null
            },
            "output_tokens": 0
          },
          "tool_calls": [
            {
              "created_at": "2019-08-24T14:15:22Z",
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "injected": true,
              "input": "string",
              "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
              "metadata": {
                "property1": null,
                "property2": null
              },
              "provider_response_id": "string",
              "server_url": "string",
              "tool": "string"
            }
          ]
        }
      ],
      "credential_hint": "string",
      "credential_kind": "string",
      "ended_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "model": "string",
      "prompt": "string",
      "provider": "string",
      "started_at": "2019-08-24T14:15:22Z",
      "token_usage": {
        "cache_read_input_tokens": 0,
        "cache_write_input_tokens": 0,
        "input_tokens": 0,
        "metadata": {
          "property1": null,
          "property2": null
        },
        "output_tokens": 0
      }
    }
  ],
  "token_usage_summary": {
    "cache_read_input_tokens": 0,
    "cache_write_input_tokens": 0,
    "input_tokens": 0,
    "metadata": {
      "property1": null,
      "property2": null
    },
    "output_tokens": 0
  }
}

Properties

Name	Type	Required	Restrictions	Description
client	string	false
ended_at	string	false
id	string	false
initiator	codersdk.MinimalUser	false
metadata	object	false
» [any property]	any	false
models	array of string	false
page_ended_at	string	false
page_started_at	string	false
providers	array of string	false
started_at	string	false
threads	array of codersdk.AIBridgeThread	false
token_usage_summary	codersdk.AIBridgeSessionThreadsTokenUsage	false

codersdk.AIBridgeSessionThreadsTokenUsage

{
  "cache_read_input_tokens": 0,
  "cache_write_input_tokens": 0,
  "input_tokens": 0,
  "metadata": {
    "property1": null,
    "property2": null
  },
  "output_tokens": 0
}

Properties

Name	Type	Required	Restrictions	Description
cache_read_input_tokens	integer	false
cache_write_input_tokens	integer	false
input_tokens	integer	false
metadata	object	false
» [any property]	any	false
output_tokens	integer	false

codersdk.AIBridgeSessionTokenUsageSummary

{
  "cache_read_input_tokens": 0,
  "cache_write_input_tokens": 0,
  "input_tokens": 0,
  "output_tokens": 0
}

Properties

Name	Type	Required	Restrictions	Description
cache_read_input_tokens	integer	false
cache_write_input_tokens	integer	false
input_tokens	integer	false
output_tokens	integer	false

codersdk.AIBridgeThread

{
  "agentic_actions": [
    {
      "model": "string",
      "thinking": [
        {
          "text": "string"
        }
      ],
      "token_usage": {
        "cache_read_input_tokens": 0,
        "cache_write_input_tokens": 0,
        "input_tokens": 0,
        "metadata": {
          "property1": null,
          "property2": null
        },
        "output_tokens": 0
      },
      "tool_calls": [
        {
          "created_at": "2019-08-24T14:15:22Z",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "injected": true,
          "input": "string",
          "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
          "metadata": {
            "property1": null,
            "property2": null
          },
          "provider_response_id": "string",
          "server_url": "string",
          "tool": "string"
        }
      ]
    }
  ],
  "credential_hint": "string",
  "credential_kind": "string",
  "ended_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "model": "string",
  "prompt": "string",
  "provider": "string",
  "started_at": "2019-08-24T14:15:22Z",
  "token_usage": {
    "cache_read_input_tokens": 0,
    "cache_write_input_tokens": 0,
    "input_tokens": 0,
    "metadata": {
      "property1": null,
      "property2": null
    },
    "output_tokens": 0
  }
}

Properties

Name	Type	Required	Restrictions	Description
agentic_actions	array of codersdk.AIBridgeAgenticAction	false
credential_hint	string	false
credential_kind	string	false
ended_at	string	false
id	string	false
model	string	false
prompt	string	false
provider	string	false
started_at	string	false
token_usage	codersdk.AIBridgeSessionThreadsTokenUsage	false

codersdk.AIBridgeTokenUsage

{
  "cache_read_input_tokens": 0,
  "cache_write_input_tokens": 0,
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "input_tokens": 0,
  "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "output_tokens": 0,
  "provider_response_id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
cache_read_input_tokens	integer	false
cache_write_input_tokens	integer	false
created_at	string	false
id	string	false
input_tokens	integer	false
interception_id	string	false
metadata	object	false
» [any property]	any	false
output_tokens	integer	false
provider_response_id	string	false

codersdk.AIBridgeToolCall

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "injected": true,
  "input": "string",
  "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "provider_response_id": "string",
  "server_url": "string",
  "tool": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	string	false
injected	boolean	false
input	string	false
interception_id	string	false
metadata	object	false
» [any property]	any	false
provider_response_id	string	false
server_url	string	false
tool	string	false

codersdk.AIBridgeToolUsage

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "injected": true,
  "input": "string",
  "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
  "invocation_error": "string",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "provider_response_id": "string",
  "server_url": "string",
  "tool": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	string	false
injected	boolean	false
input	string	false
interception_id	string	false
invocation_error	string	false
metadata	object	false
» [any property]	any	false
provider_response_id	string	false
server_url	string	false
tool	string	false

codersdk.AIBridgeUserPrompt

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "interception_id": "34d9b688-63ad-46f4-88b5-665c1e7f7824",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "prompt": "string",
  "provider_response_id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	string	false
interception_id	string	false
metadata	object	false
» [any property]	any	false
prompt	string	false
provider_response_id	string	false

codersdk.AIConfig

{
  "aibridge_proxy": {
    "allowed_private_cidrs": [
      "string"
    ],
    "api_dump_dir": "string",
    "cert_file": "string",
    "domain_allowlist": [
      "string"
    ],
    "enabled": true,
    "key_file": "string",
    "listen_addr": "string",
    "tls_cert_file": "string",
    "tls_key_file": "string",
    "upstream_proxy": "string",
    "upstream_proxy_ca": "string"
  },
  "bridge": {
    "allow_byok": true,
    "anthropic": {
      "base_url": "string",
      "key": "string"
    },
    "api_dump_dir": "string",
    "bedrock": {
      "access_key": "string",
      "access_key_secret": "string",
      "base_url": "string",
      "model": "string",
      "region": "string",
      "small_fast_model": "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,
    "openai": {
      "base_url": "string",
      "key": "string"
    },
    "providers": [
      {
        "base_url": "string",
        "bedrock_model": "string",
        "bedrock_region": "string",
        "bedrock_small_fast_model": "string",
        "name": "string",
        "type": "string"
      }
    ],
    "rate_limit": 0,
    "retention": 0,
    "send_actor_headers": true,
    "structured_logging": true
  },
  "chat": {
    "acquire_batch_size": 0,
    "debug_logging_enabled": true
  }
}

Properties

Name	Type	Required	Restrictions	Description
aibridge_proxy	codersdk.AIBridgeProxyConfig	false
bridge	codersdk.AIBridgeConfig	false
chat	codersdk.ChatConfig	false

codersdk.AIProvider

{
  "api_keys": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "masked": "string"
    }
  ],
  "base_url": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "display_name": "string",
  "enabled": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "settings": {},
  "type": "openai",
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
api_keys	array of codersdk.AIProviderKey	false
base_url	string	false
created_at	string	false
display_name	string	false
enabled	boolean	false
id	string	false
name	string	false
settings	codersdk.AIProviderSettings	false
type	codersdk.AIProviderType	false
updated_at	string	false

codersdk.AIProviderConfig

{
  "base_url": "string",
  "bedrock_model": "string",
  "bedrock_region": "string",
  "bedrock_small_fast_model": "string",
  "name": "string",
  "type": "string"
}

Properties

Name	Type	Required	Restrictions	Description
base_url	string	false		Base URL is the base URL of the upstream provider API.
bedrock_model	string	false
bedrock_region	string	false
bedrock_small_fast_model	string	false
name	string	false		Name is the unique instance identifier used for routing. Defaults to Type if not provided.
type	string	false		Type is the provider type. Valid values are: "openai", "anthropic", "azure", "bedrock", "google", "openai-compat", "openrouter", "vercel", "copilot".

codersdk.AIProviderKey

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "masked": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	string	false
masked	string	false

codersdk.AIProviderKeyMutation

{
  "api_key": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Properties

Name	Type	Required	Restrictions	Description
api_key	string	false
id	string	false

codersdk.AIProviderSettings

{}

Properties

None

codersdk.AIProviderType

"openai"

Properties

Enumerated Values

Value(s)
anthropic, azure, bedrock, copilot, google, openai, openai-compat, openrouter, vercel

codersdk.APIAllowListTarget

{
  "id": "string",
  "type": "*"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	false
type	codersdk.RBACResource	false

codersdk.APIKey

{
  "allow_list": [
    {
      "id": "string",
      "type": "*"
    }
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "expires_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "last_used": "2019-08-24T14:15:22Z",
  "lifetime_seconds": 0,
  "login_type": "password",
  "scope": "all",
  "scopes": [
    "all"
  ],
  "token_name": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
allow_list	array of codersdk.APIAllowListTarget	false
created_at	string	true
expires_at	string	true
id	string	true
last_used	string	true
lifetime_seconds	integer	true
login_type	codersdk.LoginType	true
scope	codersdk.APIKeyScope	false		Deprecated: use Scopes instead.
scopes	array of codersdk.APIKeyScope	false
token_name	string	true
updated_at	string	true
user_id	string	true

Enumerated Values

Property	Value(s)
login_type	github, oidc, password, token
scope	all, application_connect

codersdk.APIKeyScope

"all"

Properties

Enumerated Values

Value(s)

ai_model_price:*, ai_model_price:read, ai_model_price:update, ai_provider:*, ai_provider:create, ai_provider:delete, ai_provider:read, ai_provider:update, ai_seat:*, ai_seat:create, ai_seat:read, aibridge_interception:*, aibridge_interception:create, aibridge_interception:read, aibridge_interception:update, all, api_key:*, api_key:create, api_key:delete, api_key:read, api_key:update, application_connect, assign_org_role:*, assign_org_role:assign, assign_org_role:create, assign_org_role:delete, assign_org_role:read, assign_org_role:unassign, assign_org_role:update, assign_role:*, assign_role:assign, assign_role:read, assign_role:unassign, audit_log:*, audit_log:create, audit_log:read, boundary_log:*, boundary_log:create, boundary_log:delete, boundary_log:read, boundary_usage:*, boundary_usage:delete, boundary_usage:read, boundary_usage:update, chat:*, chat:create, chat:delete, chat:read, chat:share, chat:update, coder:all, coder:apikeys.manage_self, coder:application_connect, coder:templates.author, coder:templates.build, coder:workspaces.access, coder:workspaces.create, coder:workspaces.delete, coder:workspaces.operate, connection_log:*, connection_log:read, connection_log:update, crypto_key:*, crypto_key:create, crypto_key:delete, crypto_key:read, crypto_key:update, debug_info:*, debug_info:read, deployment_config:*, deployment_config:read, deployment_config:update, deployment_stats:*, deployment_stats:read, file:*, file:create, file:read, group:*, group:create, group:delete, group:read, group:update, group_member:*, group_member:read, idpsync_settings:*, idpsync_settings:read, idpsync_settings:update, inbox_notification:*, inbox_notification:create, inbox_notification:read, inbox_notification:update, license:*, license:create, license:delete, license:read, notification_message:*, notification_message:create, notification_message:delete, notification_message:read, notification_message:update, notification_preference:*, notification_preference:read, notification_preference:update, notification_template:*, notification_template:read, notification_template:update, oauth2_app:*, oauth2_app:create, oauth2_app:delete, oauth2_app:read, oauth2_app:update, oauth2_app_code_token:*, oauth2_app_code_token:create, oauth2_app_code_token:delete, oauth2_app_code_token:read, oauth2_app_secret:*, oauth2_app_secret:create, oauth2_app_secret:delete, oauth2_app_secret:read, oauth2_app_secret:update, organization:*, organization:create, organization:delete, organization:read, organization:update, organization_member:*, organization_member:create, organization_member:delete, organization_member:read, organization_member:update, prebuilt_workspace:*, prebuilt_workspace:delete, prebuilt_workspace:update, provisioner_daemon:*, provisioner_daemon:create, provisioner_daemon:delete, provisioner_daemon:read, provisioner_daemon:update, provisioner_jobs:*, provisioner_jobs:create, provisioner_jobs:read, provisioner_jobs:update, replicas:*, replicas:read, system:*, system:create, system:delete, system:read, system:update, tailnet_coordinator:*, tailnet_coordinator:create, tailnet_coordinator:delete, tailnet_coordinator:read, tailnet_coordinator:update, task:*, task:create, task:delete, task:read, task:update, template:*, template:create, template:delete, template:read, template:update, template:use, template:view_insights, usage_event:*, usage_event:create, usage_event:read, usage_event:update, user:*, user:create, user:delete, user:read, user:read_personal, user:update, user:update_personal, user_secret:*, user_secret:create, user_secret:delete, user_secret:read, user_secret:update, user_skill:*, user_skill:create, user_skill:delete, user_skill:read, user_skill:update, webpush_subscription:*, webpush_subscription:create, webpush_subscription:delete, webpush_subscription:read, workspace:*, workspace:application_connect, workspace:create, workspace:create_agent, workspace:delete, workspace:delete_agent, workspace:read, workspace:share, workspace:ssh, workspace:start, workspace:stop, workspace:update, workspace:update_agent, workspace_agent_devcontainers:*, workspace_agent_devcontainers:create, workspace_agent_resource_monitor:*, workspace_agent_resource_monitor:create, workspace_agent_resource_monitor:read, workspace_agent_resource_monitor:update, workspace_dormant:*, workspace_dormant:application_connect, workspace_dormant:create, workspace_dormant:create_agent, workspace_dormant:delete, workspace_dormant:delete_agent, workspace_dormant:read, workspace_dormant:share, workspace_dormant:ssh, workspace_dormant:start, workspace_dormant:stop, workspace_dormant:update, workspace_dormant:update_agent, workspace_proxy:*, workspace_proxy:create, workspace_proxy:delete, workspace_proxy:read, workspace_proxy:update

codersdk.AddLicenseRequest

{
  "license": "string"
}

Properties

Name	Type	Required	Restrictions	Description
license	string	true

codersdk.AgentChatSendShortcut

"enter"

Properties

Enumerated Values

Value(s)
enter, modifier_enter

codersdk.AgentConnectionTiming

{
  "ended_at": "2019-08-24T14:15:22Z",
  "stage": "init",
  "started_at": "2019-08-24T14:15:22Z",
  "workspace_agent_id": "string",
  "workspace_agent_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
ended_at	string	false
stage	codersdk.TimingStage	false
started_at	string	false
workspace_agent_id	string	false
workspace_agent_name	string	false

codersdk.AgentDisplayMode

"auto"

Properties

Enumerated Values

Value(s)
always_collapsed, always_expanded, auto

codersdk.AgentScriptTiming

{
  "display_name": "string",
  "ended_at": "2019-08-24T14:15:22Z",
  "exit_code": 0,
  "stage": "init",
  "started_at": "2019-08-24T14:15:22Z",
  "status": "string",
  "workspace_agent_id": "string",
  "workspace_agent_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
ended_at	string	false
exit_code	integer	false
stage	codersdk.TimingStage	false
started_at	string	false
status	string	false
workspace_agent_id	string	false
workspace_agent_name	string	false

codersdk.AgentSubsystem

"envbox"

Properties

Enumerated Values

Value(s)
envbox, envbuilder, exectrace

codersdk.AppHostResponse

{
  "host": "string"
}

Properties

Name	Type	Required	Restrictions	Description
host	string	false		Host is the externally accessible URL for the Coder instance.

codersdk.AppearanceConfig

{
  "announcement_banners": [
    {
      "background_color": "string",
      "enabled": true,
      "message": "string"
    }
  ],
  "application_name": "string",
  "docs_url": "string",
  "logo_url": "string",
  "service_banner": {
    "background_color": "string",
    "enabled": true,
    "message": "string"
  },
  "support_links": [
    {
      "icon": "bug",
      "location": "navbar",
      "name": "string",
      "target": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
announcement_banners	array of codersdk.BannerConfig	false
application_name	string	false
docs_url	string	false
logo_url	string	false
service_banner	codersdk.BannerConfig	false		Deprecated: ServiceBanner has been replaced by AnnouncementBanners.
support_links	array of codersdk.LinkConfig	false

codersdk.ArchiveTemplateVersionsRequest

{
  "all": true
}

Properties

Name	Type	Required	Restrictions	Description
all	boolean	false		By default, only failed versions are archived. Set this to true to archive all unused versions regardless of job status.

codersdk.AssignableRoles

{
  "assignable": true,
  "built_in": true,
  "display_name": "string",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_member_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "organization_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "site_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "user_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
assignable	boolean	false
built_in	boolean	false		Built in roles are immutable
display_name	string	false
name	string	false
organization_id	string	false
organization_member_permissions	array of codersdk.Permission	false		Organization member permissions are specific for the organization in the field 'OrganizationID' above.
organization_permissions	array of codersdk.Permission	false		Organization permissions are specific for the organization in the field 'OrganizationID' above.
site_permissions	array of codersdk.Permission	false
user_permissions	array of codersdk.Permission	false

codersdk.AuditAction

"create"

Properties

Enumerated Values

Value(s)
close, connect, create, delete, disconnect, login, logout, open, register, request_password_reset, start, stop, write

codersdk.AuditDiff

{
  "property1": {
    "new": null,
    "old": null,
    "secret": true
  },
  "property2": {
    "new": null,
    "old": null,
    "secret": true
  }
}

Properties

Name	Type	Required	Restrictions	Description
[any property]	codersdk.AuditDiffField	false

codersdk.AuditDiffField

{
  "new": null,
  "old": null,
  "secret": true
}

Properties

Name	Type	Required	Restrictions	Description
new	any	false
old	any	false
secret	boolean	false

codersdk.AuditLog

{
  "action": "create",
  "additional_fields": {},
  "description": "string",
  "diff": {
    "property1": {
      "new": null,
      "old": null,
      "secret": true
    },
    "property2": {
      "new": null,
      "old": null,
      "secret": true
    }
  },
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "ip": "string",
  "is_deleted": true,
  "organization": {
    "display_name": "string",
    "icon": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string"
  },
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
  "resource_icon": "string",
  "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
  "resource_link": "string",
  "resource_target": "string",
  "resource_type": "template",
  "status_code": 0,
  "time": "2019-08-24T14:15:22Z",
  "user": {
    "avatar_url": "http://example.com",
    "created_at": "2019-08-24T14:15:22Z",
    "email": "user@example.com",
    "has_ai_seat": true,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "is_service_account": true,
    "last_seen_at": "2019-08-24T14:15:22Z",
    "login_type": "",
    "name": "string",
    "organization_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "roles": [
      {
        "display_name": "string",
        "name": "string",
        "organization_id": "string"
      }
    ],
    "status": "active",
    "theme_preference": "string",
    "updated_at": "2019-08-24T14:15:22Z",
    "username": "string"
  },
  "user_agent": "string"
}

Properties

Name	Type	Required	Restrictions	Description
action	codersdk.AuditAction	false
additional_fields	object	false
description	string	false
diff	codersdk.AuditDiff	false
id	string	false
ip	string	false
is_deleted	boolean	false
organization	codersdk.MinimalOrganization	false
organization_id	string	false		Deprecated: Use 'organization.id' instead.
request_id	string	false
resource_icon	string	false
resource_id	string	false
resource_link	string	false
resource_target	string	false		Resource target is the name of the resource.
resource_type	codersdk.ResourceType	false
status_code	integer	false
time	string	false
user	codersdk.User	false
user_agent	string	false

codersdk.AuditLogResponse

{
  "audit_logs": [
    {
      "action": "create",
      "additional_fields": {},
      "description": "string",
      "diff": {
        "property1": {
          "new": null,
          "old": null,
          "secret": true
        },
        "property2": {
          "new": null,
          "old": null,
          "secret": true
        }
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "ip": "string",
      "is_deleted": true,
      "organization": {
        "display_name": "string",
        "icon": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
      },
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
      "resource_icon": "string",
      "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
      "resource_link": "string",
      "resource_target": "string",
      "resource_type": "template",
      "status_code": 0,
      "time": "2019-08-24T14:15:22Z",
      "user": {
        "avatar_url": "http://example.com",
        "created_at": "2019-08-24T14:15:22Z",
        "email": "user@example.com",
        "has_ai_seat": true,
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "is_service_account": true,
        "last_seen_at": "2019-08-24T14:15:22Z",
        "login_type": "",
        "name": "string",
        "organization_ids": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "roles": [
          {
            "display_name": "string",
            "name": "string",
            "organization_id": "string"
          }
        ],
        "status": "active",
        "theme_preference": "string",
        "updated_at": "2019-08-24T14:15:22Z",
        "username": "string"
      },
      "user_agent": "string"
    }
  ],
  "count": 0,
  "count_cap": 0
}

Properties

Name	Type	Required	Restrictions	Description
audit_logs	array of codersdk.AuditLog	false
count	integer	false
count_cap	integer	false

codersdk.AuthMethod

{
  "enabled": true
}

Properties

Name	Type	Required	Restrictions	Description
enabled	boolean	false

codersdk.AuthMethods

{
  "github": {
    "default_provider_configured": true,
    "enabled": true
  },
  "oidc": {
    "enabled": true,
    "iconUrl": "string",
    "signInText": "string"
  },
  "password": {
    "enabled": true
  },
  "terms_of_service_url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
github	codersdk.GithubAuthMethod	false
oidc	codersdk.OIDCAuthMethod	false
password	codersdk.AuthMethod	false
terms_of_service_url	string	false

codersdk.AuthorizationCheck

{
  "action": "create",
  "object": {
    "any_org": true,
    "organization_id": "string",
    "owner_id": "string",
    "resource_id": "string",
    "resource_type": "*"
  }
}

AuthorizationCheck is used to check if the currently authenticated user (or the specified user) can do a given action to a given set of objects.

Properties

Name	Type	Required	Restrictions	Description
action	codersdk.RBACAction	false
object	codersdk.AuthorizationObject	false		Object can represent a "set" of objects, such as: all workspaces in an organization, all workspaces owned by me, and all workspaces across the entire product. When defining an object, use the most specific language when possible to produce the smallest set. Meaning to set as many fields on 'Object' as you can. Example, if you want to check if you can update all workspaces owned by 'me', try to also add an 'OrganizationID' to the settings. Omitting the 'OrganizationID' could produce the incorrect value, as workspaces have both user and organization owners.

Enumerated Values

Property	Value(s)
action	create, delete, read, update

codersdk.AuthorizationObject

{
  "any_org": true,
  "organization_id": "string",
  "owner_id": "string",
  "resource_id": "string",
  "resource_type": "*"
}

AuthorizationObject can represent a "set" of objects, such as: all workspaces in an organization, all workspaces owned by me, all workspaces across the entire product.

Properties

Name	Type	Required	Restrictions	Description
any_org	boolean	false		Any org (optional) will disregard the org_owner when checking for permissions. This cannot be set to true if the OrganizationID is set.
organization_id	string	false		Organization ID (optional) adds the set constraint to all resources owned by a given organization.
owner_id	string	false		Owner ID (optional) adds the set constraint to all resources owned by a given user.
resource_id	string	false		Resource ID (optional) reduces the set to a singular resource. This assigns a resource ID to the resource type, eg: a single workspace. The rbac library will not fetch the resource from the database, so if you are using this option, you should also set the owner ID and organization ID if possible. Be as specific as possible using all the fields relevant.
resource_type	codersdk.RBACResource	false		Resource type is the name of the resource. ./coderd/rbac/object.go has the list of valid resource types.

codersdk.AuthorizationRequest

{
  "checks": {
    "property1": {
      "action": "create",
      "object": {
        "any_org": true,
        "organization_id": "string",
        "owner_id": "string",
        "resource_id": "string",
        "resource_type": "*"
      }
    },
    "property2": {
      "action": "create",
      "object": {
        "any_org": true,
        "organization_id": "string",
        "owner_id": "string",
        "resource_id": "string",
        "resource_type": "*"
      }
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
checks	object	false		Checks is a map keyed with an arbitrary string to a permission check. The key can be any string that is helpful to the caller, and allows multiple permission checks to be run in a single request. The key ensures that each permission check has the same key in the response.
» [any property]	codersdk.AuthorizationCheck	false		It is used to check if the currently authenticated user (or the specified user) can do a given action to a given set of objects.

codersdk.AuthorizationResponse

{
  "property1": true,
  "property2": true
}

Properties

Name	Type	Required	Restrictions	Description
[any property]	boolean	false

codersdk.AutomaticUpdates

"always"

Properties

Enumerated Values

Value(s)
always, never

codersdk.BannerConfig

{
  "background_color": "string",
  "enabled": true,
  "message": "string"
}

Properties

Name	Type	Required	Restrictions	Description
background_color	string	false
enabled	boolean	false
message	string	false

codersdk.BuildInfoResponse

{
  "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
}

Properties

Name	Type	Required	Restrictions	Description
agent_api_version	string	false		Agent api version is the current version of the Agent API (back versions MAY still be supported).
dashboard_url	string	false		Dashboard URL is the URL to hit the deployment's dashboard. For external workspace proxies, this is the coderd they are connected to.
deployment_id	string	false		Deployment ID is the unique identifier for this deployment.
external_url	string	false		External URL references the current Coder version. For production builds, this will link directly to a release. For development builds, this will link to a commit.
provisioner_api_version	string	false		Provisioner api version is the current version of the Provisioner API
telemetry	boolean	false		Telemetry is a boolean that indicates whether telemetry is enabled.
upgrade_message	string	false		Upgrade message is the message displayed to users when an outdated client is detected.
version	string	false		Version returns the semantic version of the build.
webpush_public_key	string	false		Webpush public key is the public key for push notifications via Web Push.
workspace_proxy	boolean	false

codersdk.BuildReason

"initiator"

Properties

Enumerated Values

Value(s)
autostart, autostop, cli, dashboard, dormancy, initiator, jetbrains_connection, ssh_connection, task_auto_pause, task_manual_pause, task_resume, vscode_connection

codersdk.CORSBehavior

"simple"

Properties

Enumerated Values

Value(s)
passthru, simple

codersdk.ChangePasswordWithOneTimePasscodeRequest

{
  "email": "user@example.com",
  "one_time_passcode": "string",
  "password": "string"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	true
one_time_passcode	string	true
password	string	true

codersdk.Chat

{
  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
  "archived": true,
  "build_id": "bfb1f3fa-bf7b-43a5-9e0b-26cc050e44cb",
  "children": [
    {
      "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
      "archived": true,
      "build_id": "bfb1f3fa-bf7b-43a5-9e0b-26cc050e44cb",
      "children": [],
      "client_type": "ui",
      "created_at": "2019-08-24T14:15:22Z",
      "diff_status": {
        "additions": 0,
        "approved": true,
        "author_avatar_url": "string",
        "author_login": "string",
        "base_branch": "string",
        "changed_files": 0,
        "changes_requested": true,
        "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
        "commits": 0,
        "deletions": 0,
        "head_branch": "string",
        "pr_number": 0,
        "pull_request_draft": true,
        "pull_request_state": "string",
        "pull_request_title": "string",
        "refreshed_at": "2019-08-24T14:15:22Z",
        "reviewer_count": 0,
        "stale_at": "2019-08-24T14:15:22Z",
        "url": "string"
      },
      "files": [
        {
          "created_at": "2019-08-24T14:15:22Z",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "mime_type": "string",
          "name": "string",
          "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
          "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05"
        }
      ],
      "has_unread": true,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "labels": {
        "property1": "string",
        "property2": "string"
      },
      "last_error": {
        "detail": "string",
        "kind": "generic",
        "message": "string",
        "provider": "string",
        "retryable": true,
        "status_code": 0
      },
      "last_injected_context": [
        {
          "args": [
            0
          ],
          "args_delta": "string",
          "completed_at": "2019-08-24T14:15:22Z",
          "content": "string",
          "context_file_agent_id": {
            "uuid": "string",
            "valid": true
          },
          "context_file_content": "string",
          "context_file_directory": "string",
          "context_file_os": "string",
          "context_file_path": "string",
          "context_file_skill_meta_file": "string",
          "context_file_truncated": true,
          "created_at": "2019-08-24T14:15:22Z",
          "data": [
            0
          ],
          "end_line": 0,
          "file_id": {
            "uuid": "string",
            "valid": true
          },
          "file_name": "string",
          "is_error": true,
          "is_media": true,
          "mcp_server_config_id": {
            "uuid": "string",
            "valid": true
          },
          "media_type": "string",
          "name": "string",
          "parsed_commands": [
            [
              "string"
            ]
          ],
          "provider_executed": true,
          "provider_metadata": [
            0
          ],
          "result": [
            0
          ],
          "result_delta": "string",
          "result_reset": true,
          "signature": "string",
          "skill_description": "string",
          "skill_dir": "string",
          "skill_name": "string",
          "source_id": "string",
          "start_line": 0,
          "text": "string",
          "title": "string",
          "tool_call_id": "string",
          "tool_name": "string",
          "type": "text",
          "url": "string"
        }
      ],
      "last_model_config_id": "30ebb95f-c255-4759-9429-89aa4ec1554c",
      "last_turn_summary": "string",
      "mcp_server_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
      "owner_name": "string",
      "owner_username": "string",
      "parent_chat_id": "c3609ee6-3b11-4a93-b9ae-e4fabcc99359",
      "pin_order": 0,
      "plan_mode": "plan",
      "root_chat_id": "2898031c-fdce-4e3e-8c53-4481dd42fcd7",
      "status": "waiting",
      "title": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "warnings": [
        "string"
      ],
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
    }
  ],
  "client_type": "ui",
  "created_at": "2019-08-24T14:15:22Z",
  "diff_status": {
    "additions": 0,
    "approved": true,
    "author_avatar_url": "string",
    "author_login": "string",
    "base_branch": "string",
    "changed_files": 0,
    "changes_requested": true,
    "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
    "commits": 0,
    "deletions": 0,
    "head_branch": "string",
    "pr_number": 0,
    "pull_request_draft": true,
    "pull_request_state": "string",
    "pull_request_title": "string",
    "refreshed_at": "2019-08-24T14:15:22Z",
    "reviewer_count": 0,
    "stale_at": "2019-08-24T14:15:22Z",
    "url": "string"
  },
  "files": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "mime_type": "string",
      "name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05"
    }
  ],
  "has_unread": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "labels": {
    "property1": "string",
    "property2": "string"
  },
  "last_error": {
    "detail": "string",
    "kind": "generic",
    "message": "string",
    "provider": "string",
    "retryable": true,
    "status_code": 0
  },
  "last_injected_context": [
    {
      "args": [
        0
      ],
      "args_delta": "string",
      "completed_at": "2019-08-24T14:15:22Z",
      "content": "string",
      "context_file_agent_id": {
        "uuid": "string",
        "valid": true
      },
      "context_file_content": "string",
      "context_file_directory": "string",
      "context_file_os": "string",
      "context_file_path": "string",
      "context_file_skill_meta_file": "string",
      "context_file_truncated": true,
      "created_at": "2019-08-24T14:15:22Z",
      "data": [
        0
      ],
      "end_line": 0,
      "file_id": {
        "uuid": "string",
        "valid": true
      },
      "file_name": "string",
      "is_error": true,
      "is_media": true,
      "mcp_server_config_id": {
        "uuid": "string",
        "valid": true
      },
      "media_type": "string",
      "name": "string",
      "parsed_commands": [
        [
          "string"
        ]
      ],
      "provider_executed": true,
      "provider_metadata": [
        0
      ],
      "result": [
        0
      ],
      "result_delta": "string",
      "result_reset": true,
      "signature": "string",
      "skill_description": "string",
      "skill_dir": "string",
      "skill_name": "string",
      "source_id": "string",
      "start_line": 0,
      "text": "string",
      "title": "string",
      "tool_call_id": "string",
      "tool_name": "string",
      "type": "text",
      "url": "string"
    }
  ],
  "last_model_config_id": "30ebb95f-c255-4759-9429-89aa4ec1554c",
  "last_turn_summary": "string",
  "mcp_server_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
  "owner_name": "string",
  "owner_username": "string",
  "parent_chat_id": "c3609ee6-3b11-4a93-b9ae-e4fabcc99359",
  "pin_order": 0,
  "plan_mode": "plan",
  "root_chat_id": "2898031c-fdce-4e3e-8c53-4481dd42fcd7",
  "status": "waiting",
  "title": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "warnings": [
    "string"
  ],
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}

Properties

Name	Type	Required	Restrictions	Description
agent_id	string	false
archived	boolean	false
build_id	string	false
children	array of codersdk.Chat	false		Children holds child (subagent) chats nested under this root chat. Always initialized to an empty slice so the JSON field is present as []. Child chats cannot create their own subagents, so nesting depth is capped at 1 and this slice is always empty for child chats.
client_type	codersdk.ChatClientType	false
created_at	string	false
diff_status	codersdk.ChatDiffStatus	false
files	array of codersdk.ChatFileMetadata	false
has_unread	boolean	false		Has unread is true when assistant messages exist beyond the owner's read cursor, which updates on stream connect and disconnect.
id	string	false
labels	object	false
» [any property]	string	false
last_error	codersdk.ChatError	false
last_injected_context	array of codersdk.ChatMessagePart	false		Last injected context holds the most recently persisted injected context parts (AGENTS.md files and skills). It is updated only when context changes, on first workspace attach or agent change.
last_model_config_id	string	false
last_turn_summary	string	false
mcp_server_ids	array of string	false
organization_id	string	false
owner_id	string	false
owner_name	string	false
owner_username	string	false
parent_chat_id	string	false
pin_order	integer	false
plan_mode	codersdk.ChatPlanMode	false
root_chat_id	string	false
status	codersdk.ChatStatus	false
title	string	false
updated_at	string	false
warnings	array of string	false
workspace_id	string	false

codersdk.ChatACL

{
  "groups": [
    {
      "avatar_url": "http://example.com",
      "display_name": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "members": [
        {
          "avatar_url": "http://example.com",
          "created_at": "2019-08-24T14:15:22Z",
          "email": "user@example.com",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "is_service_account": true,
          "last_seen_at": "2019-08-24T14:15:22Z",
          "login_type": "",
          "name": "string",
          "status": "active",
          "theme_preference": "string",
          "updated_at": "2019-08-24T14:15:22Z",
          "username": "string"
        }
      ],
      "name": "string",
      "organization_display_name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "organization_name": "string",
      "quota_allowance": 0,
      "role": "read",
      "source": "user",
      "total_member_count": 0
    }
  ],
  "users": [
    {
      "avatar_url": "http://example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "role": "read",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
groups	array of codersdk.ChatGroup	false
users	array of codersdk.ChatUser	false

codersdk.ChatBusyBehavior

"queue"

Properties

Enumerated Values

Value(s)
interrupt, queue

codersdk.ChatClientType

"ui"

Properties

Enumerated Values

Value(s)
api, ui

codersdk.ChatConfig

{
  "acquire_batch_size": 0,
  "debug_logging_enabled": true
}

Properties

Name	Type	Required	Restrictions	Description
acquire_batch_size	integer	false
debug_logging_enabled	boolean	false

codersdk.ChatDiffContents

{
  "branch": "string",
  "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
  "diff": "string",
  "provider": "string",
  "pull_request_url": "string",
  "remote_origin": "string"
}

Properties

Name	Type	Required	Restrictions	Description
branch	string	false
chat_id	string	false
diff	string	false
provider	string	false
pull_request_url	string	false
remote_origin	string	false

codersdk.ChatDiffStatus

{
  "additions": 0,
  "approved": true,
  "author_avatar_url": "string",
  "author_login": "string",
  "base_branch": "string",
  "changed_files": 0,
  "changes_requested": true,
  "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
  "commits": 0,
  "deletions": 0,
  "head_branch": "string",
  "pr_number": 0,
  "pull_request_draft": true,
  "pull_request_state": "string",
  "pull_request_title": "string",
  "refreshed_at": "2019-08-24T14:15:22Z",
  "reviewer_count": 0,
  "stale_at": "2019-08-24T14:15:22Z",
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
additions	integer	false
approved	boolean	false
author_avatar_url	string	false
author_login	string	false
base_branch	string	false
changed_files	integer	false
changes_requested	boolean	false
chat_id	string	false
commits	integer	false
deletions	integer	false
head_branch	string	false
pr_number	integer	false
pull_request_draft	boolean	false
pull_request_state	string	false
pull_request_title	string	false
refreshed_at	string	false
reviewer_count	integer	false
stale_at	string	false
url	string	false

codersdk.ChatError

{
  "detail": "string",
  "kind": "generic",
  "message": "string",
  "provider": "string",
  "retryable": true,
  "status_code": 0
}

Properties

Name	Type	Required	Restrictions	Description
detail	string	false		Detail is optional provider-specific context shown alongside the normalized error message when available.
kind	codersdk.ChatErrorKind	false		Kind classifies the error for consistent client rendering.
message	string	false		Message is the normalized, user-facing error message.
provider	string	false		Provider identifies the upstream model provider when known.
retryable	boolean	false		Retryable reports whether the underlying error is transient.
status_code	integer	false		Status code is the best-effort upstream HTTP status code.

codersdk.ChatErrorKind

"generic"

Properties

Enumerated Values

Value(s)
auth, config, generic, missing_key, overloaded, provider_disabled, rate_limit, startup_timeout, timeout, usage_limit

codersdk.ChatFileMetadata

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "mime_type": "string",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	string	false
mime_type	string	false
name	string	false
organization_id	string	false
owner_id	string	false

codersdk.ChatGroup

{
  "avatar_url": "http://example.com",
  "display_name": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "members": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ],
  "name": "string",
  "organization_display_name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_name": "string",
  "quota_allowance": 0,
  "role": "read",
  "source": "user",
  "total_member_count": 0
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
display_name	string	false
id	string	false
members	array of codersdk.ReducedUser	false
name	string	false
organization_display_name	string	false
organization_id	string	false
organization_name	string	false
quota_allowance	integer	false
role	codersdk.ChatRole	false
source	codersdk.GroupSource	false
total_member_count	integer	false		How many members are in this group. Shows the total count, even if the user is not authorized to read group member details. May be greater than len(Group.Members).

Enumerated Values

Property	Value(s)
role	read

codersdk.ChatInputPart

{
  "content": "string",
  "end_line": 0,
  "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
  "file_name": "string",
  "start_line": 0,
  "text": "string",
  "type": "text"
}

Properties

Name	Type	Required	Restrictions	Description
content	string	false		The code content from the diff that was commented on.
end_line	integer	false
file_id	string	false
file_name	string	false		The following fields are only set when Type is ChatInputPartTypeFileReference.
start_line	integer	false
text	string	false
type	codersdk.ChatInputPartType	false

codersdk.ChatInputPartType

"text"

Properties

Enumerated Values

Value(s)
file, file-reference, text

codersdk.ChatMessage

{
  "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
  "content": [
    {
      "args": [
        0
      ],
      "args_delta": "string",
      "completed_at": "2019-08-24T14:15:22Z",
      "content": "string",
      "context_file_agent_id": {
        "uuid": "string",
        "valid": true
      },
      "context_file_content": "string",
      "context_file_directory": "string",
      "context_file_os": "string",
      "context_file_path": "string",
      "context_file_skill_meta_file": "string",
      "context_file_truncated": true,
      "created_at": "2019-08-24T14:15:22Z",
      "data": [
        0
      ],
      "end_line": 0,
      "file_id": {
        "uuid": "string",
        "valid": true
      },
      "file_name": "string",
      "is_error": true,
      "is_media": true,
      "mcp_server_config_id": {
        "uuid": "string",
        "valid": true
      },
      "media_type": "string",
      "name": "string",
      "parsed_commands": [
        [
          "string"
        ]
      ],
      "provider_executed": true,
      "provider_metadata": [
        0
      ],
      "result": [
        0
      ],
      "result_delta": "string",
      "result_reset": true,
      "signature": "string",
      "skill_description": "string",
      "skill_dir": "string",
      "skill_name": "string",
      "source_id": "string",
      "start_line": 0,
      "text": "string",
      "title": "string",
      "tool_call_id": "string",
      "tool_name": "string",
      "type": "text",
      "url": "string"
    }
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
  "id": 0,
  "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
  "role": "system",
  "usage": {
    "cache_creation_tokens": 0,
    "cache_read_tokens": 0,
    "context_limit": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "reasoning_tokens": 0,
    "total_tokens": 0
  }
}

Properties

Name	Type	Required	Restrictions	Description
chat_id	string	false
content	array of codersdk.ChatMessagePart	false
created_at	string	false
created_by	string	false
id	integer	false
model_config_id	string	false
role	codersdk.ChatMessageRole	false
usage	codersdk.ChatMessageUsage	false

codersdk.ChatMessagePart

{
  "args": [
    0
  ],
  "args_delta": "string",
  "completed_at": "2019-08-24T14:15:22Z",
  "content": "string",
  "context_file_agent_id": {
    "uuid": "string",
    "valid": true
  },
  "context_file_content": "string",
  "context_file_directory": "string",
  "context_file_os": "string",
  "context_file_path": "string",
  "context_file_skill_meta_file": "string",
  "context_file_truncated": true,
  "created_at": "2019-08-24T14:15:22Z",
  "data": [
    0
  ],
  "end_line": 0,
  "file_id": {
    "uuid": "string",
    "valid": true
  },
  "file_name": "string",
  "is_error": true,
  "is_media": true,
  "mcp_server_config_id": {
    "uuid": "string",
    "valid": true
  },
  "media_type": "string",
  "name": "string",
  "parsed_commands": [
    [
      "string"
    ]
  ],
  "provider_executed": true,
  "provider_metadata": [
    0
  ],
  "result": [
    0
  ],
  "result_delta": "string",
  "result_reset": true,
  "signature": "string",
  "skill_description": "string",
  "skill_dir": "string",
  "skill_name": "string",
  "source_id": "string",
  "start_line": 0,
  "text": "string",
  "title": "string",
  "tool_call_id": "string",
  "tool_name": "string",
  "type": "text",
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
args	array of integer	false
args_delta	string	false
completed_at	string	false		Completed at is the time a reasoning part finished streaming, so reasoning duration can be computed as completed_at minus created_at. For interrupted reasoning, this is the interruption time. Absent when reasoning timestamp data was not recorded (e.g. messages persisted before this feature was added).
content	string	false		The code content from the diff that was commented on.
context_file_agent_id	uuid.NullUUID	false		Context file agent ID is the workspace agent that provided this context file. Used to detect when the agent changes (e.g. workspace rebuilt) so instruction files can be re-persisted with fresh content.
context_file_content	string	false		Context file content holds the file content sent to the LLM. Internal only: stripped before API responses to keep payloads small. The backend reads it when building the prompt via partsToMessageParts.
context_file_directory	string	false		Context file directory is the working directory of the workspace agent. Internal only: same purpose as ContextFileOS.
context_file_os	string	false		Context file os is the operating system of the workspace agent. Internal only: used during prompt expansion so the LLM knows the OS even on turns where InsertSystem is not called.
context_file_path	string	false		Context file path is the absolute path of a file loaded into the LLM context (e.g. an AGENTS.md instruction file).
context_file_skill_meta_file	string	false		Context file skill meta file is the basename of the skill meta file (e.g. "SKILL.md") at the time of persistence. Internal only: restored on subsequent turns so the read_skill tool uses the correct filename even when the agent configured a non-default value.
context_file_truncated	boolean	false		Context file truncated indicates the file exceeded the 64KiB instruction file limit and was truncated.
created_at	string	false		Created at is the timestamp this part carries. The semantics depend on the part type: for tool-call and tool-result parts it is the time the call was emitted or the result was produced (tool duration is the result's created_at minus the call's created_at); for reasoning parts it is the time reasoning started streaming.
data	array of integer	false
end_line	integer	false
file_id	uuid.NullUUID	false
file_name	string	false
is_error	boolean	false
is_media	boolean	false
mcp_server_config_id	uuid.NullUUID	false
media_type	string	false
name	string	false
parsed_commands	array of array	false		Parsed commands holds parsed programs from an execute tool call's shell command, one entry per simple command in source order. Each entry is [program] or [program, arg] where arg is the first non-flag positional argument. Program names are normalized to their base name (e.g. /usr/bin/go becomes go). Only populated when ToolName is "execute" and the command parses successfully; nil otherwise.
provider_executed	boolean	false		Provider executed indicates the tool call was executed by the provider (e.g. Anthropic computer use).
provider_metadata	array of integer	false		Provider metadata holds provider-specific response metadata (e.g. Anthropic cache control hints) as raw JSON. Internal only: stripped by db2sdk before API responses.
result	array of integer	false
result_delta	string	false
result_reset	boolean	false
signature	string	false
skill_description	string	false		Skill description is the short description from the skill's SKILL.md frontmatter.
skill_dir	string	false		Skill dir is the absolute path to the skill directory inside the workspace filesystem. Internal only: used by read_skill/read_skill_file tools to locate skill files.
skill_name	string	false		Skill name is the kebab-case name of a discovered skill from the workspace's .agents/skills/ directory.
source_id	string	false
start_line	integer	false
text	string	false
title	string	false
tool_call_id	string	false
tool_name	string	false
type	codersdk.ChatMessagePartType	false
url	string	false

codersdk.ChatMessagePartType

"text"

Properties

Enumerated Values

Value(s)
context-file, file, file-reference, reasoning, skill, source, text, tool-call, tool-result

codersdk.ChatMessageRole

"system"

Properties

Enumerated Values

Value(s)
assistant, system, tool, user

codersdk.ChatMessageUsage

{
  "cache_creation_tokens": 0,
  "cache_read_tokens": 0,
  "context_limit": 0,
  "input_tokens": 0,
  "output_tokens": 0,
  "reasoning_tokens": 0,
  "total_tokens": 0
}

Properties

Name	Type	Required	Restrictions	Description
cache_creation_tokens	integer	false
cache_read_tokens	integer	false
context_limit	integer	false
input_tokens	integer	false
output_tokens	integer	false
reasoning_tokens	integer	false
total_tokens	integer	false

codersdk.ChatMessagesResponse

{
  "has_more": true,
  "messages": [
    {
      "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
      "content": [
        {
          "args": [
            0
          ],
          "args_delta": "string",
          "completed_at": "2019-08-24T14:15:22Z",
          "content": "string",
          "context_file_agent_id": {
            "uuid": "string",
            "valid": true
          },
          "context_file_content": "string",
          "context_file_directory": "string",
          "context_file_os": "string",
          "context_file_path": "string",
          "context_file_skill_meta_file": "string",
          "context_file_truncated": true,
          "created_at": "2019-08-24T14:15:22Z",
          "data": [
            0
          ],
          "end_line": 0,
          "file_id": {
            "uuid": "string",
            "valid": true
          },
          "file_name": "string",
          "is_error": true,
          "is_media": true,
          "mcp_server_config_id": {
            "uuid": "string",
            "valid": true
          },
          "media_type": "string",
          "name": "string",
          "parsed_commands": [
            [
              "string"
            ]
          ],
          "provider_executed": true,
          "provider_metadata": [
            0
          ],
          "result": [
            0
          ],
          "result_delta": "string",
          "result_reset": true,
          "signature": "string",
          "skill_description": "string",
          "skill_dir": "string",
          "skill_name": "string",
          "source_id": "string",
          "start_line": 0,
          "text": "string",
          "title": "string",
          "tool_call_id": "string",
          "tool_name": "string",
          "type": "text",
          "url": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      "id": 0,
      "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
      "role": "system",
      "usage": {
        "cache_creation_tokens": 0,
        "cache_read_tokens": 0,
        "context_limit": 0,
        "input_tokens": 0,
        "output_tokens": 0,
        "reasoning_tokens": 0,
        "total_tokens": 0
      }
    }
  ],
  "queued_messages": [
    {
      "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
      "content": [
        {
          "args": [
            0
          ],
          "args_delta": "string",
          "completed_at": "2019-08-24T14:15:22Z",
          "content": "string",
          "context_file_agent_id": {
            "uuid": "string",
            "valid": true
          },
          "context_file_content": "string",
          "context_file_directory": "string",
          "context_file_os": "string",
          "context_file_path": "string",
          "context_file_skill_meta_file": "string",
          "context_file_truncated": true,
          "created_at": "2019-08-24T14:15:22Z",
          "data": [
            0
          ],
          "end_line": 0,
          "file_id": {
            "uuid": "string",
            "valid": true
          },
          "file_name": "string",
          "is_error": true,
          "is_media": true,
          "mcp_server_config_id": {
            "uuid": "string",
            "valid": true
          },
          "media_type": "string",
          "name": "string",
          "parsed_commands": [
            [
              "string"
            ]
          ],
          "provider_executed": true,
          "provider_metadata": [
            0
          ],
          "result": [
            0
          ],
          "result_delta": "string",
          "result_reset": true,
          "signature": "string",
          "skill_description": "string",
          "skill_dir": "string",
          "skill_name": "string",
          "source_id": "string",
          "start_line": 0,
          "text": "string",
          "title": "string",
          "tool_call_id": "string",
          "tool_name": "string",
          "type": "text",
          "url": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "id": 0,
      "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
has_more	boolean	false
messages	array of codersdk.ChatMessage	false
queued_messages	array of codersdk.ChatQueuedMessage	false

codersdk.ChatModel

{
  "display_name": "string",
  "id": "string",
  "model": "string",
  "provider": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
id	string	false
model	string	false
provider	string	false

codersdk.ChatModelProvider

{
  "available": true,
  "models": [
    {
      "display_name": "string",
      "id": "string",
      "model": "string",
      "provider": "string"
    }
  ],
  "provider": "string",
  "unavailable_reason": "missing_api_key"
}

Properties

Name	Type	Required	Restrictions	Description
available	boolean	false
models	array of codersdk.ChatModel	false
provider	string	false
unavailable_reason	codersdk.ChatModelProviderUnavailableReason	false

codersdk.ChatModelProviderUnavailableReason

"missing_api_key"

Properties

Enumerated Values

Value(s)
fetch_failed, missing_api_key, user_api_key_required

codersdk.ChatModelsResponse

{
  "providers": [
    {
      "available": true,
      "models": [
        {
          "display_name": "string",
          "id": "string",
          "model": "string",
          "provider": "string"
        }
      ],
      "provider": "string",
      "unavailable_reason": "missing_api_key"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
providers	array of codersdk.ChatModelProvider	false

codersdk.ChatPlanMode

"plan"

Properties

Enumerated Values

Value(s)
plan

codersdk.ChatPrompt

{
  "id": 0,
  "text": "string"
}

Properties

Name	Type	Required	Restrictions	Description
id	integer	false
text	string	false

codersdk.ChatPromptsResponse

{
  "prompts": [
    {
      "id": 0,
      "text": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
prompts	array of codersdk.ChatPrompt	false

codersdk.ChatQueuedMessage

{
  "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
  "content": [
    {
      "args": [
        0
      ],
      "args_delta": "string",
      "completed_at": "2019-08-24T14:15:22Z",
      "content": "string",
      "context_file_agent_id": {
        "uuid": "string",
        "valid": true
      },
      "context_file_content": "string",
      "context_file_directory": "string",
      "context_file_os": "string",
      "context_file_path": "string",
      "context_file_skill_meta_file": "string",
      "context_file_truncated": true,
      "created_at": "2019-08-24T14:15:22Z",
      "data": [
        0
      ],
      "end_line": 0,
      "file_id": {
        "uuid": "string",
        "valid": true
      },
      "file_name": "string",
      "is_error": true,
      "is_media": true,
      "mcp_server_config_id": {
        "uuid": "string",
        "valid": true
      },
      "media_type": "string",
      "name": "string",
      "parsed_commands": [
        [
          "string"
        ]
      ],
      "provider_executed": true,
      "provider_metadata": [
        0
      ],
      "result": [
        0
      ],
      "result_delta": "string",
      "result_reset": true,
      "signature": "string",
      "skill_description": "string",
      "skill_dir": "string",
      "skill_name": "string",
      "source_id": "string",
      "start_line": 0,
      "text": "string",
      "title": "string",
      "tool_call_id": "string",
      "tool_name": "string",
      "type": "text",
      "url": "string"
    }
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "id": 0,
  "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205"
}

Properties

Name	Type	Required	Restrictions	Description
chat_id	string	false
content	array of codersdk.ChatMessagePart	false
created_at	string	false
id	integer	false
model_config_id	string	false

codersdk.ChatRetentionDaysResponse

{
  "retention_days": 0
}

Properties

Name	Type	Required	Restrictions	Description
retention_days	integer	false

codersdk.ChatRole

"read"

Properties

Enumerated Values

Value(s)
``, read

codersdk.ChatStatus

"waiting"

Properties

Enumerated Values

Value(s)
completed, error, paused, pending, requires_action, running, waiting

codersdk.ChatStreamActionRequired

{
  "tool_calls": [
    {
      "args": "string",
      "tool_call_id": "string",
      "tool_name": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
tool_calls	array of codersdk.ChatStreamToolCall	false

codersdk.ChatStreamEvent

{
  "action_required": {
    "tool_calls": [
      {
        "args": "string",
        "tool_call_id": "string",
        "tool_name": "string"
      }
    ]
  },
  "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
  "error": {
    "detail": "string",
    "kind": "generic",
    "message": "string",
    "provider": "string",
    "retryable": true,
    "status_code": 0
  },
  "message": {
    "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
    "content": [
      {
        "args": [
          0
        ],
        "args_delta": "string",
        "completed_at": "2019-08-24T14:15:22Z",
        "content": "string",
        "context_file_agent_id": {
          "uuid": "string",
          "valid": true
        },
        "context_file_content": "string",
        "context_file_directory": "string",
        "context_file_os": "string",
        "context_file_path": "string",
        "context_file_skill_meta_file": "string",
        "context_file_truncated": true,
        "created_at": "2019-08-24T14:15:22Z",
        "data": [
          0
        ],
        "end_line": 0,
        "file_id": {
          "uuid": "string",
          "valid": true
        },
        "file_name": "string",
        "is_error": true,
        "is_media": true,
        "mcp_server_config_id": {
          "uuid": "string",
          "valid": true
        },
        "media_type": "string",
        "name": "string",
        "parsed_commands": [
          [
            "string"
          ]
        ],
        "provider_executed": true,
        "provider_metadata": [
          0
        ],
        "result": [
          0
        ],
        "result_delta": "string",
        "result_reset": true,
        "signature": "string",
        "skill_description": "string",
        "skill_dir": "string",
        "skill_name": "string",
        "source_id": "string",
        "start_line": 0,
        "text": "string",
        "title": "string",
        "tool_call_id": "string",
        "tool_name": "string",
        "type": "text",
        "url": "string"
      }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    "id": 0,
    "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
    "role": "system",
    "usage": {
      "cache_creation_tokens": 0,
      "cache_read_tokens": 0,
      "context_limit": 0,
      "input_tokens": 0,
      "output_tokens": 0,
      "reasoning_tokens": 0,
      "total_tokens": 0
    }
  },
  "message_part": {
    "part": {
      "args": [
        0
      ],
      "args_delta": "string",
      "completed_at": "2019-08-24T14:15:22Z",
      "content": "string",
      "context_file_agent_id": {
        "uuid": "string",
        "valid": true
      },
      "context_file_content": "string",
      "context_file_directory": "string",
      "context_file_os": "string",
      "context_file_path": "string",
      "context_file_skill_meta_file": "string",
      "context_file_truncated": true,
      "created_at": "2019-08-24T14:15:22Z",
      "data": [
        0
      ],
      "end_line": 0,
      "file_id": {
        "uuid": "string",
        "valid": true
      },
      "file_name": "string",
      "is_error": true,
      "is_media": true,
      "mcp_server_config_id": {
        "uuid": "string",
        "valid": true
      },
      "media_type": "string",
      "name": "string",
      "parsed_commands": [
        [
          "string"
        ]
      ],
      "provider_executed": true,
      "provider_metadata": [
        0
      ],
      "result": [
        0
      ],
      "result_delta": "string",
      "result_reset": true,
      "signature": "string",
      "skill_description": "string",
      "skill_dir": "string",
      "skill_name": "string",
      "source_id": "string",
      "start_line": 0,
      "text": "string",
      "title": "string",
      "tool_call_id": "string",
      "tool_name": "string",
      "type": "text",
      "url": "string"
    },
    "role": "system"
  },
  "queued_messages": [
    {
      "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
      "content": [
        {
          "args": [
            0
          ],
          "args_delta": "string",
          "completed_at": "2019-08-24T14:15:22Z",
          "content": "string",
          "context_file_agent_id": {
            "uuid": "string",
            "valid": true
          },
          "context_file_content": "string",
          "context_file_directory": "string",
          "context_file_os": "string",
          "context_file_path": "string",
          "context_file_skill_meta_file": "string",
          "context_file_truncated": true,
          "created_at": "2019-08-24T14:15:22Z",
          "data": [
            0
          ],
          "end_line": 0,
          "file_id": {
            "uuid": "string",
            "valid": true
          },
          "file_name": "string",
          "is_error": true,
          "is_media": true,
          "mcp_server_config_id": {
            "uuid": "string",
            "valid": true
          },
          "media_type": "string",
          "name": "string",
          "parsed_commands": [
            [
              "string"
            ]
          ],
          "provider_executed": true,
          "provider_metadata": [
            0
          ],
          "result": [
            0
          ],
          "result_delta": "string",
          "result_reset": true,
          "signature": "string",
          "skill_description": "string",
          "skill_dir": "string",
          "skill_name": "string",
          "source_id": "string",
          "start_line": 0,
          "text": "string",
          "title": "string",
          "tool_call_id": "string",
          "tool_name": "string",
          "type": "text",
          "url": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "id": 0,
      "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205"
    }
  ],
  "retry": {
    "attempt": 0,
    "delay_ms": 0,
    "error": "string",
    "kind": "generic",
    "provider": "string",
    "retrying_at": "2019-08-24T14:15:22Z",
    "status_code": 0
  },
  "status": {
    "status": "waiting"
  },
  "type": "message_part"
}

Properties

Name	Type	Required	Restrictions	Description
action_required	codersdk.ChatStreamActionRequired	false
chat_id	string	false
error	codersdk.ChatError	false
message	codersdk.ChatMessage	false
message_part	codersdk.ChatStreamMessagePart	false
queued_messages	array of codersdk.ChatQueuedMessage	false
retry	codersdk.ChatStreamRetry	false
status	codersdk.ChatStreamStatus	false
type	codersdk.ChatStreamEventType	false

codersdk.ChatStreamEventType

"message_part"

Properties

Enumerated Values

Value(s)
action_required, error, message, message_part, queue_update, retry, status

codersdk.ChatStreamMessagePart

{
  "part": {
    "args": [
      0
    ],
    "args_delta": "string",
    "completed_at": "2019-08-24T14:15:22Z",
    "content": "string",
    "context_file_agent_id": {
      "uuid": "string",
      "valid": true
    },
    "context_file_content": "string",
    "context_file_directory": "string",
    "context_file_os": "string",
    "context_file_path": "string",
    "context_file_skill_meta_file": "string",
    "context_file_truncated": true,
    "created_at": "2019-08-24T14:15:22Z",
    "data": [
      0
    ],
    "end_line": 0,
    "file_id": {
      "uuid": "string",
      "valid": true
    },
    "file_name": "string",
    "is_error": true,
    "is_media": true,
    "mcp_server_config_id": {
      "uuid": "string",
      "valid": true
    },
    "media_type": "string",
    "name": "string",
    "parsed_commands": [
      [
        "string"
      ]
    ],
    "provider_executed": true,
    "provider_metadata": [
      0
    ],
    "result": [
      0
    ],
    "result_delta": "string",
    "result_reset": true,
    "signature": "string",
    "skill_description": "string",
    "skill_dir": "string",
    "skill_name": "string",
    "source_id": "string",
    "start_line": 0,
    "text": "string",
    "title": "string",
    "tool_call_id": "string",
    "tool_name": "string",
    "type": "text",
    "url": "string"
  },
  "role": "system"
}

Properties

Name	Type	Required	Restrictions	Description
part	codersdk.ChatMessagePart	false
role	codersdk.ChatMessageRole	false

codersdk.ChatStreamRetry

{
  "attempt": 0,
  "delay_ms": 0,
  "error": "string",
  "kind": "generic",
  "provider": "string",
  "retrying_at": "2019-08-24T14:15:22Z",
  "status_code": 0
}

Properties

Name	Type	Required	Restrictions	Description
attempt	integer	false		Attempt is the 1-indexed retry attempt number.
delay_ms	integer	false		Delay ms is the backoff delay in milliseconds before the retry.
error	string	false		Error is the normalized error message from the failed attempt.
kind	codersdk.ChatErrorKind	false		Kind classifies the retry reason for consistent client rendering.
provider	string	false		Provider identifies the upstream model provider when known.
retrying_at	string	false		Retrying at is the timestamp when the retry will be attempted.
status_code	integer	false		Status code is the best-effort upstream HTTP status code.

codersdk.ChatStreamStatus

{
  "status": "waiting"
}

Properties

Name	Type	Required	Restrictions	Description
status	codersdk.ChatStatus	false

codersdk.ChatStreamToolCall

{
  "args": "string",
  "tool_call_id": "string",
  "tool_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
args	string	false
tool_call_id	string	false
tool_name	string	false

codersdk.ChatUser

{
  "avatar_url": "http://example.com",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "role": "read",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
id	string	true
name	string	false
role	codersdk.ChatRole	false
username	string	true

Enumerated Values

Property	Value(s)
role	read

codersdk.ChatWatchEvent

{
  "chat": {
    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
    "archived": true,
    "build_id": "bfb1f3fa-bf7b-43a5-9e0b-26cc050e44cb",
    "children": [
      {}
    ],
    "client_type": "ui",
    "created_at": "2019-08-24T14:15:22Z",
    "diff_status": {
      "additions": 0,
      "approved": true,
      "author_avatar_url": "string",
      "author_login": "string",
      "base_branch": "string",
      "changed_files": 0,
      "changes_requested": true,
      "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
      "commits": 0,
      "deletions": 0,
      "head_branch": "string",
      "pr_number": 0,
      "pull_request_draft": true,
      "pull_request_state": "string",
      "pull_request_title": "string",
      "refreshed_at": "2019-08-24T14:15:22Z",
      "reviewer_count": 0,
      "stale_at": "2019-08-24T14:15:22Z",
      "url": "string"
    },
    "files": [
      {
        "created_at": "2019-08-24T14:15:22Z",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "mime_type": "string",
        "name": "string",
        "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
        "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05"
      }
    ],
    "has_unread": true,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "labels": {
      "property1": "string",
      "property2": "string"
    },
    "last_error": {
      "detail": "string",
      "kind": "generic",
      "message": "string",
      "provider": "string",
      "retryable": true,
      "status_code": 0
    },
    "last_injected_context": [
      {
        "args": [
          0
        ],
        "args_delta": "string",
        "completed_at": "2019-08-24T14:15:22Z",
        "content": "string",
        "context_file_agent_id": {
          "uuid": "string",
          "valid": true
        },
        "context_file_content": "string",
        "context_file_directory": "string",
        "context_file_os": "string",
        "context_file_path": "string",
        "context_file_skill_meta_file": "string",
        "context_file_truncated": true,
        "created_at": "2019-08-24T14:15:22Z",
        "data": [
          0
        ],
        "end_line": 0,
        "file_id": {
          "uuid": "string",
          "valid": true
        },
        "file_name": "string",
        "is_error": true,
        "is_media": true,
        "mcp_server_config_id": {
          "uuid": "string",
          "valid": true
        },
        "media_type": "string",
        "name": "string",
        "parsed_commands": [
          [
            "string"
          ]
        ],
        "provider_executed": true,
        "provider_metadata": [
          0
        ],
        "result": [
          0
        ],
        "result_delta": "string",
        "result_reset": true,
        "signature": "string",
        "skill_description": "string",
        "skill_dir": "string",
        "skill_name": "string",
        "source_id": "string",
        "start_line": 0,
        "text": "string",
        "title": "string",
        "tool_call_id": "string",
        "tool_name": "string",
        "type": "text",
        "url": "string"
      }
    ],
    "last_model_config_id": "30ebb95f-c255-4759-9429-89aa4ec1554c",
    "last_turn_summary": "string",
    "mcp_server_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
    "owner_name": "string",
    "owner_username": "string",
    "parent_chat_id": "c3609ee6-3b11-4a93-b9ae-e4fabcc99359",
    "pin_order": 0,
    "plan_mode": "plan",
    "root_chat_id": "2898031c-fdce-4e3e-8c53-4481dd42fcd7",
    "status": "waiting",
    "title": "string",
    "updated_at": "2019-08-24T14:15:22Z",
    "warnings": [
      "string"
    ],
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
  },
  "kind": "status_change",
  "tool_calls": [
    {
      "args": "string",
      "tool_call_id": "string",
      "tool_name": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
chat	codersdk.Chat	false
kind	codersdk.ChatWatchEventKind	false
tool_calls	array of codersdk.ChatStreamToolCall	false

codersdk.ChatWatchEventKind

"status_change"

Properties

Enumerated Values

Value(s)
action_required, created, deleted, diff_status_change, status_change, summary_change, title_change

codersdk.ConnectionLatency

{
  "p50": 31.312,
  "p95": 119.832
}

Properties

Name	Type	Required	Restrictions	Description
p50	number	false
p95	number	false

codersdk.ConnectionLog

{
  "agent_name": "string",
  "connect_time": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "ip": "string",
  "organization": {
    "display_name": "string",
    "icon": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string"
  },
  "ssh_info": {
    "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",
    "disconnect_reason": "string",
    "disconnect_time": "2019-08-24T14:15:22Z",
    "exit_code": 0
  },
  "type": "ssh",
  "web_info": {
    "slug_or_port": "string",
    "status_code": 0,
    "user": {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "has_ai_seat": true,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "organization_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "roles": [
        {
          "display_name": "string",
          "name": "string",
          "organization_id": "string"
        }
      ],
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    },
    "user_agent": "string"
  },
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
  "workspace_name": "string",
  "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
  "workspace_owner_username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false
connect_time	string	false
id	string	false
ip	string	false
organization	codersdk.MinimalOrganization	false
ssh_info	codersdk.ConnectionLogSSHInfo	false		Ssh info is only set when type is one of: - ConnectionTypeSSH - ConnectionTypeReconnectingPTY - ConnectionTypeVSCode - ConnectionTypeJetBrains
type	codersdk.ConnectionType	false
web_info	codersdk.ConnectionLogWebInfo	false		Web info is only set when type is one of: - ConnectionTypePortForwarding - ConnectionTypeWorkspaceApp
workspace_id	string	false
workspace_name	string	false
workspace_owner_id	string	false
workspace_owner_username	string	false

codersdk.ConnectionLogResponse

{
  "connection_logs": [
    {
      "agent_name": "string",
      "connect_time": "2019-08-24T14:15:22Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "ip": "string",
      "organization": {
        "display_name": "string",
        "icon": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
      },
      "ssh_info": {
        "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",
        "disconnect_reason": "string",
        "disconnect_time": "2019-08-24T14:15:22Z",
        "exit_code": 0
      },
      "type": "ssh",
      "web_info": {
        "slug_or_port": "string",
        "status_code": 0,
        "user": {
          "avatar_url": "http://example.com",
          "created_at": "2019-08-24T14:15:22Z",
          "email": "user@example.com",
          "has_ai_seat": true,
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "is_service_account": true,
          "last_seen_at": "2019-08-24T14:15:22Z",
          "login_type": "",
          "name": "string",
          "organization_ids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          ],
          "roles": [
            {
              "display_name": "string",
              "name": "string",
              "organization_id": "string"
            }
          ],
          "status": "active",
          "theme_preference": "string",
          "updated_at": "2019-08-24T14:15:22Z",
          "username": "string"
        },
        "user_agent": "string"
      },
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
      "workspace_name": "string",
      "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
      "workspace_owner_username": "string"
    }
  ],
  "count": 0,
  "count_cap": 0
}

Properties

Name	Type	Required	Restrictions	Description
connection_logs	array of codersdk.ConnectionLog	false
count	integer	false
count_cap	integer	false

codersdk.ConnectionLogSSHInfo

{
  "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",
  "disconnect_reason": "string",
  "disconnect_time": "2019-08-24T14:15:22Z",
  "exit_code": 0
}

Properties

Name	Type	Required	Restrictions	Description
connection_id	string	false
disconnect_reason	string	false		Disconnect reason is omitted if a disconnect event with the same connection ID has not yet been seen.
disconnect_time	string	false		Disconnect time is omitted if a disconnect event with the same connection ID has not yet been seen.
exit_code	integer	false		Exit code is the exit code of the SSH session. It is omitted if a disconnect event with the same connection ID has not yet been seen.

codersdk.ConnectionLogWebInfo

{
  "slug_or_port": "string",
  "status_code": 0,
  "user": {
    "avatar_url": "http://example.com",
    "created_at": "2019-08-24T14:15:22Z",
    "email": "user@example.com",
    "has_ai_seat": true,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "is_service_account": true,
    "last_seen_at": "2019-08-24T14:15:22Z",
    "login_type": "",
    "name": "string",
    "organization_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "roles": [
      {
        "display_name": "string",
        "name": "string",
        "organization_id": "string"
      }
    ],
    "status": "active",
    "theme_preference": "string",
    "updated_at": "2019-08-24T14:15:22Z",
    "username": "string"
  },
  "user_agent": "string"
}

Properties

Name	Type	Required	Restrictions	Description
slug_or_port	string	false
status_code	integer	false		Status code is the HTTP status code of the request.
user	codersdk.User	false		User is omitted if the connection event was from an unauthenticated user.
user_agent	string	false

codersdk.ConnectionType

"ssh"

Properties

Enumerated Values

Value(s)
jetbrains, port_forwarding, reconnecting_pty, ssh, vscode, workspace_app

codersdk.ConvertLoginRequest

{
  "password": "string",
  "to_type": ""
}

Properties

Name	Type	Required	Restrictions	Description
password	string	true
to_type	codersdk.LoginType	true		To type is the login type to convert to.

codersdk.CreateAIProviderRequest

{
  "api_keys": [
    "string"
  ],
  "base_url": "string",
  "display_name": "string",
  "enabled": true,
  "name": "string",
  "settings": {},
  "type": "openai"
}

Properties

Name	Type	Required	Restrictions	Description
api_keys	array of string	false
base_url	string	false
display_name	string	false
enabled	boolean	false
name	string	false
settings	codersdk.AIProviderSettings	false
type	codersdk.AIProviderType	false

codersdk.CreateChatMessageRequest

{
  "busy_behavior": "queue",
  "content": [
    {
      "content": "string",
      "end_line": 0,
      "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
      "file_name": "string",
      "start_line": 0,
      "text": "string",
      "type": "text"
    }
  ],
  "mcp_server_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
  "plan_mode": "plan"
}

Properties

Name	Type	Required	Restrictions	Description
busy_behavior	codersdk.ChatBusyBehavior	false
content	array of codersdk.ChatInputPart	false
mcp_server_ids	array of string	false
model_config_id	string	false
plan_mode	codersdk.ChatPlanMode	false		Plan mode switches the chat's persistent plan mode. nil: no change, ptr to "plan": enable, ptr to "": clear.

Enumerated Values

Property	Value(s)
busy_behavior	interrupt, queue

codersdk.CreateChatMessageResponse

{
  "message": {
    "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
    "content": [
      {
        "args": [
          0
        ],
        "args_delta": "string",
        "completed_at": "2019-08-24T14:15:22Z",
        "content": "string",
        "context_file_agent_id": {
          "uuid": "string",
          "valid": true
        },
        "context_file_content": "string",
        "context_file_directory": "string",
        "context_file_os": "string",
        "context_file_path": "string",
        "context_file_skill_meta_file": "string",
        "context_file_truncated": true,
        "created_at": "2019-08-24T14:15:22Z",
        "data": [
          0
        ],
        "end_line": 0,
        "file_id": {
          "uuid": "string",
          "valid": true
        },
        "file_name": "string",
        "is_error": true,
        "is_media": true,
        "mcp_server_config_id": {
          "uuid": "string",
          "valid": true
        },
        "media_type": "string",
        "name": "string",
        "parsed_commands": [
          [
            "string"
          ]
        ],
        "provider_executed": true,
        "provider_metadata": [
          0
        ],
        "result": [
          0
        ],
        "result_delta": "string",
        "result_reset": true,
        "signature": "string",
        "skill_description": "string",
        "skill_dir": "string",
        "skill_name": "string",
        "source_id": "string",
        "start_line": 0,
        "text": "string",
        "title": "string",
        "tool_call_id": "string",
        "tool_name": "string",
        "type": "text",
        "url": "string"
      }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    "id": 0,
    "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
    "role": "system",
    "usage": {
      "cache_creation_tokens": 0,
      "cache_read_tokens": 0,
      "context_limit": 0,
      "input_tokens": 0,
      "output_tokens": 0,
      "reasoning_tokens": 0,
      "total_tokens": 0
    }
  },
  "queued": true,
  "queued_message": {
    "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
    "content": [
      {
        "args": [
          0
        ],
        "args_delta": "string",
        "completed_at": "2019-08-24T14:15:22Z",
        "content": "string",
        "context_file_agent_id": {
          "uuid": "string",
          "valid": true
        },
        "context_file_content": "string",
        "context_file_directory": "string",
        "context_file_os": "string",
        "context_file_path": "string",
        "context_file_skill_meta_file": "string",
        "context_file_truncated": true,
        "created_at": "2019-08-24T14:15:22Z",
        "data": [
          0
        ],
        "end_line": 0,
        "file_id": {
          "uuid": "string",
          "valid": true
        },
        "file_name": "string",
        "is_error": true,
        "is_media": true,
        "mcp_server_config_id": {
          "uuid": "string",
          "valid": true
        },
        "media_type": "string",
        "name": "string",
        "parsed_commands": [
          [
            "string"
          ]
        ],
        "provider_executed": true,
        "provider_metadata": [
          0
        ],
        "result": [
          0
        ],
        "result_delta": "string",
        "result_reset": true,
        "signature": "string",
        "skill_description": "string",
        "skill_dir": "string",
        "skill_name": "string",
        "source_id": "string",
        "start_line": 0,
        "text": "string",
        "title": "string",
        "tool_call_id": "string",
        "tool_name": "string",
        "type": "text",
        "url": "string"
      }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "id": 0,
    "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205"
  },
  "warnings": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
message	codersdk.ChatMessage	false
queued	boolean	false
queued_message	codersdk.ChatQueuedMessage	false
warnings	array of string	false

codersdk.CreateChatRequest

{
  "client_type": "ui",
  "content": [
    {
      "content": "string",
      "end_line": 0,
      "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
      "file_name": "string",
      "start_line": 0,
      "text": "string",
      "type": "text"
    }
  ],
  "labels": {
    "property1": "string",
    "property2": "string"
  },
  "mcp_server_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "plan_mode": "plan",
  "system_prompt": "string",
  "unsafe_dynamic_tools": [
    {
      "description": "string",
      "input_schema": [
        0
      ],
      "name": "string"
    }
  ],
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}

Properties

Name	Type	Required	Restrictions	Description
client_type	codersdk.ChatClientType	false
content	array of codersdk.ChatInputPart	false
labels	object	false
» [any property]	string	false
mcp_server_ids	array of string	false
model_config_id	string	false
organization_id	string	false
plan_mode	codersdk.ChatPlanMode	false
system_prompt	string	false
unsafe_dynamic_tools	array of codersdk.DynamicTool	false		Unsafe dynamic tools declares client-executed tools that the LLM can invoke. This API is highly experimental and highly subject to change.
workspace_id	string	false

codersdk.CreateFirstUserOnboardingInfo

{
  "newsletter_marketing": true,
  "newsletter_releases": true
}

Properties

Name	Type	Required	Restrictions	Description
newsletter_marketing	boolean	false
newsletter_releases	boolean	false

codersdk.CreateFirstUserRequest

{
  "email": "string",
  "name": "string",
  "onboarding_info": {
    "newsletter_marketing": true,
    "newsletter_releases": true
  },
  "password": "string",
  "trial": true,
  "trial_info": {
    "company_name": "string",
    "country": "string",
    "developers": "string",
    "first_name": "string",
    "job_title": "string",
    "last_name": "string",
    "phone_number": "string"
  },
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	true
name	string	false
onboarding_info	codersdk.CreateFirstUserOnboardingInfo	false
password	string	true
trial	boolean	false
trial_info	codersdk.CreateFirstUserTrialInfo	false
username	string	true

codersdk.CreateFirstUserResponse

{
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
organization_id	string	false
user_id	string	false

codersdk.CreateFirstUserTrialInfo

{
  "company_name": "string",
  "country": "string",
  "developers": "string",
  "first_name": "string",
  "job_title": "string",
  "last_name": "string",
  "phone_number": "string"
}

Properties

Name	Type	Required	Restrictions	Description
company_name	string	false
country	string	false
developers	string	false
first_name	string	false
job_title	string	false
last_name	string	false
phone_number	string	false

codersdk.CreateGroupRequest

{
  "avatar_url": "string",
  "display_name": "string",
  "name": "string",
  "quota_allowance": 0
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
display_name	string	false
name	string	true
quota_allowance	integer	false

codersdk.CreateOrganizationRequest

{
  "description": "string",
  "display_name": "string",
  "icon": "string",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
display_name	string	false		Display name will default to the same value as Name if not provided.
icon	string	false
name	string	true

codersdk.CreateProvisionerKeyResponse

{
  "key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
key	string	false

codersdk.CreateTaskRequest

{
  "display_name": "string",
  "input": "string",
  "name": "string",
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
  "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
input	string	false
name	string	false
template_version_id	string	false
template_version_preset_id	string	false

codersdk.CreateTemplateRequest

{
  "activity_bump_ms": 0,
  "allow_user_autostart": true,
  "allow_user_autostop": true,
  "allow_user_cancel_workspace_jobs": true,
  "autostart_requirement": {
    "days_of_week": [
      "monday"
    ]
  },
  "autostop_requirement": {
    "days_of_week": [
      "monday"
    ],
    "weeks": 0
  },
  "cors_behavior": "simple",
  "default_ttl_ms": 0,
  "delete_ttl_ms": 0,
  "description": "string",
  "disable_everyone_group_access": true,
  "display_name": "string",
  "dormant_ttl_ms": 0,
  "failure_ttl_ms": 0,
  "icon": "string",
  "max_port_share_level": "owner",
  "name": "string",
  "require_active_version": true,
  "template_use_classic_parameter_flow": true,
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1"
}

Properties

Name	Type	Required	Restrictions	Description
activity_bump_ms	integer	false		Activity bump ms allows optionally specifying the activity bump duration for all workspaces created from this template. Defaults to 1h but can be set to 0 to disable activity bumping.
allow_user_autostart	boolean	false		Allow user autostart allows users to set a schedule for autostarting their workspace. By default this is true. This can only be disabled when using an enterprise license.
allow_user_autostop	boolean	false		Allow user autostop allows users to set a custom workspace TTL to use in place of the template's DefaultTTL field. By default this is true. If false, the DefaultTTL will always be used. This can only be disabled when using an enterprise license.
allow_user_cancel_workspace_jobs	boolean	false		Allow users to cancel in-progress workspace jobs. *bool as the default value is "true".
autostart_requirement	codersdk.TemplateAutostartRequirement	false		Autostart requirement allows optionally specifying the autostart allowed days for workspaces created from this template. This is an enterprise feature.
autostop_requirement	codersdk.TemplateAutostopRequirement	false		Autostop requirement allows optionally specifying the autostop requirement for workspaces created from this template. This is an enterprise feature.
cors_behavior	codersdk.CORSBehavior	false		Cors behavior allows optionally specifying the CORS behavior for all shared ports.
default_ttl_ms	integer	false		Default ttl ms allows optionally specifying the default TTL for all workspaces created from this template.
delete_ttl_ms	integer	false		Delete ttl ms allows optionally specifying the max lifetime before Coder permanently deletes dormant workspaces created from this template.
description	string	false		Description is a description of what the template contains. It must be less than 128 bytes.
disable_everyone_group_access	boolean	false		Disable everyone group access allows optionally disabling the default behavior of granting the 'everyone' group access to use the template. If this is set to true, the template will not be available to all users, and must be explicitly granted to users or groups in the permissions settings of the template.
display_name	string	false		Display name is the displayed name of the template.
dormant_ttl_ms	integer	false		Dormant ttl ms allows optionally specifying the max lifetime before Coder locks inactive workspaces created from this template.
failure_ttl_ms	integer	false		Failure ttl ms allows optionally specifying the max lifetime before Coder stops all resources for failed workspaces created from this template.
icon	string	false		Icon is a relative path or external URL that specifies an icon to be displayed in the dashboard.
max_port_share_level	codersdk.WorkspaceAgentPortShareLevel	false		Max port share level allows optionally specifying the maximum port share level for workspaces created from the template.
name	string	true		Name is the name of the template.
require_active_version	boolean	false		Require active version mandates that workspaces are built with the active template version.
template_use_classic_parameter_flow	boolean	false		Template use classic parameter flow allows optionally specifying whether the template should use the classic parameter flow. The default if unset is true, and is why *bool is used here. When dynamic parameters becomes the default, this will default to false.
template_version_id	string	true		Template version ID is an in-progress or completed job to use as an initial version of the template.
This is required on creation to enable a user-flow of validating a template works. There is no reason the data-model cannot support empty templates, but it doesn't make sense for users.

codersdk.CreateTemplateVersionDryRunRequest

{
  "rich_parameter_values": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "user_variable_values": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "workspace_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
rich_parameter_values	array of codersdk.WorkspaceBuildParameter	false
user_variable_values	array of codersdk.VariableValue	false
workspace_name	string	false

codersdk.CreateTemplateVersionRequest

{
  "example_id": "string",
  "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
  "message": "string",
  "name": "string",
  "provisioner": "terraform",
  "storage_method": "file",
  "tags": {
    "property1": "string",
    "property2": "string"
  },
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "user_variable_values": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
example_id	string	false
file_id	string	false
message	string	false
name	string	false
provisioner	string	true
storage_method	codersdk.ProvisionerStorageMethod	true
tags	object	false
» [any property]	string	false
template_id	string	false		Template ID optionally associates a version with a template.
user_variable_values	array of codersdk.VariableValue	false

Enumerated Values

Property	Value(s)
provisioner	echo, terraform
storage_method	file

codersdk.CreateTestAuditLogRequest

{
  "action": "create",
  "additional_fields": [
    0
  ],
  "build_reason": "autostart",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
  "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
  "resource_type": "template",
  "time": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
action	codersdk.AuditAction	false
additional_fields	array of integer	false
build_reason	codersdk.BuildReason	false
organization_id	string	false
request_id	string	false
resource_id	string	false
resource_type	codersdk.ResourceType	false
time	string	false

Enumerated Values

Property	Value(s)
action	create, delete, start, stop, write
build_reason	autostart, autostop, initiator
resource_type	auditable_group, git_ssh_key, template, template_version, user, workspace, workspace_build

codersdk.CreateTokenRequest

{
  "allow_list": [
    {
      "id": "string",
      "type": "*"
    }
  ],
  "lifetime": 0,
  "scope": "all",
  "scopes": [
    "all"
  ],
  "token_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
allow_list	array of codersdk.APIAllowListTarget	false
lifetime	integer	false
scope	codersdk.APIKeyScope	false		Deprecated: use Scopes instead.
scopes	array of codersdk.APIKeyScope	false
token_name	string	false

codersdk.CreateUserRequestWithOrgs

{
  "email": "user@example.com",
  "login_type": "",
  "name": "string",
  "organization_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "password": "string",
  "roles": [
    "string"
  ],
  "service_account": true,
  "user_status": "active",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	false
login_type	codersdk.LoginType	false		Login type defaults to LoginTypePassword.
name	string	false
organization_ids	array of string	false		Organization ids is a list of organization IDs that the user should be a member of.
password	string	false
roles	array of string	false		Roles is an optional list of site-level roles to assign at creation.
service_account	boolean	false		Service accounts are admin-managed accounts that cannot login.
user_status	codersdk.UserStatus	false		User status defaults to UserStatusDormant.
username	string	true

codersdk.CreateUserSecretRequest

{
  "description": "string",
  "env_name": "string",
  "file_path": "string",
  "name": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
env_name	string	false
file_path	string	false
name	string	false
value	string	false

codersdk.CreateUserSkillRequest

{
  "content": "string"
}

Properties

Name	Type	Required	Restrictions	Description
content	string	false		Content must be SKILL.md-format Markdown with YAML frontmatter. The frontmatter must include name, may include description, and must be followed by a non-empty body.

codersdk.CreateWorkspaceBuildReason

"dashboard"

Properties

Enumerated Values

Value(s)
cli, dashboard, jetbrains_connection, ssh_connection, task_manual_pause, task_resume, vscode_connection

codersdk.CreateWorkspaceBuildRequest

{
  "dry_run": true,
  "log_level": "debug",
  "orphan": true,
  "reason": "dashboard",
  "rich_parameter_values": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "state": [
    0
  ],
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
  "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
  "transition": "start"
}

Properties

Name	Type	Required	Restrictions	Description
dry_run	boolean	false
log_level	codersdk.ProvisionerLogLevel	false		Log level changes the default logging verbosity of a provider ("info" if empty).
orphan	boolean	false		Orphan may be set for the Destroy transition.
reason	codersdk.CreateWorkspaceBuildReason	false		Reason sets the reason for the workspace build.
rich_parameter_values	array of codersdk.WorkspaceBuildParameter	false		Rich parameter values are optional. It will write params to the 'workspace' scope. This will overwrite any existing parameters with the same name. This will not delete old params not included in this list.
state	array of integer	false
template_version_id	string	false
template_version_preset_id	string	false		Template version preset ID is the ID of the template version preset to use for the build.
transition	codersdk.WorkspaceTransition	true

Enumerated Values

Property	Value(s)
log_level	debug
reason	cli, dashboard, jetbrains_connection, ssh_connection, task_manual_pause, vscode_connection
transition	delete, start, stop

codersdk.CreateWorkspaceProxyRequest

{
  "display_name": "string",
  "icon": "string",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
icon	string	false
name	string	true

codersdk.CreateWorkspaceRequest

{
  "automatic_updates": "always",
  "autostart_schedule": "string",
  "name": "string",
  "rich_parameter_values": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
  "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
  "ttl_ms": 0
}

CreateWorkspaceRequest provides options for creating a new workspace. Only one of TemplateID or TemplateVersionID can be specified, not both. If TemplateID is specified, the active version of the template will be used. Workspace names: - Must start with a letter or number - Can only contain letters, numbers, and hyphens - Cannot contain spaces or special characters - Cannot be named new or create - Must be unique within your workspaces - Maximum length of 32 characters

Properties

Name	Type	Required	Restrictions	Description
automatic_updates	codersdk.AutomaticUpdates	false
autostart_schedule	string	false
name	string	true
rich_parameter_values	array of codersdk.WorkspaceBuildParameter	false		Rich parameter values allows for additional parameters to be provided during the initial provision.
template_id	string	false		Template ID specifies which template should be used for creating the workspace.
template_version_id	string	false		Template version ID can be used to specify a specific version of a template for creating the workspace.
template_version_preset_id	string	false
ttl_ms	integer	false

codersdk.CryptoKey

{
  "deletes_at": "2019-08-24T14:15:22Z",
  "feature": "workspace_apps_api_key",
  "secret": "string",
  "sequence": 0,
  "starts_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
deletes_at	string	false
feature	codersdk.CryptoKeyFeature	false
secret	string	false
sequence	integer	false
starts_at	string	false

codersdk.CryptoKeyFeature

"workspace_apps_api_key"

Properties

Enumerated Values

Value(s)
oidc_convert, tailnet_resume, workspace_apps_api_key, workspace_apps_token

codersdk.CustomNotificationContent

{
  "message": "string",
  "title": "string"
}

Properties

Name	Type	Required	Restrictions	Description
message	string	false
title	string	false

codersdk.CustomNotificationRequest

{
  "content": {
    "message": "string",
    "title": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
content	codersdk.CustomNotificationContent	false

codersdk.CustomRoleRequest

{
  "display_name": "string",
  "name": "string",
  "organization_member_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "organization_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "site_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "user_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
name	string	false
organization_member_permissions	array of codersdk.Permission	false		Organization member permissions are specific to the organization the role belongs to.
organization_permissions	array of codersdk.Permission	false		Organization permissions are specific to the organization the role belongs to.
site_permissions	array of codersdk.Permission	false
user_permissions	array of codersdk.Permission	false

codersdk.DAUEntry

{
  "amount": 0,
  "date": "string"
}

Properties

Name	Type	Required	Restrictions	Description
amount	integer	false
date	string	false		Date is a string formatted as 2024-01-31. Timezone and time information is not included.

codersdk.DAUsResponse

{
  "entries": [
    {
      "amount": 0,
      "date": "string"
    }
  ],
  "tz_hour_offset": 0
}

Properties

Name	Type	Required	Restrictions	Description
entries	array of codersdk.DAUEntry	false
tz_hour_offset	integer	false

codersdk.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"
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
config	codersdk.DERPConfig	false
server	codersdk.DERPServerConfig	false

codersdk.DERPConfig

{
  "block_direct": true,
  "force_websockets": true,
  "path": "string",
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
block_direct	boolean	false
force_websockets	boolean	false
path	string	false
url	string	false

codersdk.DERPRegion

{
  "latency_ms": 0,
  "preferred": true
}

Properties

Name	Type	Required	Restrictions	Description
latency_ms	number	false
preferred	boolean	false

codersdk.DERPServerConfig

{
  "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"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
enable	boolean	false
region_code	string	false
region_id	integer	false
region_name	string	false
relay_url	serpent.URL	false
stun_addresses	array of string	false

codersdk.DangerousConfig

{
  "allow_all_cors": true,
  "allow_path_app_sharing": true,
  "allow_path_app_site_owner_access": true
}

Properties

Name	Type	Required	Restrictions	Description
allow_all_cors	boolean	false
allow_path_app_sharing	boolean	false
allow_path_app_site_owner_access	boolean	false

codersdk.DeleteExternalAuthByIDResponse

{
  "token_revocation_error": "string",
  "token_revoked": true
}

Properties

Name	Type	Required	Restrictions	Description
token_revocation_error	string	false
token_revoked	boolean	false		Token revoked set to true if token revocation was attempted and was successful

codersdk.DeleteWebpushSubscription

{
  "endpoint": "string"
}

Properties

Name	Type	Required	Restrictions	Description
endpoint	string	false

codersdk.DeleteWorkspaceAgentPortShareRequest

{
  "agent_name": "string",
  "port": 0
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false
port	integer	false

codersdk.DeploymentConfig

{
  "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",
        "tls_cert_file": "string",
        "tls_key_file": "string",
        "upstream_proxy": "string",
        "upstream_proxy_ca": "string"
      },
      "bridge": {
        "allow_byok": true,
        "anthropic": {
          "base_url": "string",
          "key": "string"
        },
        "api_dump_dir": "string",
        "bedrock": {
          "access_key": "string",
          "access_key_secret": "string",
          "base_url": "string",
          "model": "string",
          "region": "string",
          "small_fast_model": "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,
        "openai": {
          "base_url": "string",
          "key": "string"
        },
        "providers": [
          {
            "base_url": "string",
            "bedrock_model": "string",
            "bedrock_region": "string",
            "bedrock_small_fast_model": "string",
            "name": "string",
            "type": "string"
          }
        ],
        "rate_limit": 0,
        "retention": 0,
        "send_actor_headers": true,
        "structured_logging": true
      },
      "chat": {
        "acquire_batch_size": 0,
        "debug_logging_enabled": true
      }
    },
    "allow_workspace_renames": true,
    "autobuild_poll_interval": 0,
    "browser_only": true,
    "cache_directory": "string",
    "cli_upgrade_message": "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_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_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,
          "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
    },
    "hide_ai_tasks": true,
    "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"
    },
    "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": {},
      "client_cert_file": "string",
      "client_id": "string",
      "client_key_file": "string",
      "client_secret": "string",
      "email_domain": [
        "string"
      ],
      "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_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,
      "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"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
config	codersdk.DeploymentValues	false
options	array of serpent.Option	false

codersdk.DeploymentStats

{
  "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
  }
}

Properties

Name	Type	Required	Restrictions	Description
aggregated_from	string	false		Aggregated from is the time in which stats are aggregated from. This might be back in time a specific duration or interval.
collected_at	string	false		Collected at is the time in which stats are collected at.
next_update_at	string	false		Next update at is the time when the next batch of stats will be updated.
session_count	codersdk.SessionCountDeploymentStats	false
workspaces	codersdk.WorkspaceDeploymentStats	false

codersdk.DeploymentValues

{
  "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",
      "tls_cert_file": "string",
      "tls_key_file": "string",
      "upstream_proxy": "string",
      "upstream_proxy_ca": "string"
    },
    "bridge": {
      "allow_byok": true,
      "anthropic": {
        "base_url": "string",
        "key": "string"
      },
      "api_dump_dir": "string",
      "bedrock": {
        "access_key": "string",
        "access_key_secret": "string",
        "base_url": "string",
        "model": "string",
        "region": "string",
        "small_fast_model": "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,
      "openai": {
        "base_url": "string",
        "key": "string"
      },
      "providers": [
        {
          "base_url": "string",
          "bedrock_model": "string",
          "bedrock_region": "string",
          "bedrock_small_fast_model": "string",
          "name": "string",
          "type": "string"
        }
      ],
      "rate_limit": 0,
      "retention": 0,
      "send_actor_headers": true,
      "structured_logging": true
    },
    "chat": {
      "acquire_batch_size": 0,
      "debug_logging_enabled": true
    }
  },
  "allow_workspace_renames": true,
  "autobuild_poll_interval": 0,
  "browser_only": true,
  "cache_directory": "string",
  "cli_upgrade_message": "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_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_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,
        "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
  },
  "hide_ai_tasks": true,
  "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"
  },
  "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": {},
    "client_cert_file": "string",
    "client_id": "string",
    "client_key_file": "string",
    "client_secret": "string",
    "email_domain": [
      "string"
    ],
    "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_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,
    "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
}

Properties

Name	Type	Required	Restrictions	Description
access_url	serpent.URL	false
additional_csp_policy	array of string	false
address	serpent.HostPort	false		Deprecated: Use HTTPAddress or TLS.Address instead.
agent_fallback_troubleshooting_url	serpent.URL	false
agent_stat_refresh_interval	integer	false
ai	codersdk.AIConfig	false
allow_workspace_renames	boolean	false
autobuild_poll_interval	integer	false
browser_only	boolean	false
cache_directory	string	false
cli_upgrade_message	string	false
config	string	false
config_ssh	codersdk.SSHConfig	false
dangerous	codersdk.DangerousConfig	false
derp	codersdk.DERP	false
disable_chat_sharing	boolean	false
disable_owner_workspace_exec	boolean	false
disable_password_auth	boolean	false
disable_path_apps	boolean	false
disable_workspace_sharing	boolean	false
docs_url	serpent.URL	false
enable_authz_recording	boolean	false
enable_terraform_debug_mode	boolean	false
ephemeral_deployment	boolean	false
experiments	array of string	false
external_auth	serpent.Struct-array_codersdk_ExternalAuthConfig	false
external_auth_github_default_provider_enable	boolean	false
external_token_encryption_keys	array of string	false
healthcheck	codersdk.HealthcheckConfig	false
hide_ai_tasks	boolean	false
http_address	string	false		Http address is a string because it may be set to zero to disable.
http_cookies	codersdk.HTTPCookieConfig	false
job_hang_detector_interval	integer	false
logging	codersdk.LoggingConfig	false
metrics_cache_refresh_interval	integer	false
notifications	codersdk.NotificationsConfig	false
oauth2	codersdk.OAuth2Config	false
oidc	codersdk.OIDCConfig	false
pg_auth	string	false
pg_conn_max_idle	string	false
pg_conn_max_open	integer	false
pg_connection_url	string	false
pprof	codersdk.PprofConfig	false
prometheus	codersdk.PrometheusConfig	false
provisioner	codersdk.ProvisionerConfig	false
proxy_health_status_interval	integer	false
proxy_trusted_headers	array of string	false
proxy_trusted_origins	array of string	false
rate_limit	codersdk.RateLimitConfig	false
redirect_to_access_url	boolean	false
retention	codersdk.RetentionConfig	false
scim_api_key	string	false
scim_use_legacy	boolean	false
session_lifetime	codersdk.SessionLifetime	false
ssh_keygen_algorithm	string	false
stats_collection	codersdk.StatsCollectionConfig	false
strict_transport_security	integer	false
strict_transport_security_options	array of string	false
support	codersdk.SupportConfig	false
swagger	codersdk.SwaggerConfig	false
telemetry	codersdk.TelemetryConfig	false
template_builder	codersdk.TemplateBuilderConfig	false
terms_of_service_url	string	false
tls	codersdk.TLSConfig	false
trace	codersdk.TraceConfig	false
update_check	boolean	false
user_quiet_hours_schedule	codersdk.UserQuietHoursScheduleConfig	false
verbose	boolean	false
web_terminal_renderer	string	false
wgtunnel_host	string	false
wildcard_access_url	string	false
workspace_hostname_suffix	string	false
workspace_prebuilds	codersdk.PrebuildsConfig	false
write_config	boolean	false

codersdk.DiagnosticExtra

{
  "code": "string"
}

Properties

Name	Type	Required	Restrictions	Description
code	string	false

codersdk.DiagnosticSeverityString

"error"

Properties

Enumerated Values

Value(s)
error, warning

codersdk.DisplayApp

"vscode"

Properties

Enumerated Values

Value(s)
port_forwarding_helper, ssh_helper, vscode, vscode_insiders, web_terminal

codersdk.DynamicParametersRequest

{
  "id": 0,
  "inputs": {
    "property1": "string",
    "property2": "string"
  },
  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05"
}

Properties

Name	Type	Required	Restrictions	Description
id	integer	false		ID identifies the request. The response contains the same ID so that the client can match it to the request.
inputs	object	false
» [any property]	string	false
owner_id	string	false		Owner ID if uuid.Nil, it defaults to codersdk.Me

codersdk.DynamicParametersResponse

{
  "diagnostics": [
    {
      "detail": "string",
      "extra": {
        "code": "string"
      },
      "severity": "error",
      "summary": "string"
    }
  ],
  "id": 0,
  "parameters": [
    {
      "default_value": {
        "valid": true,
        "value": "string"
      },
      "description": "string",
      "diagnostics": [
        {
          "detail": "string",
          "extra": {
            "code": "string"
          },
          "severity": "error",
          "summary": "string"
        }
      ],
      "display_name": "string",
      "ephemeral": true,
      "form_type": "",
      "icon": "string",
      "mutable": true,
      "name": "string",
      "options": [
        {
          "description": "string",
          "icon": "string",
          "name": "string",
          "value": {
            "valid": true,
            "value": "string"
          }
        }
      ],
      "order": 0,
      "required": true,
      "styling": {
        "disabled": true,
        "label": "string",
        "mask_input": true,
        "placeholder": "string"
      },
      "type": "string",
      "validations": [
        {
          "validation_error": "string",
          "validation_max": 0,
          "validation_min": 0,
          "validation_monotonic": "string",
          "validation_regex": "string"
        }
      ],
      "value": {
        "valid": true,
        "value": "string"
      }
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
diagnostics	array of codersdk.FriendlyDiagnostic	false
id	integer	false
parameters	array of codersdk.PreviewParameter	false

codersdk.DynamicTool

{
  "description": "string",
  "input_schema": [
    0
  ],
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
input_schema	array of integer	false		Input schema JSON key "input_schema" uses snake_case for SDK consistency, deviating from the camelCase "inputSchema" convention used by MCP.
name	string	false

codersdk.EditChatMessageRequest

{
  "content": [
    {
      "content": "string",
      "end_line": 0,
      "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
      "file_name": "string",
      "start_line": 0,
      "text": "string",
      "type": "text"
    }
  ],
  "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205"
}

Properties

Name	Type	Required	Restrictions	Description
content	array of codersdk.ChatInputPart	false
model_config_id	string	false		Model config ID when set, overrides the model used for the replacement user message and the assistant turn that follows. When nil the original message's model is preserved.

codersdk.EditChatMessageResponse

{
  "message": {
    "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
    "content": [
      {
        "args": [
          0
        ],
        "args_delta": "string",
        "completed_at": "2019-08-24T14:15:22Z",
        "content": "string",
        "context_file_agent_id": {
          "uuid": "string",
          "valid": true
        },
        "context_file_content": "string",
        "context_file_directory": "string",
        "context_file_os": "string",
        "context_file_path": "string",
        "context_file_skill_meta_file": "string",
        "context_file_truncated": true,
        "created_at": "2019-08-24T14:15:22Z",
        "data": [
          0
        ],
        "end_line": 0,
        "file_id": {
          "uuid": "string",
          "valid": true
        },
        "file_name": "string",
        "is_error": true,
        "is_media": true,
        "mcp_server_config_id": {
          "uuid": "string",
          "valid": true
        },
        "media_type": "string",
        "name": "string",
        "parsed_commands": [
          [
            "string"
          ]
        ],
        "provider_executed": true,
        "provider_metadata": [
          0
        ],
        "result": [
          0
        ],
        "result_delta": "string",
        "result_reset": true,
        "signature": "string",
        "skill_description": "string",
        "skill_dir": "string",
        "skill_name": "string",
        "source_id": "string",
        "start_line": 0,
        "text": "string",
        "title": "string",
        "tool_call_id": "string",
        "tool_name": "string",
        "type": "text",
        "url": "string"
      }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    "id": 0,
    "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
    "role": "system",
    "usage": {
      "cache_creation_tokens": 0,
      "cache_read_tokens": 0,
      "context_limit": 0,
      "input_tokens": 0,
      "output_tokens": 0,
      "reasoning_tokens": 0,
      "total_tokens": 0
    }
  },
  "warnings": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
message	codersdk.ChatMessage	false
warnings	array of string	false

codersdk.Entitlement

"entitled"

Properties

Enumerated Values

Value(s)
entitled, grace_period, not_entitled

codersdk.Entitlements

{
  "errors": [
    "string"
  ],
  "features": {
    "property1": {
      "actual": 0,
      "enabled": true,
      "entitlement": "entitled",
      "limit": 0,
      "usage_period": {
        "end": "2019-08-24T14:15:22Z",
        "issued_at": "2019-08-24T14:15:22Z",
        "start": "2019-08-24T14:15:22Z"
      }
    },
    "property2": {
      "actual": 0,
      "enabled": true,
      "entitlement": "entitled",
      "limit": 0,
      "usage_period": {
        "end": "2019-08-24T14:15:22Z",
        "issued_at": "2019-08-24T14:15:22Z",
        "start": "2019-08-24T14:15:22Z"
      }
    }
  },
  "has_license": true,
  "refreshed_at": "2019-08-24T14:15:22Z",
  "require_telemetry": true,
  "trial": true,
  "warnings": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
errors	array of string	false
features	object	false
» [any property]	codersdk.Feature	false
has_license	boolean	false
refreshed_at	string	false
require_telemetry	boolean	false
trial	boolean	false
warnings	array of string	false

codersdk.Experiment

"example"

Properties

Enumerated Values

Value(s)
auto-fill-parameters, example, mcp-server-http, nats_pubsub, notifications, oauth2, workspace-build-updates, workspace-usage

codersdk.ExternalAPIKeyScopes

{
  "external": [
    "all"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
external	array of codersdk.APIKeyScope	false

codersdk.ExternalAgentCredentials

{
  "agent_token": "string",
  "command": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agent_token	string	false
command	string	false

codersdk.ExternalAuth

{
  "app_install_url": "string",
  "app_installable": true,
  "authenticated": true,
  "device": true,
  "display_name": "string",
  "installations": [
    {
      "account": {
        "avatar_url": "string",
        "id": 0,
        "login": "string",
        "name": "string",
        "profile_url": "string"
      },
      "configure_url": "string",
      "id": 0
    }
  ],
  "supports_revocation": true,
  "user": {
    "avatar_url": "string",
    "id": 0,
    "login": "string",
    "name": "string",
    "profile_url": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
app_install_url	string	false		App install URL is the URL to install the app.
app_installable	boolean	false		App installable is true if the request for app installs was successful.
authenticated	boolean	false
device	boolean	false
display_name	string	false
installations	array of codersdk.ExternalAuthAppInstallation	false		Installations are the installations that the user has access to.
supports_revocation	boolean	false
user	codersdk.ExternalAuthUser	false		User is the user that authenticated with the provider.

codersdk.ExternalAuthAppInstallation

{
  "account": {
    "avatar_url": "string",
    "id": 0,
    "login": "string",
    "name": "string",
    "profile_url": "string"
  },
  "configure_url": "string",
  "id": 0
}

Properties

Name	Type	Required	Restrictions	Description
account	codersdk.ExternalAuthUser	false
configure_url	string	false
id	integer	false

codersdk.ExternalAuthConfig

{
  "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,
  "regex": "string",
  "revoke_url": "string",
  "scopes": [
    "string"
  ],
  "token_url": "string",
  "type": "string",
  "validate_url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
api_base_url	string	false		Api base URL is the base URL for provider REST API calls (e.g., "https://api.github.com" for GitHub). Derived from defaults when not explicitly configured.
app_install_url	string	false
app_installations_url	string	false
auth_url	string	false
client_id	string	false
code_challenge_methods_supported	array of string	false		Code challenge methods supported lists the PKCE code challenge methods The only one supported by Coder is "S256".
device_code_url	string	false
device_flow	boolean	false
display_icon	string	false		Display icon is a URL to an icon to display in the UI.
display_name	string	false		Display name is shown in the UI to identify the auth config.
id	string	false		ID is a unique identifier for the auth config. It defaults to type when not provided.
mcp_tool_allow_regex	string	false		Deprecated: Injected MCP in AI Bridge is deprecated and will be removed in a future release.
mcp_tool_deny_regex	string	false		Deprecated: Injected MCP in AI Bridge is deprecated and will be removed in a future release.
mcp_url	string	false		Deprecated: Injected MCP in AI Bridge is deprecated and will be removed in a future release.
no_refresh	boolean	false
regex	string	false		Regex allows API requesters to match an auth config by a string (e.g. coder.com) instead of by it's type.
Git clone makes use of this by parsing the URL from: 'Username for "https://github.com":' And sending it to the Coder server to match against the Regex.
revoke_url	string	false
scopes	array of string	false
token_url	string	false
type	string	false		Type is the type of external auth config.
validate_url	string	false

codersdk.ExternalAuthDevice

{
  "device_code": "string",
  "expires_in": 0,
  "interval": 0,
  "user_code": "string",
  "verification_uri": "string"
}

Properties

Name	Type	Required	Restrictions	Description
device_code	string	false
expires_in	integer	false
interval	integer	false
user_code	string	false
verification_uri	string	false

codersdk.ExternalAuthLink

{
  "authenticated": true,
  "created_at": "2019-08-24T14:15:22Z",
  "expires": "2019-08-24T14:15:22Z",
  "has_refresh_token": true,
  "provider_id": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "validate_error": "string"
}

Properties

Name	Type	Required	Restrictions	Description
authenticated	boolean	false
created_at	string	false
expires	string	false
has_refresh_token	boolean	false
provider_id	string	false
updated_at	string	false
validate_error	string	false

codersdk.ExternalAuthUser

{
  "avatar_url": "string",
  "id": 0,
  "login": "string",
  "name": "string",
  "profile_url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
id	integer	false
login	string	false
name	string	false
profile_url	string	false

codersdk.Feature

{
  "actual": 0,
  "enabled": true,
  "entitlement": "entitled",
  "limit": 0,
  "usage_period": {
    "end": "2019-08-24T14:15:22Z",
    "issued_at": "2019-08-24T14:15:22Z",
    "start": "2019-08-24T14:15:22Z"
  }
}

Properties

Name	Type	Required	Restrictions	Description
actual	integer	false
enabled	boolean	false
entitlement	codersdk.Entitlement	false
limit	integer	false
usage_period	codersdk.UsagePeriod	false		Usage period denotes that the usage is a counter that accumulates over this period (and most likely resets with the issuance of the next license).
These dates are determined from the license that this entitlement comes from, see enterprise/coderd/license/license.go.
Only certain features set these fields: - FeatureManagedAgentLimit

codersdk.FriendlyDiagnostic

{
  "detail": "string",
  "extra": {
    "code": "string"
  },
  "severity": "error",
  "summary": "string"
}

Properties

Name	Type	Required	Restrictions	Description
detail	string	false
extra	codersdk.DiagnosticExtra	false
severity	codersdk.DiagnosticSeverityString	false
summary	string	false

codersdk.GenerateAPIKeyResponse

{
  "key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
key	string	false

codersdk.GetInboxNotificationResponse

{
  "notification": {
    "actions": [
      {
        "label": "string",
        "url": "string"
      }
    ],
    "content": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "icon": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "read_at": "string",
    "targets": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
    "title": "string",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
  },
  "unread_count": 0
}

Properties

Name	Type	Required	Restrictions	Description
notification	codersdk.InboxNotification	false
unread_count	integer	false

codersdk.GetUserStatusCountsResponse

{
  "status_counts": {
    "property1": [
      {
        "count": 10,
        "date": "2019-08-24T14:15:22Z"
      }
    ],
    "property2": [
      {
        "count": 10,
        "date": "2019-08-24T14:15:22Z"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
status_counts	object	false
» [any property]	array of codersdk.UserStatusChangeCount	false

codersdk.GetUsersResponse

{
  "count": 0,
  "users": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "has_ai_seat": true,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "organization_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "roles": [
        {
          "display_name": "string",
          "name": "string",
          "organization_id": "string"
        }
      ],
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
users	array of codersdk.User	false

codersdk.GitSSHKey

{
  "created_at": "2019-08-24T14:15:22Z",
  "public_key": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
public_key	string	false		Public key is the SSH public key in OpenSSH format. Example: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAID3OmYJvT7q1cF1azbybYy0OZ9yrXfA+M6Lr4vzX5zlp\n" Note: The key includes a trailing newline (\n).
updated_at	string	false
user_id	string	false

codersdk.GithubAuthMethod

{
  "default_provider_configured": true,
  "enabled": true
}

Properties

Name	Type	Required	Restrictions	Description
default_provider_configured	boolean	false
enabled	boolean	false

codersdk.Group

{
  "avatar_url": "http://example.com",
  "display_name": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "members": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ],
  "name": "string",
  "organization_display_name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_name": "string",
  "quota_allowance": 0,
  "source": "user",
  "total_member_count": 0
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
display_name	string	false
id	string	false
members	array of codersdk.ReducedUser	false
name	string	false
organization_display_name	string	false
organization_id	string	false
organization_name	string	false
quota_allowance	integer	false
source	codersdk.GroupSource	false
total_member_count	integer	false		How many members are in this group. Shows the total count, even if the user is not authorized to read group member details. May be greater than len(Group.Members).

codersdk.GroupAIBudget

{
  "created_at": "2019-08-24T14:15:22Z",
  "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
  "spend_limit_micros": 0,
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
group_id	string	false
spend_limit_micros	integer	false
updated_at	string	false

codersdk.GroupMembersResponse

{
  "count": 0,
  "users": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
users	array of codersdk.ReducedUser	false

codersdk.GroupSource

"user"

Properties

Enumerated Values

Value(s)
oidc, user

codersdk.GroupSyncSettings

{
  "auto_create_missing_groups": true,
  "field": "string",
  "legacy_group_name_mapping": {
    "property1": "string",
    "property2": "string"
  },
  "mapping": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  },
  "regex_filter": {}
}

Properties

Name	Type	Required	Restrictions	Description
auto_create_missing_groups	boolean	false		Auto create missing groups controls whether groups returned by the OIDC provider are automatically created in Coder if they are missing.
field	string	false		Field is the name of the claim field that specifies what groups a user should be in. If empty, no groups will be synced.
legacy_group_name_mapping	object	false		Legacy group name mapping is deprecated. It remaps an IDP group name to a Coder group name. Since configuration is now done at runtime, group IDs are used to account for group renames. For legacy configurations, this config option has to remain. Deprecated: Use Mapping instead.
» [any property]	string	false
mapping	object	false		Mapping is a map from OIDC groups to Coder group IDs
» [any property]	array of string	false
regex_filter	regexp.Regexp	false		Regex filter is a regular expression that filters the groups returned by the OIDC provider. Any group not matched by this regex will be ignored. If the group filter is nil, then no group filtering will occur.

codersdk.HTTPCookieConfig

{
  "host_prefix": true,
  "same_site": "string",
  "secure_auth_cookie": true
}

Properties

Name	Type	Required	Restrictions	Description
host_prefix	boolean	false
same_site	string	false
secure_auth_cookie	boolean	false

codersdk.Healthcheck

{
  "interval": 0,
  "threshold": 0,
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
interval	integer	false		Interval specifies the seconds between each health check.
threshold	integer	false		Threshold specifies the number of consecutive failed health checks before returning "unhealthy".
url	string	false		URL specifies the endpoint to check for the app health.

codersdk.HealthcheckConfig

{
  "refresh": 0,
  "threshold_database": 0
}

Properties

Name	Type	Required	Restrictions	Description
refresh	integer	false
threshold_database	integer	false

codersdk.InboxNotification

{
  "actions": [
    {
      "label": "string",
      "url": "string"
    }
  ],
  "content": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "read_at": "string",
  "targets": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "title": "string",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
actions	array of codersdk.InboxNotificationAction	false
content	string	false
created_at	string	false
icon	string	false
id	string	false
read_at	string	false
targets	array of string	false
template_id	string	false
title	string	false
user_id	string	false

codersdk.InboxNotificationAction

{
  "label": "string",
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
label	string	false
url	string	false

codersdk.InsightsReportInterval

"day"

Properties

Enumerated Values

Value(s)
day, week

codersdk.InvalidatePresetsResponse

{
  "invalidated": [
    {
      "preset_name": "string",
      "template_name": "string",
      "template_version_name": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
invalidated	array of codersdk.InvalidatedPreset	false

codersdk.InvalidatedPreset

{
  "preset_name": "string",
  "template_name": "string",
  "template_version_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
preset_name	string	false
template_name	string	false
template_version_name	string	false

codersdk.IssueReconnectingPTYSignedTokenRequest

{
  "agentID": "bc282582-04f9-45ce-b904-3e3bfab66958",
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agentID	string	true
url	string	true		URL is the URL of the reconnecting-pty endpoint you are connecting to.

codersdk.IssueReconnectingPTYSignedTokenResponse

{
  "signed_token": "string"
}

Properties

Name	Type	Required	Restrictions	Description
signed_token	string	false

codersdk.JobErrorCode

"REQUIRED_TEMPLATE_VARIABLES"

Properties

Enumerated Values

Value(s)
INSUFFICIENT_QUOTA, REQUIRED_TEMPLATE_VARIABLES

codersdk.License

{
  "claims": {},
  "id": 0,
  "uploaded_at": "2019-08-24T14:15:22Z",
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Properties

Name	Type	Required	Restrictions	Description
claims	object	false		Claims are the JWT claims asserted by the license. Here we use a generic string map to ensure that all data from the server is parsed verbatim, not just the fields this version of Coder understands.
id	integer	false
uploaded_at	string	false
uuid	string	false

codersdk.LinkConfig

{
  "icon": "bug",
  "location": "navbar",
  "name": "string",
  "target": "string"
}

Properties

Name	Type	Required	Restrictions	Description
icon	string	false
location	string	false
name	string	false
target	string	false

Enumerated Values

Property	Value(s)
icon	bug, chat, docs, star
location	dropdown, navbar

codersdk.ListInboxNotificationsResponse

{
  "notifications": [
    {
      "actions": [
        {
          "label": "string",
          "url": "string"
        }
      ],
      "content": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "icon": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "read_at": "string",
      "targets": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
      "title": "string",
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
    }
  ],
  "unread_count": 0
}

Properties

Name	Type	Required	Restrictions	Description
notifications	array of codersdk.InboxNotification	false
unread_count	integer	false

codersdk.LogLevel

"trace"

Properties

Enumerated Values

Value(s)
debug, error, info, trace, warn

codersdk.LogSource

"provisioner_daemon"

Properties

Enumerated Values

Value(s)
provisioner, provisioner_daemon

codersdk.LoggingConfig

{
  "human": "string",
  "json": "string",
  "log_filter": [
    "string"
  ],
  "stackdriver": "string"
}

Properties

Name	Type	Required	Restrictions	Description
human	string	false
json	string	false
log_filter	array of string	false
stackdriver	string	false

codersdk.LoginType

""

Properties

Enumerated Values

Value(s)
``, github, none, oidc, password, token

codersdk.LoginWithPasswordRequest

{
  "email": "user@example.com",
  "password": "string"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	true
password	string	true

codersdk.LoginWithPasswordResponse

{
  "session_token": "string"
}

Properties

Name	Type	Required	Restrictions	Description
session_token	string	true

codersdk.MatchedProvisioners

{
  "available": 0,
  "count": 0,
  "most_recently_seen": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
available	integer	false		Available is the number of provisioner daemons that are available to take jobs. This may be less than the count if some provisioners are busy or have been stopped.
count	integer	false		Count is the number of provisioner daemons that matched the given tags. If the count is 0, it means no provisioner daemons matched the requested tags.
most_recently_seen	string	false		Most recently seen is the most recently seen time of the set of matched provisioners. If no provisioners matched, this field will be null.

codersdk.MinimalOrganization

{
  "display_name": "string",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
icon	string	false
id	string	true
name	string	false

codersdk.MinimalUser

{
  "avatar_url": "http://example.com",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
id	string	true
name	string	false
username	string	true

codersdk.NotificationMethodsResponse

{
  "available": [
    "string"
  ],
  "default": "string"
}

Properties

Name	Type	Required	Restrictions	Description
available	array of string	false
default	string	false

codersdk.NotificationPreference

{
  "disabled": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
disabled	boolean	false
id	string	false
updated_at	string	false

codersdk.NotificationTemplate

{
  "actions": "string",
  "body_template": "string",
  "enabled_by_default": true,
  "group": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "kind": "string",
  "method": "string",
  "name": "string",
  "title_template": "string"
}

Properties

Name	Type	Required	Restrictions	Description
actions	string	false
body_template	string	false
enabled_by_default	boolean	false
group	string	false
id	string	false
kind	string	false
method	string	false
name	string	false
title_template	string	false

codersdk.NotificationsConfig

{
  "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": {}
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
dispatch_timeout	integer	false		How long to wait while a notification is being sent before giving up.
email	codersdk.NotificationsEmailConfig	false		Email settings.
fetch_interval	integer	false		How often to query the database for queued notifications.
inbox	codersdk.NotificationsInboxConfig	false		Inbox settings.
lease_count	integer	false		How many notifications a notifier should lease per fetch interval.
lease_period	integer	false		How long a notifier should lease a message. This is effectively how long a notification is 'owned' by a notifier, and once this period expires it will be available for lease by another notifier. Leasing is important in order for multiple running notifiers to not pick the same messages to deliver concurrently. This lease period will only expire if a notifier shuts down ungracefully; a dispatch of the notification releases the lease.
max_send_attempts	integer	false		The upper limit of attempts to send a notification.
method	string	false		Which delivery method to use (available options: 'smtp', 'webhook').
retry_interval	integer	false		The minimum time between retries.
sync_buffer_size	integer	false		The notifications system buffers message updates in memory to ease pressure on the database. This option controls how many updates are kept in memory. The lower this value the lower the change of state inconsistency in a non-graceful shutdown - but it also increases load on the database. It is recommended to keep this option at its default value.
sync_interval	integer	false		The notifications system buffers message updates in memory to ease pressure on the database. This option controls how often it synchronizes its state with the database. The shorter this value the lower the change of state inconsistency in a non-graceful shutdown - but it also increases load on the database. It is recommended to keep this option at its default value.
webhook	codersdk.NotificationsWebhookConfig	false		Webhook settings.

codersdk.NotificationsEmailAuthConfig

{
  "identity": "string",
  "password": "string",
  "password_file": "string",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
identity	string	false		Identity for PLAIN auth.
password	string	false		Password for LOGIN/PLAIN auth.
password_file	string	false		File from which to load the password for LOGIN/PLAIN auth.
username	string	false		Username for LOGIN/PLAIN auth.

codersdk.NotificationsEmailConfig

{
  "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
  }
}

Properties

Name	Type	Required	Restrictions	Description
auth	codersdk.NotificationsEmailAuthConfig	false		Authentication details.
force_tls	boolean	false		Force tls causes a TLS connection to be attempted.
from	string	false		The sender's address.
hello	string	false		The hostname identifying the SMTP server.
smarthost	string	false		The intermediary SMTP host through which emails are sent (host:port).
tls	codersdk.NotificationsEmailTLSConfig	false		Tls details.

codersdk.NotificationsEmailTLSConfig

{
  "ca_file": "string",
  "cert_file": "string",
  "insecure_skip_verify": true,
  "key_file": "string",
  "server_name": "string",
  "start_tls": true
}

Properties

Name	Type	Required	Restrictions	Description
ca_file	string	false		Ca file specifies the location of the CA certificate to use.
cert_file	string	false		Cert file specifies the location of the certificate to use.
insecure_skip_verify	boolean	false		Insecure skip verify skips target certificate validation.
key_file	string	false		Key file specifies the location of the key to use.
server_name	string	false		Server name to verify the hostname for the targets.
start_tls	boolean	false		Start tls attempts to upgrade plain connections to TLS.

codersdk.NotificationsInboxConfig

{
  "enabled": true
}

Properties

Name	Type	Required	Restrictions	Description
enabled	boolean	false

codersdk.NotificationsSettings

{
  "notifier_paused": true
}

Properties

Name	Type	Required	Restrictions	Description
notifier_paused	boolean	false

codersdk.NotificationsWebhookConfig

{
  "endpoint": {
    "forceQuery": true,
    "fragment": "string",
    "host": "string",
    "omitHost": true,
    "opaque": "string",
    "path": "string",
    "rawFragment": "string",
    "rawPath": "string",
    "rawQuery": "string",
    "scheme": "string",
    "user": {}
  }
}

Properties

Name	Type	Required	Restrictions	Description
endpoint	serpent.URL	false		The URL to which the payload will be sent with an HTTP POST request.

codersdk.NullHCLString

{
  "valid": true,
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
valid	boolean	false
value	string	false

codersdk.OAuth2AppEndpoints

{
  "authorization": "string",
  "device_authorization": "string",
  "token": "string",
  "token_revoke": "string"
}

Properties

Name	Type	Required	Restrictions	Description
authorization	string	false
device_authorization	string	false		Device authorization is optional.
token	string	false
token_revoke	string	false

codersdk.OAuth2AuthorizationServerMetadata

{
  "authorization_endpoint": "string",
  "code_challenge_methods_supported": [
    "S256"
  ],
  "grant_types_supported": [
    "authorization_code"
  ],
  "issuer": "string",
  "registration_endpoint": "string",
  "response_types_supported": [
    "code"
  ],
  "revocation_endpoint": "string",
  "scopes_supported": [
    "string"
  ],
  "token_endpoint": "string",
  "token_endpoint_auth_methods_supported": [
    "client_secret_basic"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
authorization_endpoint	string	false
code_challenge_methods_supported	array of codersdk.OAuth2PKCECodeChallengeMethod	false
grant_types_supported	array of codersdk.OAuth2ProviderGrantType	false
issuer	string	false
registration_endpoint	string	false
response_types_supported	array of codersdk.OAuth2ProviderResponseType	false
revocation_endpoint	string	false
scopes_supported	array of string	false
token_endpoint	string	false
token_endpoint_auth_methods_supported	array of codersdk.OAuth2TokenEndpointAuthMethod	false

codersdk.OAuth2ClientConfiguration

{
  "client_id": "string",
  "client_id_issued_at": 0,
  "client_name": "string",
  "client_secret_expires_at": 0,
  "client_uri": "string",
  "contacts": [
    "string"
  ],
  "grant_types": [
    "authorization_code"
  ],
  "jwks": {},
  "jwks_uri": "string",
  "logo_uri": "string",
  "policy_uri": "string",
  "redirect_uris": [
    "string"
  ],
  "registration_access_token": "string",
  "registration_client_uri": "string",
  "response_types": [
    "code"
  ],
  "scope": "string",
  "software_id": "string",
  "software_version": "string",
  "token_endpoint_auth_method": "client_secret_basic",
  "tos_uri": "string"
}

Properties

Name	Type	Required	Restrictions	Description
client_id	string	false
client_id_issued_at	integer	false
client_name	string	false
client_secret_expires_at	integer	false
client_uri	string	false
contacts	array of string	false
grant_types	array of codersdk.OAuth2ProviderGrantType	false
jwks	object	false
jwks_uri	string	false
logo_uri	string	false
policy_uri	string	false
redirect_uris	array of string	false
registration_access_token	string	false
registration_client_uri	string	false
response_types	array of codersdk.OAuth2ProviderResponseType	false
scope	string	false
software_id	string	false
software_version	string	false
token_endpoint_auth_method	codersdk.OAuth2TokenEndpointAuthMethod	false
tos_uri	string	false

codersdk.OAuth2ClientRegistrationRequest

{
  "client_name": "string",
  "client_uri": "string",
  "contacts": [
    "string"
  ],
  "grant_types": [
    "authorization_code"
  ],
  "jwks": {},
  "jwks_uri": "string",
  "logo_uri": "string",
  "policy_uri": "string",
  "redirect_uris": [
    "string"
  ],
  "response_types": [
    "code"
  ],
  "scope": "string",
  "software_id": "string",
  "software_statement": "string",
  "software_version": "string",
  "token_endpoint_auth_method": "client_secret_basic",
  "tos_uri": "string"
}

Properties

Name	Type	Required	Restrictions	Description
client_name	string	false
client_uri	string	false
contacts	array of string	false
grant_types	array of codersdk.OAuth2ProviderGrantType	false
jwks	object	false
jwks_uri	string	false
logo_uri	string	false
policy_uri	string	false
redirect_uris	array of string	false
response_types	array of codersdk.OAuth2ProviderResponseType	false
scope	string	false
software_id	string	false
software_statement	string	false
software_version	string	false
token_endpoint_auth_method	codersdk.OAuth2TokenEndpointAuthMethod	false
tos_uri	string	false

codersdk.OAuth2ClientRegistrationResponse

{
  "client_id": "string",
  "client_id_issued_at": 0,
  "client_name": "string",
  "client_secret": "string",
  "client_secret_expires_at": 0,
  "client_uri": "string",
  "contacts": [
    "string"
  ],
  "grant_types": [
    "authorization_code"
  ],
  "jwks": {},
  "jwks_uri": "string",
  "logo_uri": "string",
  "policy_uri": "string",
  "redirect_uris": [
    "string"
  ],
  "registration_access_token": "string",
  "registration_client_uri": "string",
  "response_types": [
    "code"
  ],
  "scope": "string",
  "software_id": "string",
  "software_version": "string",
  "token_endpoint_auth_method": "client_secret_basic",
  "tos_uri": "string"
}

Properties

Name	Type	Required	Restrictions	Description
client_id	string	false
client_id_issued_at	integer	false
client_name	string	false
client_secret	string	false
client_secret_expires_at	integer	false
client_uri	string	false
contacts	array of string	false
grant_types	array of codersdk.OAuth2ProviderGrantType	false
jwks	object	false
jwks_uri	string	false
logo_uri	string	false
policy_uri	string	false
redirect_uris	array of string	false
registration_access_token	string	false
registration_client_uri	string	false
response_types	array of codersdk.OAuth2ProviderResponseType	false
scope	string	false
software_id	string	false
software_version	string	false
token_endpoint_auth_method	codersdk.OAuth2TokenEndpointAuthMethod	false
tos_uri	string	false

codersdk.OAuth2Config

{
  "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"
  }
}

Properties

Name	Type	Required	Restrictions	Description
github	codersdk.OAuth2GithubConfig	false

codersdk.OAuth2GithubConfig

{
  "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"
}

Properties

Name	Type	Required	Restrictions	Description
allow_everyone	boolean	false
allow_signups	boolean	false
allowed_orgs	array of string	false
allowed_teams	array of string	false
client_id	string	false
client_secret	string	false
default_provider_enable	boolean	false
device_flow	boolean	false
enterprise_base_url	string	false

codersdk.OAuth2PKCECodeChallengeMethod

"S256"

Properties

Enumerated Values

Value(s)
S256, plain

codersdk.OAuth2ProtectedResourceMetadata

{
  "authorization_servers": [
    "string"
  ],
  "bearer_methods_supported": [
    "string"
  ],
  "resource": "string",
  "scopes_supported": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
authorization_servers	array of string	false
bearer_methods_supported	array of string	false
resource	string	false
scopes_supported	array of string	false

codersdk.OAuth2ProviderApp

{
  "callback_url": "string",
  "endpoints": {
    "authorization": "string",
    "device_authorization": "string",
    "token": "string",
    "token_revoke": "string"
  },
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
callback_url	string	false
endpoints	codersdk.OAuth2AppEndpoints	false		Endpoints are included in the app response for easier discovery. The OAuth2 spec does not have a defined place to find these (for comparison, OIDC has a '/.well-known/openid-configuration' endpoint).
icon	string	false
id	string	false
name	string	false

codersdk.OAuth2ProviderAppSecret

{
  "client_secret_truncated": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "last_used_at": "string"
}

Properties

Name	Type	Required	Restrictions	Description
client_secret_truncated	string	false
id	string	false
last_used_at	string	false

codersdk.OAuth2ProviderAppSecretFull

{
  "client_secret_full": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Properties

Name	Type	Required	Restrictions	Description
client_secret_full	string	false
id	string	false

codersdk.OAuth2ProviderGrantType

"authorization_code"

Properties

Enumerated Values

Value(s)
authorization_code, client_credentials, implicit, password, refresh_token

codersdk.OAuth2ProviderResponseType

"code"

Properties

Enumerated Values

Value(s)
code, token

codersdk.OAuth2TokenEndpointAuthMethod

"client_secret_basic"

Properties

Enumerated Values

Value(s)
client_secret_basic, client_secret_post, none

codersdk.OAuthConversionResponse

{
  "expires_at": "2019-08-24T14:15:22Z",
  "state_string": "string",
  "to_type": "",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
expires_at	string	false
state_string	string	false
to_type	codersdk.LoginType	false
user_id	string	false

codersdk.OIDCAuthMethod

{
  "enabled": true,
  "iconUrl": "string",
  "signInText": "string"
}

Properties

Name	Type	Required	Restrictions	Description
enabled	boolean	false
iconUrl	string	false
signInText	string	false

codersdk.OIDCClaimsResponse

{
  "claims": {}
}

Properties

Name	Type	Required	Restrictions	Description
claims	object	false		Claims are the merged claims from the OIDC provider. These are the union of the ID token claims and the userinfo claims, where userinfo claims take precedence on conflict.

codersdk.OIDCConfig

{
  "allow_signups": true,
  "auth_url_params": {},
  "client_cert_file": "string",
  "client_id": "string",
  "client_key_file": "string",
  "client_secret": "string",
  "email_domain": [
    "string"
  ],
  "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_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"
}

Properties

Name	Type	Required	Restrictions	Description
allow_signups	boolean	false
auth_url_params	object	false
client_cert_file	string	false
client_id	string	false
client_key_file	string	false		Client key file & ClientCertFile are used in place of ClientSecret for PKI auth.
client_secret	string	false
email_domain	array of string	false
email_field	string	false
group_allow_list	array of string	false
group_auto_create	boolean	false
group_mapping	object	false
group_regex_filter	serpent.Regexp	false
groups_field	string	false
icon_url	serpent.URL	false
ignore_email_verified	boolean	false
ignore_user_info	boolean	false		Ignore user info & UserInfoFromAccessToken are mutually exclusive. Only 1 can be set to true. Ideally this would be an enum with 3 states, ['none', 'userinfo', 'access_token']. However, for backward compatibility, ignore_user_info must remain. And access_token is a niche, non-spec compliant edge case. So it's use is rare, and should not be advised.
issuer_url	string	false
name_field	string	false
organization_assign_default	boolean	false
organization_field	string	false
organization_mapping	object	false
redirect_url	serpent.URL	false		Redirect URL is optional, defaulting to 'ACCESS_URL'. Only useful in niche situations where the OIDC callback domain is different from the ACCESS_URL domain.
scopes	array of string	false
sign_in_text	string	false
signups_disabled_text	string	false
skip_issuer_checks	boolean	false
source_user_info_from_access_token	boolean	false		Source user info from access token as mentioned above is an edge case. This allows sourcing the user_info from the access token itself instead of a user_info endpoint. This assumes the access token is a valid JWT with a set of claims to be merged with the id_token.
user_role_field	string	false
user_role_mapping	object	false
user_roles_default	array of string	false
username_field	string	false

codersdk.OptionType

"string"

Properties

Enumerated Values

Value(s)
bool, list(string), number, string

codersdk.Organization

{
  "created_at": "2019-08-24T14:15:22Z",
  "description": "string",
  "display_name": "string",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "is_default": true,
  "name": "string",
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	true
description	string	false
display_name	string	false
icon	string	false
id	string	true
is_default	boolean	true
name	string	false
updated_at	string	true

codersdk.OrganizationMember

{
  "created_at": "2019-08-24T14:15:22Z",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "roles": [
    {
      "display_name": "string",
      "name": "string",
      "organization_id": "string"
    }
  ],
  "updated_at": "2019-08-24T14:15:22Z",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
organization_id	string	false
roles	array of codersdk.SlimRole	false
updated_at	string	false
user_id	string	false

codersdk.OrganizationMemberWithUserData

{
  "avatar_url": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "email": "string",
  "global_roles": [
    {
      "display_name": "string",
      "name": "string",
      "organization_id": "string"
    }
  ],
  "has_ai_seat": true,
  "is_service_account": true,
  "last_seen_at": "2019-08-24T14:15:22Z",
  "login_type": "",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "roles": [
    {
      "display_name": "string",
      "name": "string",
      "organization_id": "string"
    }
  ],
  "status": "active",
  "updated_at": "2019-08-24T14:15:22Z",
  "user_created_at": "2019-08-24T14:15:22Z",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
  "user_updated_at": "2019-08-24T14:15:22Z",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
created_at	string	false
email	string	false
global_roles	array of codersdk.SlimRole	false
has_ai_seat	boolean	false		Has ai seat intentionally omits omitempty so the API always includes the field, even when false.
is_service_account	boolean	false
last_seen_at	string	false
login_type	codersdk.LoginType	false
name	string	false
organization_id	string	false
roles	array of codersdk.SlimRole	false
status	codersdk.UserStatus	false
updated_at	string	false
user_created_at	string	false
user_id	string	false
user_updated_at	string	false
username	string	false

Enumerated Values

Property	Value(s)
status	active, suspended

codersdk.OrganizationSyncSettings

{
  "field": "string",
  "mapping": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  },
  "organization_assign_default": true
}

Properties

Name	Type	Required	Restrictions	Description
field	string	false		Field selects the claim field to be used as the created user's organizations. If the field is the empty string, then no organization updates will ever come from the OIDC provider.
mapping	object	false		Mapping maps from an OIDC claim --> Coder organization uuid
» [any property]	array of string	false
organization_assign_default	boolean	false		Organization assign default will ensure the default org is always included for every user, regardless of their claims. This preserves legacy behavior.

codersdk.PRInsightsModelBreakdown

{
  "cost_per_merged_pr_micros": 0,
  "display_name": "string",
  "merge_rate": 0,
  "merged_prs": 0,
  "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
  "provider": "string",
  "total_additions": 0,
  "total_cost_micros": 0,
  "total_deletions": 0,
  "total_prs": 0
}

Properties

Name	Type	Required	Restrictions	Description
cost_per_merged_pr_micros	integer	false
display_name	string	false
merge_rate	number	false
merged_prs	integer	false
model_config_id	string	false
provider	string	false
total_additions	integer	false
total_cost_micros	integer	false
total_deletions	integer	false
total_prs	integer	false

codersdk.PRInsightsPullRequest

{
  "additions": 0,
  "approved": true,
  "author_avatar_url": "string",
  "author_login": "string",
  "base_branch": "string",
  "changed_files": 0,
  "changes_requested": true,
  "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
  "commits": 0,
  "cost_micros": 0,
  "created_at": "2019-08-24T14:15:22Z",
  "deletions": 0,
  "draft": true,
  "model_display_name": "string",
  "pr_number": 0,
  "pr_title": "string",
  "pr_url": "string",
  "reviewer_count": 0,
  "state": "string"
}

Properties

Name	Type	Required	Restrictions	Description
additions	integer	false
approved	boolean	false
author_avatar_url	string	false
author_login	string	false
base_branch	string	false
changed_files	integer	false
changes_requested	boolean	false
chat_id	string	false
commits	integer	false
cost_micros	integer	false
created_at	string	false
deletions	integer	false
draft	boolean	false
model_display_name	string	false
pr_number	integer	false
pr_title	string	false
pr_url	string	false
reviewer_count	integer	false
state	string	false

codersdk.PRInsightsResponse

{
  "by_model": [
    {
      "cost_per_merged_pr_micros": 0,
      "display_name": "string",
      "merge_rate": 0,
      "merged_prs": 0,
      "model_config_id": "f5fb4d91-62ca-4377-9ee6-5d43ba00d205",
      "provider": "string",
      "total_additions": 0,
      "total_cost_micros": 0,
      "total_deletions": 0,
      "total_prs": 0
    }
  ],
  "recent_prs": [
    {
      "additions": 0,
      "approved": true,
      "author_avatar_url": "string",
      "author_login": "string",
      "base_branch": "string",
      "changed_files": 0,
      "changes_requested": true,
      "chat_id": "efc9fe20-a1e5-4a8c-9c48-f1b30c1e4f86",
      "commits": 0,
      "cost_micros": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "deletions": 0,
      "draft": true,
      "model_display_name": "string",
      "pr_number": 0,
      "pr_title": "string",
      "pr_url": "string",
      "reviewer_count": 0,
      "state": "string"
    }
  ],
  "summary": {
    "approval_rate": 0,
    "cost_per_merged_pr_micros": 0,
    "merge_rate": 0,
    "prev_cost_per_merged_pr_micros": 0,
    "prev_merge_rate": 0,
    "prev_total_prs_created": 0,
    "prev_total_prs_merged": 0,
    "total_additions": 0,
    "total_cost_micros": 0,
    "total_deletions": 0,
    "total_prs_created": 0,
    "total_prs_merged": 0
  },
  "time_series": [
    {
      "date": "2019-08-24T14:15:22Z",
      "prs_closed": 0,
      "prs_created": 0,
      "prs_merged": 0
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
by_model	array of codersdk.PRInsightsModelBreakdown	false
recent_prs	array of codersdk.PRInsightsPullRequest	false
summary	codersdk.PRInsightsSummary	false
time_series	array of codersdk.PRInsightsTimeSeriesEntry	false

codersdk.PRInsightsSummary

{
  "approval_rate": 0,
  "cost_per_merged_pr_micros": 0,
  "merge_rate": 0,
  "prev_cost_per_merged_pr_micros": 0,
  "prev_merge_rate": 0,
  "prev_total_prs_created": 0,
  "prev_total_prs_merged": 0,
  "total_additions": 0,
  "total_cost_micros": 0,
  "total_deletions": 0,
  "total_prs_created": 0,
  "total_prs_merged": 0
}

Properties

Name	Type	Required	Restrictions	Description
approval_rate	number	false
cost_per_merged_pr_micros	integer	false
merge_rate	number	false
prev_cost_per_merged_pr_micros	integer	false
prev_merge_rate	number	false
prev_total_prs_created	integer	false
prev_total_prs_merged	integer	false
total_additions	integer	false
total_cost_micros	integer	false
total_deletions	integer	false
total_prs_created	integer	false
total_prs_merged	integer	false

codersdk.PRInsightsTimeSeriesEntry

{
  "date": "2019-08-24T14:15:22Z",
  "prs_closed": 0,
  "prs_created": 0,
  "prs_merged": 0
}

Properties

Name	Type	Required	Restrictions	Description
date	string	false
prs_closed	integer	false
prs_created	integer	false
prs_merged	integer	false

codersdk.PaginatedMembersResponse

{
  "count": 0,
  "members": [
    {
      "avatar_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "string",
      "global_roles": [
        {
          "display_name": "string",
          "name": "string",
          "organization_id": "string"
        }
      ],
      "has_ai_seat": true,
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "roles": [
        {
          "display_name": "string",
          "name": "string",
          "organization_id": "string"
        }
      ],
      "status": "active",
      "updated_at": "2019-08-24T14:15:22Z",
      "user_created_at": "2019-08-24T14:15:22Z",
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
      "user_updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
members	array of codersdk.OrganizationMemberWithUserData	false

codersdk.ParameterFormType

""

Properties

Enumerated Values

Value(s)
``, checkbox, dropdown, error, input, multi-select, radio, slider, switch, tag-select, textarea

codersdk.PatchGroupIDPSyncConfigRequest

{
  "auto_create_missing_groups": true,
  "field": "string",
  "regex_filter": {}
}

Properties

Name	Type	Required	Restrictions	Description
auto_create_missing_groups	boolean	false
field	string	false
regex_filter	regexp.Regexp	false

codersdk.PatchGroupIDPSyncMappingRequest

{
  "add": [
    {
      "gets": "string",
      "given": "string"
    }
  ],
  "remove": [
    {
      "gets": "string",
      "given": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
add	array of object	false
» gets	string	false		The ID of the Coder resource the user should be added to
» given	string	false		The IdP claim the user has
remove	array of object	false
» gets	string	false		The ID of the Coder resource the user should be added to
» given	string	false		The IdP claim the user has

codersdk.PatchGroupRequest

{
  "add_users": [
    "string"
  ],
  "avatar_url": "string",
  "display_name": "string",
  "name": "string",
  "quota_allowance": 0,
  "remove_users": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
add_users	array of string	false
avatar_url	string	false
display_name	string	false
name	string	false
quota_allowance	integer	false
remove_users	array of string	false

codersdk.PatchOrganizationIDPSyncConfigRequest

{
  "assign_default": true,
  "field": "string"
}

Properties

Name	Type	Required	Restrictions	Description
assign_default	boolean	false
field	string	false

codersdk.PatchOrganizationIDPSyncMappingRequest

{
  "add": [
    {
      "gets": "string",
      "given": "string"
    }
  ],
  "remove": [
    {
      "gets": "string",
      "given": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
add	array of object	false
» gets	string	false		The ID of the Coder resource the user should be added to
» given	string	false		The IdP claim the user has
remove	array of object	false
» gets	string	false		The ID of the Coder resource the user should be added to
» given	string	false		The IdP claim the user has

codersdk.PatchRoleIDPSyncConfigRequest

{
  "field": "string"
}

Properties

Name	Type	Required	Restrictions	Description
field	string	false

codersdk.PatchRoleIDPSyncMappingRequest

{
  "add": [
    {
      "gets": "string",
      "given": "string"
    }
  ],
  "remove": [
    {
      "gets": "string",
      "given": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
add	array of object	false
» gets	string	false		The ID of the Coder resource the user should be added to
» given	string	false		The IdP claim the user has
remove	array of object	false
» gets	string	false		The ID of the Coder resource the user should be added to
» given	string	false		The IdP claim the user has

codersdk.PatchTemplateVersionRequest

{
  "message": "string",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
message	string	false
name	string	false

codersdk.PatchWorkspaceProxy

{
  "display_name": "string",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "regenerate_token": true
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	true
icon	string	true
id	string	true
name	string	true
regenerate_token	boolean	false

codersdk.PauseTaskResponse

{
  "workspace_build": {
    "build_number": 0,
    "created_at": "2019-08-24T14:15:22Z",
    "daily_cost": 0,
    "deadline": "2019-08-24T14:15:22Z",
    "has_ai_task": true,
    "has_external_agent": true,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
    "initiator_name": "string",
    "job": {
      "available_workers": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "canceled_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "error": "string",
      "error_code": "REQUIRED_TEMPLATE_VARIABLES",
      "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
      "input": {
        "error": "string",
        "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
        "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
      },
      "logs_overflowed": true,
      "metadata": {
        "template_display_name": "string",
        "template_icon": "string",
        "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
        "template_name": "string",
        "template_version_name": "string",
        "workspace_build_transition": "start",
        "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
        "workspace_name": "string"
      },
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "queue_position": 0,
      "queue_size": 0,
      "started_at": "2019-08-24T14:15:22Z",
      "status": "pending",
      "tags": {
        "property1": "string",
        "property2": "string"
      },
      "type": "template_version_import",
      "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
      "worker_name": "string"
    },
    "matched_provisioners": {
      "available": 0,
      "count": 0,
      "most_recently_seen": "2019-08-24T14:15:22Z"
    },
    "max_deadline": "2019-08-24T14:15:22Z",
    "reason": "initiator",
    "resources": [
      {
        "agents": [
          {
            "api_version": "string",
            "apps": [
              {
                "command": "string",
                "display_name": "string",
                "external": true,
                "group": "string",
                "health": "disabled",
                "healthcheck": {
                  "interval": 0,
                  "threshold": 0,
                  "url": "string"
                },
                "hidden": true,
                "icon": "string",
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "open_in": "slim-window",
                "sharing_level": "owner",
                "slug": "string",
                "statuses": [
                  {
                    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
                    "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
                    "created_at": "2019-08-24T14:15:22Z",
                    "icon": "string",
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "message": "string",
                    "needs_user_attention": true,
                    "state": "working",
                    "uri": "string",
                    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
                  }
                ],
                "subdomain": true,
                "subdomain_name": "string",
                "tooltip": "string",
                "url": "string"
              }
            ],
            "architecture": "string",
            "connection_timeout_seconds": 0,
            "created_at": "2019-08-24T14:15:22Z",
            "directory": "string",
            "disconnected_at": "2019-08-24T14:15:22Z",
            "display_apps": [
              "vscode"
            ],
            "environment_variables": {
              "property1": "string",
              "property2": "string"
            },
            "expanded_directory": "string",
            "first_connected_at": "2019-08-24T14:15:22Z",
            "health": {
              "healthy": false,
              "reason": "agent has lost connection"
            },
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "instance_id": "string",
            "last_connected_at": "2019-08-24T14:15:22Z",
            "latency": {
              "property1": {
                "latency_ms": 0,
                "preferred": true
              },
              "property2": {
                "latency_ms": 0,
                "preferred": true
              }
            },
            "lifecycle_state": "created",
            "log_sources": [
              {
                "created_at": "2019-08-24T14:15:22Z",
                "display_name": "string",
                "icon": "string",
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
              }
            ],
            "logs_length": 0,
            "logs_overflowed": true,
            "name": "string",
            "operating_system": "string",
            "parent_id": {
              "uuid": "string",
              "valid": true
            },
            "ready_at": "2019-08-24T14:15:22Z",
            "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
            "scripts": [
              {
                "cron": "string",
                "display_name": "string",
                "exit_code": 0,
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "log_path": "string",
                "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
                "run_on_start": true,
                "run_on_stop": true,
                "script": "string",
                "start_blocks_login": true,
                "status": "ok",
                "timeout": 0
              }
            ],
            "started_at": "2019-08-24T14:15:22Z",
            "startup_script_behavior": "blocking",
            "status": "connecting",
            "subsystems": [
              "envbox"
            ],
            "troubleshooting_url": "string",
            "updated_at": "2019-08-24T14:15:22Z",
            "version": "string"
          }
        ],
        "created_at": "2019-08-24T14:15:22Z",
        "daily_cost": 0,
        "hide": true,
        "icon": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
        "metadata": [
          {
            "key": "string",
            "sensitive": true,
            "value": "string"
          }
        ],
        "name": "string",
        "type": "string",
        "workspace_transition": "start"
      }
    ],
    "status": "pending",
    "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
    "template_version_name": "string",
    "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
    "transition": "start",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
    "workspace_name": "string",
    "workspace_owner_avatar_url": "string",
    "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
    "workspace_owner_name": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
workspace_build	codersdk.WorkspaceBuild	false

codersdk.Permission

{
  "action": "application_connect",
  "negate": true,
  "resource_type": "*"
}

Properties

Name	Type	Required	Restrictions	Description
action	codersdk.RBACAction	false
negate	boolean	false		Negate makes this a negative permission
resource_type	codersdk.RBACResource	false

codersdk.PostOAuth2ProviderAppRequest

{
  "callback_url": "string",
  "icon": "string",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
callback_url	string	true
icon	string	false
name	string	true

codersdk.PostWorkspaceUsageRequest

{
  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
  "app_name": "vscode"
}

Properties

Name	Type	Required	Restrictions	Description
agent_id	string	false
app_name	codersdk.UsageAppName	false

codersdk.PprofConfig

{
  "address": {
    "host": "string",
    "port": "string"
  },
  "enable": true
}

Properties

Name	Type	Required	Restrictions	Description
address	serpent.HostPort	false
enable	boolean	false

codersdk.PrebuildsConfig

{
  "failure_hard_limit": 0,
  "reconciliation_backoff_interval": 0,
  "reconciliation_backoff_lookback": 0,
  "reconciliation_interval": 0
}

Properties

Name	Type	Required	Restrictions	Description
failure_hard_limit	integer	false		Failure hard limit defines the maximum number of consecutive failed prebuild attempts allowed before a preset is considered to be in a hard limit state. When a preset hits this limit, no new prebuilds will be created until the limit is reset. FailureHardLimit is disabled when set to zero.
reconciliation_backoff_interval	integer	false		Reconciliation backoff interval specifies the amount of time to increase the backoff interval when errors occur during reconciliation.
reconciliation_backoff_lookback	integer	false		Reconciliation backoff lookback determines the time window to look back when calculating the number of failed prebuilds, which influences the backoff strategy.
reconciliation_interval	integer	false		Reconciliation interval defines how often the workspace prebuilds state should be reconciled.

codersdk.PrebuildsSettings

{
  "reconciliation_paused": true
}

Properties

Name	Type	Required	Restrictions	Description
reconciliation_paused	boolean	false

codersdk.Preset

{
  "default": true,
  "description": "string",
  "desiredPrebuildInstances": 0,
  "icon": "string",
  "id": "string",
  "name": "string",
  "parameters": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
default	boolean	false
description	string	false
desiredPrebuildInstances	integer	false
icon	string	false
id	string	false
name	string	false
parameters	array of codersdk.PresetParameter	false

codersdk.PresetParameter

{
  "name": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
name	string	false
value	string	false

codersdk.PreviewParameter

{
  "default_value": {
    "valid": true,
    "value": "string"
  },
  "description": "string",
  "diagnostics": [
    {
      "detail": "string",
      "extra": {
        "code": "string"
      },
      "severity": "error",
      "summary": "string"
    }
  ],
  "display_name": "string",
  "ephemeral": true,
  "form_type": "",
  "icon": "string",
  "mutable": true,
  "name": "string",
  "options": [
    {
      "description": "string",
      "icon": "string",
      "name": "string",
      "value": {
        "valid": true,
        "value": "string"
      }
    }
  ],
  "order": 0,
  "required": true,
  "styling": {
    "disabled": true,
    "label": "string",
    "mask_input": true,
    "placeholder": "string"
  },
  "type": "string",
  "validations": [
    {
      "validation_error": "string",
      "validation_max": 0,
      "validation_min": 0,
      "validation_monotonic": "string",
      "validation_regex": "string"
    }
  ],
  "value": {
    "valid": true,
    "value": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
default_value	codersdk.NullHCLString	false
description	string	false
diagnostics	array of codersdk.FriendlyDiagnostic	false
display_name	string	false
ephemeral	boolean	false
form_type	codersdk.ParameterFormType	false
icon	string	false
mutable	boolean	false
name	string	false
options	array of codersdk.PreviewParameterOption	false
order	integer	false		legacy_variable_name was removed (= 14)
required	boolean	false
styling	codersdk.PreviewParameterStyling	false
type	codersdk.OptionType	false
validations	array of codersdk.PreviewParameterValidation	false
value	codersdk.NullHCLString	false

codersdk.PreviewParameterOption

{
  "description": "string",
  "icon": "string",
  "name": "string",
  "value": {
    "valid": true,
    "value": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
icon	string	false
name	string	false
value	codersdk.NullHCLString	false

codersdk.PreviewParameterStyling

{
  "disabled": true,
  "label": "string",
  "mask_input": true,
  "placeholder": "string"
}

Properties

Name	Type	Required	Restrictions	Description
disabled	boolean	false
label	string	false
mask_input	boolean	false
placeholder	string	false

codersdk.PreviewParameterValidation

{
  "validation_error": "string",
  "validation_max": 0,
  "validation_min": 0,
  "validation_monotonic": "string",
  "validation_regex": "string"
}

Properties

Name	Type	Required	Restrictions	Description
validation_error	string	false
validation_max	integer	false
validation_min	integer	false
validation_monotonic	string	false
validation_regex	string	false		All validation attributes are optional.

codersdk.PrometheusConfig

{
  "address": {
    "host": "string",
    "port": "string"
  },
  "aggregate_agent_stats_by": [
    "string"
  ],
  "collect_agent_stats": true,
  "collect_db_metrics": true,
  "enable": true
}

Properties

Name	Type	Required	Restrictions	Description
address	serpent.HostPort	false
aggregate_agent_stats_by	array of string	false
collect_agent_stats	boolean	false
collect_db_metrics	boolean	false
enable	boolean	false

codersdk.ProvisionerConfig

{
  "daemon_poll_interval": 0,
  "daemon_poll_jitter": 0,
  "daemon_psk": "string",
  "daemon_types": [
    "string"
  ],
  "daemons": 0,
  "force_cancel_interval": 0
}

Properties

Name	Type	Required	Restrictions	Description
daemon_poll_interval	integer	false
daemon_poll_jitter	integer	false
daemon_psk	string	false
daemon_types	array of string	false
daemons	integer	false		Daemons is the number of built-in terraform provisioners.
force_cancel_interval	integer	false

codersdk.ProvisionerDaemon

{
  "api_version": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "current_job": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "status": "pending",
    "template_display_name": "string",
    "template_icon": "string",
    "template_name": "string"
  },
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "key_id": "1e779c8a-6786-4c89-b7c3-a6666f5fd6b5",
  "key_name": "string",
  "last_seen_at": "2019-08-24T14:15:22Z",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "previous_job": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "status": "pending",
    "template_display_name": "string",
    "template_icon": "string",
    "template_name": "string"
  },
  "provisioners": [
    "string"
  ],
  "status": "offline",
  "tags": {
    "property1": "string",
    "property2": "string"
  },
  "version": "string"
}

Properties

Name	Type	Required	Restrictions	Description
api_version	string	false
created_at	string	false
current_job	codersdk.ProvisionerDaemonJob	false
id	string	false
key_id	string	false
key_name	string	false		Optional fields.
last_seen_at	string	false
name	string	false
organization_id	string	false
previous_job	codersdk.ProvisionerDaemonJob	false
provisioners	array of string	false
status	codersdk.ProvisionerDaemonStatus	false
tags	object	false
» [any property]	string	false
version	string	false

Enumerated Values

Property	Value(s)
status	busy, idle, offline

codersdk.ProvisionerDaemonJob

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "status": "pending",
  "template_display_name": "string",
  "template_icon": "string",
  "template_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	false
status	codersdk.ProvisionerJobStatus	false
template_display_name	string	false
template_icon	string	false
template_name	string	false

Enumerated Values

Property	Value(s)
status	canceled, canceling, failed, pending, running, succeeded

codersdk.ProvisionerDaemonStatus

"offline"

Properties

Enumerated Values

Value(s)
busy, idle, offline

codersdk.ProvisionerJob

{
  "available_workers": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "canceled_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "error": "string",
  "error_code": "REQUIRED_TEMPLATE_VARIABLES",
  "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
  "input": {
    "error": "string",
    "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
    "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
  },
  "logs_overflowed": true,
  "metadata": {
    "template_display_name": "string",
    "template_icon": "string",
    "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
    "template_name": "string",
    "template_version_name": "string",
    "workspace_build_transition": "start",
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
    "workspace_name": "string"
  },
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "queue_position": 0,
  "queue_size": 0,
  "started_at": "2019-08-24T14:15:22Z",
  "status": "pending",
  "tags": {
    "property1": "string",
    "property2": "string"
  },
  "type": "template_version_import",
  "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
  "worker_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
available_workers	array of string	false
canceled_at	string	false
completed_at	string	false
created_at	string	false
error	string	false
error_code	codersdk.JobErrorCode	false
file_id	string	false
id	string	false
initiator_id	string	false
input	codersdk.ProvisionerJobInput	false
logs_overflowed	boolean	false
metadata	codersdk.ProvisionerJobMetadata	false
organization_id	string	false
queue_position	integer	false
queue_size	integer	false
started_at	string	false
status	codersdk.ProvisionerJobStatus	false
tags	object	false
» [any property]	string	false
type	codersdk.ProvisionerJobType	false
worker_id	string	false
worker_name	string	false

Enumerated Values

Property	Value(s)
error_code	INSUFFICIENT_QUOTA, REQUIRED_TEMPLATE_VARIABLES
status	canceled, canceling, failed, pending, running, succeeded

codersdk.ProvisionerJobInput

{
  "error": "string",
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
  "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
}

Properties

Name	Type	Required	Restrictions	Description
error	string	false
template_version_id	string	false
workspace_build_id	string	false

codersdk.ProvisionerJobLog

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": 0,
  "log_level": "trace",
  "log_source": "provisioner_daemon",
  "output": "string",
  "stage": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	integer	false
log_level	codersdk.LogLevel	false
log_source	codersdk.LogSource	false
output	string	false
stage	string	false

Enumerated Values

Property	Value(s)
log_level	debug, error, info, trace, warn

codersdk.ProvisionerJobMetadata

{
  "template_display_name": "string",
  "template_icon": "string",
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "template_name": "string",
  "template_version_name": "string",
  "workspace_build_transition": "start",
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
  "workspace_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
template_display_name	string	false
template_icon	string	false
template_id	string	false
template_name	string	false
template_version_name	string	false
workspace_build_transition	codersdk.WorkspaceTransition	false
workspace_id	string	false
workspace_name	string	false

codersdk.ProvisionerJobStatus

"pending"

Properties

Enumerated Values

Value(s)
canceled, canceling, failed, pending, running, succeeded, unknown

codersdk.ProvisionerJobType

"template_version_import"

Properties

Enumerated Values

Value(s)
template_version_dry_run, template_version_import, workspace_build

codersdk.ProvisionerKey

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
  "tags": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	string	false
name	string	false
organization	string	false
tags	codersdk.ProvisionerKeyTags	false

codersdk.ProvisionerKeyDaemons

{
  "daemons": [
    {
      "api_version": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "current_job": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "status": "pending",
        "template_display_name": "string",
        "template_icon": "string",
        "template_name": "string"
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "key_id": "1e779c8a-6786-4c89-b7c3-a6666f5fd6b5",
      "key_name": "string",
      "last_seen_at": "2019-08-24T14:15:22Z",
      "name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "previous_job": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "status": "pending",
        "template_display_name": "string",
        "template_icon": "string",
        "template_name": "string"
      },
      "provisioners": [
        "string"
      ],
      "status": "offline",
      "tags": {
        "property1": "string",
        "property2": "string"
      },
      "version": "string"
    }
  ],
  "key": {
    "created_at": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "organization": "452c1a86-a0af-475b-b03f-724878b0f387",
    "tags": {
      "property1": "string",
      "property2": "string"
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
daemons	array of codersdk.ProvisionerDaemon	false
key	codersdk.ProvisionerKey	false

codersdk.ProvisionerKeyTags

{
  "property1": "string",
  "property2": "string"
}

Properties

Name	Type	Required	Restrictions	Description
[any property]	string	false

codersdk.ProvisionerLogLevel

"debug"

Properties

Enumerated Values

Value(s)
debug

codersdk.ProvisionerStorageMethod

"file"

Properties

Enumerated Values

Value(s)
file

codersdk.ProvisionerTiming

{
  "action": "string",
  "ended_at": "2019-08-24T14:15:22Z",
  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "resource": "string",
  "source": "string",
  "stage": "init",
  "started_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
action	string	false
ended_at	string	false
job_id	string	false
resource	string	false
source	string	false
stage	codersdk.TimingStage	false
started_at	string	false

codersdk.ProxyHealthReport

{
  "errors": [
    "string"
  ],
  "warnings": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
errors	array of string	false		Errors are problems that prevent the workspace proxy from being healthy
warnings	array of string	false		Warnings do not prevent the workspace proxy from being healthy, but should be addressed.

codersdk.ProxyHealthStatus

"ok"

Properties

Enumerated Values

Value(s)
ok, unhealthy, unreachable, unregistered

codersdk.PutExtendWorkspaceRequest

{
  "deadline": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
deadline	string	true

codersdk.PutOAuth2ProviderAppRequest

{
  "callback_url": "string",
  "icon": "string",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
callback_url	string	true
icon	string	false
name	string	true

codersdk.RBACAction

"application_connect"

Properties

Enumerated Values

Value(s)
application_connect, assign, create, create_agent, delete, delete_agent, read, read_personal, share, ssh, start, stop, unassign, update, update_agent, update_personal, use, view_insights

codersdk.RBACResource

"*"

Properties

Enumerated Values

Value(s)

*, ai_model_price, ai_provider, ai_seat, aibridge_interception, api_key, assign_org_role, assign_role, audit_log, boundary_log, boundary_usage, chat, connection_log, crypto_key, debug_info, deployment_config, deployment_stats, file, group, group_member, idpsync_settings, inbox_notification, license, notification_message, notification_preference, notification_template, oauth2_app, oauth2_app_code_token, oauth2_app_secret, organization, organization_member, prebuilt_workspace, provisioner_daemon, provisioner_jobs, replicas, system, tailnet_coordinator, task, template, usage_event, user, user_secret, user_skill, webpush_subscription, workspace, workspace_agent_devcontainers, workspace_agent_resource_monitor, workspace_dormant, workspace_proxy

codersdk.RateLimitConfig

{
  "api": 0,
  "disable_all": true
}

Properties

Name	Type	Required	Restrictions	Description
api	integer	false
disable_all	boolean	false

codersdk.ReducedUser

{
  "avatar_url": "http://example.com",
  "created_at": "2019-08-24T14:15:22Z",
  "email": "user@example.com",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "is_service_account": true,
  "last_seen_at": "2019-08-24T14:15:22Z",
  "login_type": "",
  "name": "string",
  "status": "active",
  "theme_preference": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
created_at	string	true
email	string	true
id	string	true
is_service_account	boolean	false
last_seen_at	string	false
login_type	codersdk.LoginType	false
name	string	false
status	codersdk.UserStatus	false
theme_preference	string	false		Deprecated: this value should be retrieved from codersdk.UserPreferenceSettings instead.
updated_at	string	false
username	string	true

Enumerated Values

Property	Value(s)
status	active, suspended

codersdk.Region

{
  "display_name": "string",
  "healthy": true,
  "icon_url": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "path_app_url": "string",
  "wildcard_hostname": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
healthy	boolean	false
icon_url	string	false
id	string	false
name	string	false
path_app_url	string	false		Path app URL is the URL to the base path for path apps. Optional unless wildcard_hostname is set. E.g. https://us.example.com
wildcard_hostname	string	false		Wildcard hostname is the wildcard hostname for subdomain apps. E.g. .us.example.com E.g.--suffix.au.example.com Optional. Does not need to be on the same domain as PathAppURL.

codersdk.RegionsResponse-codersdk_Region

{
  "regions": [
    {
      "display_name": "string",
      "healthy": true,
      "icon_url": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "path_app_url": "string",
      "wildcard_hostname": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
regions	array of codersdk.Region	false

codersdk.RegionsResponse-codersdk_WorkspaceProxy

{
  "regions": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "deleted": true,
      "derp_enabled": true,
      "derp_only": true,
      "display_name": "string",
      "healthy": true,
      "icon_url": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "path_app_url": "string",
      "status": {
        "checked_at": "2019-08-24T14:15:22Z",
        "report": {
          "errors": [
            "string"
          ],
          "warnings": [
            "string"
          ]
        },
        "status": "ok"
      },
      "updated_at": "2019-08-24T14:15:22Z",
      "version": "string",
      "wildcard_hostname": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
regions	array of codersdk.WorkspaceProxy	false

codersdk.Replica

{
  "created_at": "2019-08-24T14:15:22Z",
  "database_latency": 0,
  "error": "string",
  "hostname": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "region_id": 0,
  "relay_address": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false		Created at is the timestamp when the replica was first seen.
database_latency	integer	false		Database latency is the latency in microseconds to the database.
error	string	false		Error is the replica error.
hostname	string	false		Hostname is the hostname of the replica.
id	string	false		ID is the unique identifier for the replica.
region_id	integer	false		Region ID is the region of the replica.
relay_address	string	false		Relay address is the accessible address to relay DERP connections.

codersdk.RequestOneTimePasscodeRequest

{
  "email": "user@example.com"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	true

codersdk.ResolveAutostartResponse

{
  "parameter_mismatch": true
}

Properties

Name	Type	Required	Restrictions	Description
parameter_mismatch	boolean	false

codersdk.ResourceType

"template"

Properties

Enumerated Values

Value(s)

ai_provider, ai_provider_key, ai_seat, api_key, chat, convert_login, custom_role, git_ssh_key, group, group_ai_budget, health_settings, idp_sync_settings_group, idp_sync_settings_organization, idp_sync_settings_role, license, notification_template, notifications_settings, oauth2_provider_app, oauth2_provider_app_secret, organization, organization_member, prebuilds_settings, task, template, template_version, user, user_secret, user_skill, workspace, workspace_agent, workspace_app, workspace_build, workspace_proxy

codersdk.Response

{
  "detail": "string",
  "message": "string",
  "validations": [
    {
      "detail": "string",
      "field": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
detail	string	false		Detail is a debug message that provides further insight into why the action failed. This information can be technical and a regular golang err.Error() text. - "database: too many open connections" - "stat: too many open files"
message	string	false		Message is an actionable message that depicts actions the request took. These messages should be fully formed sentences with proper punctuation. Examples: - "A user has been created." - "Failed to create a user."
validations	array of codersdk.ValidationError	false		Validations are form field-specific friendly error messages. They will be shown on a form field in the UI. These can also be used to add additional context if there is a set of errors in the primary 'Message'.

codersdk.ResumeTaskResponse

{
  "workspace_build": {
    "build_number": 0,
    "created_at": "2019-08-24T14:15:22Z",
    "daily_cost": 0,
    "deadline": "2019-08-24T14:15:22Z",
    "has_ai_task": true,
    "has_external_agent": true,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
    "initiator_name": "string",
    "job": {
      "available_workers": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "canceled_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "error": "string",
      "error_code": "REQUIRED_TEMPLATE_VARIABLES",
      "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
      "input": {
        "error": "string",
        "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
        "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
      },
      "logs_overflowed": true,
      "metadata": {
        "template_display_name": "string",
        "template_icon": "string",
        "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
        "template_name": "string",
        "template_version_name": "string",
        "workspace_build_transition": "start",
        "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
        "workspace_name": "string"
      },
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "queue_position": 0,
      "queue_size": 0,
      "started_at": "2019-08-24T14:15:22Z",
      "status": "pending",
      "tags": {
        "property1": "string",
        "property2": "string"
      },
      "type": "template_version_import",
      "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
      "worker_name": "string"
    },
    "matched_provisioners": {
      "available": 0,
      "count": 0,
      "most_recently_seen": "2019-08-24T14:15:22Z"
    },
    "max_deadline": "2019-08-24T14:15:22Z",
    "reason": "initiator",
    "resources": [
      {
        "agents": [
          {
            "api_version": "string",
            "apps": [
              {
                "command": "string",
                "display_name": "string",
                "external": true,
                "group": "string",
                "health": "disabled",
                "healthcheck": {
                  "interval": 0,
                  "threshold": 0,
                  "url": "string"
                },
                "hidden": true,
                "icon": "string",
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "open_in": "slim-window",
                "sharing_level": "owner",
                "slug": "string",
                "statuses": [
                  {
                    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
                    "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
                    "created_at": "2019-08-24T14:15:22Z",
                    "icon": "string",
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "message": "string",
                    "needs_user_attention": true,
                    "state": "working",
                    "uri": "string",
                    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
                  }
                ],
                "subdomain": true,
                "subdomain_name": "string",
                "tooltip": "string",
                "url": "string"
              }
            ],
            "architecture": "string",
            "connection_timeout_seconds": 0,
            "created_at": "2019-08-24T14:15:22Z",
            "directory": "string",
            "disconnected_at": "2019-08-24T14:15:22Z",
            "display_apps": [
              "vscode"
            ],
            "environment_variables": {
              "property1": "string",
              "property2": "string"
            },
            "expanded_directory": "string",
            "first_connected_at": "2019-08-24T14:15:22Z",
            "health": {
              "healthy": false,
              "reason": "agent has lost connection"
            },
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "instance_id": "string",
            "last_connected_at": "2019-08-24T14:15:22Z",
            "latency": {
              "property1": {
                "latency_ms": 0,
                "preferred": true
              },
              "property2": {
                "latency_ms": 0,
                "preferred": true
              }
            },
            "lifecycle_state": "created",
            "log_sources": [
              {
                "created_at": "2019-08-24T14:15:22Z",
                "display_name": "string",
                "icon": "string",
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
              }
            ],
            "logs_length": 0,
            "logs_overflowed": true,
            "name": "string",
            "operating_system": "string",
            "parent_id": {
              "uuid": "string",
              "valid": true
            },
            "ready_at": "2019-08-24T14:15:22Z",
            "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
            "scripts": [
              {
                "cron": "string",
                "display_name": "string",
                "exit_code": 0,
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "log_path": "string",
                "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
                "run_on_start": true,
                "run_on_stop": true,
                "script": "string",
                "start_blocks_login": true,
                "status": "ok",
                "timeout": 0
              }
            ],
            "started_at": "2019-08-24T14:15:22Z",
            "startup_script_behavior": "blocking",
            "status": "connecting",
            "subsystems": [
              "envbox"
            ],
            "troubleshooting_url": "string",
            "updated_at": "2019-08-24T14:15:22Z",
            "version": "string"
          }
        ],
        "created_at": "2019-08-24T14:15:22Z",
        "daily_cost": 0,
        "hide": true,
        "icon": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
        "metadata": [
          {
            "key": "string",
            "sensitive": true,
            "value": "string"
          }
        ],
        "name": "string",
        "type": "string",
        "workspace_transition": "start"
      }
    ],
    "status": "pending",
    "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
    "template_version_name": "string",
    "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
    "transition": "start",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
    "workspace_name": "string",
    "workspace_owner_avatar_url": "string",
    "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
    "workspace_owner_name": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
workspace_build	codersdk.WorkspaceBuild	false

codersdk.RetentionConfig

{
  "api_keys": 0,
  "audit_logs": 0,
  "connection_logs": 0,
  "workspace_agent_logs": 0
}

Properties

Name	Type	Required	Restrictions	Description
api_keys	integer	false		Api keys controls how long expired API keys are retained before being deleted. Keys are only deleted if they have been expired for at least this duration. Defaults to 7 days to preserve existing behavior.
audit_logs	integer	false		Audit logs controls how long audit log entries are retained. Set to 0 to disable (keep indefinitely).
connection_logs	integer	false		Connection logs controls how long connection log entries are retained. Set to 0 to disable (keep indefinitely).
workspace_agent_logs	integer	false		Workspace agent logs controls how long workspace agent logs are retained. Logs are deleted if the agent hasn't connected within this period. Logs from the latest build are always retained regardless of age. Defaults to 7 days to preserve existing behavior.

codersdk.Role

{
  "display_name": "string",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_member_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "organization_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "site_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ],
  "user_permissions": [
    {
      "action": "application_connect",
      "negate": true,
      "resource_type": "*"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
name	string	false
organization_id	string	false
organization_member_permissions	array of codersdk.Permission	false		Organization member permissions are specific for the organization in the field 'OrganizationID' above.
organization_permissions	array of codersdk.Permission	false		Organization permissions are specific for the organization in the field 'OrganizationID' above.
site_permissions	array of codersdk.Permission	false
user_permissions	array of codersdk.Permission	false

codersdk.RoleSyncSettings

{
  "field": "string",
  "mapping": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
field	string	false		Field is the name of the claim field that specifies what organization roles a user should be given. If empty, no roles will be synced.
mapping	object	false		Mapping is a map from OIDC groups to Coder organization roles.
» [any property]	array of string	false

codersdk.SSHConfig

{
  "deploymentName": "string",
  "sshconfigOptions": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
deploymentName	string	false		Deploymentname is the config-ssh Hostname prefix
sshconfigOptions	array of string	false		Sshconfigoptions are additional options to add to the ssh config file. This will override defaults.

codersdk.SSHConfigResponse

{
  "hostname_prefix": "string",
  "hostname_suffix": "string",
  "ssh_config_options": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
hostname_prefix	string	false		Hostname prefix is the prefix we append to workspace names for SSH hostnames. Deprecated: use HostnameSuffix instead.
hostname_suffix	string	false		Hostname suffix is the suffix to append to workspace names for SSH hostnames.
ssh_config_options	object	false
» [any property]	string	false

codersdk.ServerSentEvent

{
  "data": null,
  "type": "ping"
}

Properties

Name	Type	Required	Restrictions	Description
data	any	false
type	codersdk.ServerSentEventType	false

codersdk.ServerSentEventType

"ping"

Properties

Enumerated Values

Value(s)
data, error, ping

codersdk.SessionCountDeploymentStats

{
  "jetbrains": 0,
  "reconnecting_pty": 0,
  "ssh": 0,
  "vscode": 0
}

Properties

Name	Type	Required	Restrictions	Description
jetbrains	integer	false
reconnecting_pty	integer	false
ssh	integer	false
vscode	integer	false

codersdk.SessionLifetime

{
  "default_duration": 0,
  "default_token_lifetime": 0,
  "disable_expiry_refresh": true,
  "max_admin_token_lifetime": 0,
  "max_token_lifetime": 0,
  "refresh_default_duration": 0
}

Properties

Name	Type	Required	Restrictions	Description
default_duration	integer	false		Default duration is only for browser, workspace app and oauth sessions.
default_token_lifetime	integer	false
disable_expiry_refresh	boolean	false		Disable expiry refresh will disable automatically refreshing api keys when they are used from the api. This means the api key lifetime at creation is the lifetime of the api key.
max_admin_token_lifetime	integer	false
max_token_lifetime	integer	false
refresh_default_duration	integer	false		Refresh default duration is the default lifetime for OAuth2 refresh tokens. This should generally be longer than access token lifetimes to allow refreshing after access token expiry.

codersdk.ShareableWorkspaceOwners

"none"

Properties

Enumerated Values

Value(s)
everyone, none, service_accounts

codersdk.SharedWorkspaceActor

{
  "actor_type": "group",
  "avatar_url": "http://example.com",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "roles": [
    "admin"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
actor_type	codersdk.SharedWorkspaceActorType	false
avatar_url	string	false
id	string	false
name	string	false
roles	array of codersdk.WorkspaceRole	false

Enumerated Values

Property	Value(s)
actor_type	group, user

codersdk.SharedWorkspaceActorType

"group"

Properties

Enumerated Values

Value(s)
group, user

codersdk.SlimRole

{
  "display_name": "string",
  "name": "string",
  "organization_id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
name	string	false
organization_id	string	false

codersdk.StatsCollectionConfig

{
  "usage_stats": {
    "enable": true
  }
}

Properties

Name	Type	Required	Restrictions	Description
usage_stats	codersdk.UsageStatsConfig	false

codersdk.SupportConfig

{
  "links": {
    "value": [
      {
        "icon": "bug",
        "location": "navbar",
        "name": "string",
        "target": "string"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
links	serpent.Struct-array_codersdk_LinkConfig	false

codersdk.SwaggerConfig

{
  "enable": true
}

Properties

Name	Type	Required	Restrictions	Description
enable	boolean	false

codersdk.TLSConfig

{
  "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"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
address	serpent.HostPort	false
allow_insecure_ciphers	boolean	false
cert_file	array of string	false
client_auth	string	false
client_ca_file	string	false
client_cert_file	string	false
client_key_file	string	false
enable	boolean	false
key_file	array of string	false
min_version	string	false
redirect_http	boolean	false
supported_ciphers	array of string	false

codersdk.Task

{
  "created_at": "2019-08-24T14:15:22Z",
  "current_state": {
    "message": "string",
    "state": "working",
    "timestamp": "2019-08-24T14:15:22Z",
    "uri": "string"
  },
  "display_name": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "initial_prompt": "string",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "owner_avatar_url": "string",
  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
  "owner_name": "string",
  "status": "pending",
  "template_display_name": "string",
  "template_icon": "string",
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "template_name": "string",
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
  "updated_at": "2019-08-24T14:15:22Z",
  "workspace_agent_health": {
    "healthy": false,
    "reason": "agent has lost connection"
  },
  "workspace_agent_id": {
    "uuid": "string",
    "valid": true
  },
  "workspace_agent_lifecycle": "created",
  "workspace_app_id": {
    "uuid": "string",
    "valid": true
  },
  "workspace_build_number": 0,
  "workspace_id": {
    "uuid": "string",
    "valid": true
  },
  "workspace_name": "string",
  "workspace_status": "pending"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
current_state	codersdk.TaskStateEntry	false
display_name	string	false
id	string	false
initial_prompt	string	false
name	string	false
organization_id	string	false
owner_avatar_url	string	false
owner_id	string	false
owner_name	string	false
status	codersdk.TaskStatus	false
template_display_name	string	false
template_icon	string	false
template_id	string	false
template_name	string	false
template_version_id	string	false
updated_at	string	false
workspace_agent_health	codersdk.WorkspaceAgentHealth	false
workspace_agent_id	uuid.NullUUID	false
workspace_agent_lifecycle	codersdk.WorkspaceAgentLifecycle	false
workspace_app_id	uuid.NullUUID	false
workspace_build_number	integer	false
workspace_id	uuid.NullUUID	false
workspace_name	string	false
workspace_status	codersdk.WorkspaceStatus	false

Enumerated Values

Property	Value(s)
status	active, error, initializing, paused, pending, unknown
workspace_status	canceled, canceling, deleted, deleting, failed, pending, running, starting, stopped, stopping

codersdk.TaskLogEntry

{
  "content": "string",
  "id": 0,
  "time": "2019-08-24T14:15:22Z",
  "type": "input"
}

Properties

Name	Type	Required	Restrictions	Description
content	string	false
id	integer	false
time	string	false
type	codersdk.TaskLogType	false

codersdk.TaskLogType

"input"

Properties

Enumerated Values

Value(s)
input, output

codersdk.TaskLogsResponse

{
  "logs": [
    {
      "content": "string",
      "id": 0,
      "time": "2019-08-24T14:15:22Z",
      "type": "input"
    }
  ],
  "snapshot": true,
  "snapshot_at": "string"
}

Properties

Name	Type	Required	Restrictions	Description
logs	array of codersdk.TaskLogEntry	false
snapshot	boolean	false
snapshot_at	string	false

codersdk.TaskSendRequest

{
  "input": "string"
}

Properties

Name	Type	Required	Restrictions	Description
input	string	false

codersdk.TaskState

"working"

Properties

Enumerated Values

Value(s)
complete, failed, idle, working

codersdk.TaskStateEntry

{
  "message": "string",
  "state": "working",
  "timestamp": "2019-08-24T14:15:22Z",
  "uri": "string"
}

Properties

Name	Type	Required	Restrictions	Description
message	string	false
state	codersdk.TaskState	false
timestamp	string	false
uri	string	false

codersdk.TaskStatus

"pending"

Properties

Enumerated Values

Value(s)
active, error, initializing, paused, pending, unknown

codersdk.TasksListResponse

{
  "count": 0,
  "tasks": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "current_state": {
        "message": "string",
        "state": "working",
        "timestamp": "2019-08-24T14:15:22Z",
        "uri": "string"
      },
      "display_name": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "initial_prompt": "string",
      "name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "owner_avatar_url": "string",
      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
      "owner_name": "string",
      "status": "pending",
      "template_display_name": "string",
      "template_icon": "string",
      "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
      "template_name": "string",
      "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
      "updated_at": "2019-08-24T14:15:22Z",
      "workspace_agent_health": {
        "healthy": false,
        "reason": "agent has lost connection"
      },
      "workspace_agent_id": {
        "uuid": "string",
        "valid": true
      },
      "workspace_agent_lifecycle": "created",
      "workspace_app_id": {
        "uuid": "string",
        "valid": true
      },
      "workspace_build_number": 0,
      "workspace_id": {
        "uuid": "string",
        "valid": true
      },
      "workspace_name": "string",
      "workspace_status": "pending"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
tasks	array of codersdk.Task	false

codersdk.TelemetryConfig

{
  "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": {}
  }
}

Properties

Name	Type	Required	Restrictions	Description
enable	boolean	false
trace	boolean	false
url	serpent.URL	false

codersdk.Template

{
  "active_user_count": 0,
  "active_version_id": "eae64611-bd53-4a80-bb77-df1e432c0fbc",
  "activity_bump_ms": 0,
  "allow_user_autostart": true,
  "allow_user_autostop": true,
  "allow_user_cancel_workspace_jobs": true,
  "autostart_requirement": {
    "days_of_week": [
      "monday"
    ]
  },
  "autostop_requirement": {
    "days_of_week": [
      "monday"
    ],
    "weeks": 0
  },
  "build_time_stats": {
    "property1": {
      "p50": 123,
      "p95": 146
    },
    "property2": {
      "p50": 123,
      "p95": 146
    }
  },
  "cors_behavior": "simple",
  "created_at": "2019-08-24T14:15:22Z",
  "created_by_id": "9377d689-01fb-4abf-8450-3368d2c1924f",
  "created_by_name": "string",
  "default_ttl_ms": 0,
  "deleted": true,
  "deprecated": true,
  "deprecation_message": "string",
  "description": "string",
  "disable_module_cache": true,
  "display_name": "string",
  "failure_ttl_ms": 0,
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "max_port_share_level": "owner",
  "name": "string",
  "organization_display_name": "string",
  "organization_icon": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_name": "string",
  "provisioner": "terraform",
  "require_active_version": true,
  "time_til_dormant_autodelete_ms": 0,
  "time_til_dormant_ms": 0,
  "updated_at": "2019-08-24T14:15:22Z",
  "use_classic_parameter_flow": true
}

Properties

Name	Type	Required	Restrictions	Description
active_user_count	integer	false		Active user count is set to -1 when loading.
active_version_id	string	false
activity_bump_ms	integer	false
allow_user_autostart	boolean	false		Allow user autostart and AllowUserAutostop are enterprise-only. Their values are only used if your license is entitled to use the advanced template scheduling feature.
allow_user_autostop	boolean	false
allow_user_cancel_workspace_jobs	boolean	false
autostart_requirement	codersdk.TemplateAutostartRequirement	false
autostop_requirement	codersdk.TemplateAutostopRequirement	false		Autostop requirement and AutostartRequirement are enterprise features. Its value is only used if your license is entitled to use the advanced template scheduling feature.
build_time_stats	codersdk.TemplateBuildTimeStats	false
cors_behavior	codersdk.CORSBehavior	false
created_at	string	false
created_by_id	string	false
created_by_name	string	false
default_ttl_ms	integer	false
deleted	boolean	false
deprecated	boolean	false
deprecation_message	string	false
description	string	false
disable_module_cache	boolean	false		Disable module cache disables the use of cached Terraform modules during provisioning.
display_name	string	false
failure_ttl_ms	integer	false		Failure ttl ms TimeTilDormantMillis, and TimeTilDormantAutoDeleteMillis are enterprise-only. Their values are used if your license is entitled to use the advanced template scheduling feature.
icon	string	false
id	string	false
max_port_share_level	codersdk.WorkspaceAgentPortShareLevel	false
name	string	false
organization_display_name	string	false
organization_icon	string	false
organization_id	string	false
organization_name	string	false
provisioner	string	false
require_active_version	boolean	false		Require active version mandates that workspaces are built with the active template version.
time_til_dormant_autodelete_ms	integer	false
time_til_dormant_ms	integer	false
updated_at	string	false
use_classic_parameter_flow	boolean	false

Enumerated Values

Property	Value(s)
provisioner	terraform

codersdk.TemplateACL

{
  "group": [
    {
      "avatar_url": "http://example.com",
      "display_name": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "members": [
        {
          "avatar_url": "http://example.com",
          "created_at": "2019-08-24T14:15:22Z",
          "email": "user@example.com",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "is_service_account": true,
          "last_seen_at": "2019-08-24T14:15:22Z",
          "login_type": "",
          "name": "string",
          "status": "active",
          "theme_preference": "string",
          "updated_at": "2019-08-24T14:15:22Z",
          "username": "string"
        }
      ],
      "name": "string",
      "organization_display_name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "organization_name": "string",
      "quota_allowance": 0,
      "role": "admin",
      "source": "user",
      "total_member_count": 0
    }
  ],
  "users": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "has_ai_seat": true,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "organization_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "role": "admin",
      "roles": [
        {
          "display_name": "string",
          "name": "string",
          "organization_id": "string"
        }
      ],
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
group	array of codersdk.TemplateGroup	false
users	array of codersdk.TemplateUser	false

codersdk.TemplateAppUsage

{
  "display_name": "Visual Studio Code",
  "icon": "string",
  "seconds": 80500,
  "slug": "vscode",
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "times_used": 2,
  "type": "builtin"
}

Properties

Name	Type	Required	Restrictions	Description
display_name	string	false
icon	string	false
seconds	integer	false
slug	string	false
template_ids	array of string	false
times_used	integer	false
type	codersdk.TemplateAppsType	false

codersdk.TemplateAppsType

"builtin"

Properties

Enumerated Values

Value(s)
app, builtin

codersdk.TemplateAutostartRequirement

{
  "days_of_week": [
    "monday"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
days_of_week	array of string	false		Days of week is a list of days of the week in which autostart is allowed to happen. If no days are specified, autostart is not allowed.

codersdk.TemplateAutostopRequirement

{
  "days_of_week": [
    "monday"
  ],
  "weeks": 0
}

Properties

Name	Type	Required	Restrictions	Description
days_of_week	array of string	false		Days of week is a list of days of the week on which restarts are required. Restarts happen within the user's quiet hours (in their configured timezone). If no days are specified, restarts are not required. Weekdays cannot be specified twice.
Restarts will only happen on weekdays in this list on weeks which line up with Weeks.
weeks	integer	false		Weeks is the number of weeks between required restarts. Weeks are synced across all workspaces (and Coder deployments) using modulo math on a hardcoded epoch week of January 2nd, 2023 (the first Monday of 2023). Values of 0 or 1 indicate weekly restarts. Values of 2 indicate fortnightly restarts, etc.

codersdk.TemplateBuildTimeStats

{
  "property1": {
    "p50": 123,
    "p95": 146
  },
  "property2": {
    "p50": 123,
    "p95": 146
  }
}

Properties

Name	Type	Required	Restrictions	Description
[any property]	codersdk.TransitionStats	false

codersdk.TemplateBuilderConfig

{
  "disabled": true,
  "registry_url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
disabled	boolean	false
registry_url	string	false

codersdk.TemplateExample

{
  "description": "string",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "markdown": "string",
  "name": "string",
  "tags": [
    "string"
  ],
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
icon	string	false
id	string	false
markdown	string	false
name	string	false
tags	array of string	false
url	string	false

codersdk.TemplateGroup

{
  "avatar_url": "http://example.com",
  "display_name": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "members": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ],
  "name": "string",
  "organization_display_name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_name": "string",
  "quota_allowance": 0,
  "role": "admin",
  "source": "user",
  "total_member_count": 0
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
display_name	string	false
id	string	false
members	array of codersdk.ReducedUser	false
name	string	false
organization_display_name	string	false
organization_id	string	false
organization_name	string	false
quota_allowance	integer	false
role	codersdk.TemplateRole	false
source	codersdk.GroupSource	false
total_member_count	integer	false		How many members are in this group. Shows the total count, even if the user is not authorized to read group member details. May be greater than len(Group.Members).

Enumerated Values

Property	Value(s)
role	admin, use

codersdk.TemplateInsightsIntervalReport

{
  "active_users": 14,
  "end_time": "2019-08-24T14:15:22Z",
  "interval": "week",
  "start_time": "2019-08-24T14:15:22Z",
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
active_users	integer	false
end_time	string	false
interval	codersdk.InsightsReportInterval	false
start_time	string	false
template_ids	array of string	false

codersdk.TemplateInsightsReport

{
  "active_users": 22,
  "apps_usage": [
    {
      "display_name": "Visual Studio Code",
      "icon": "string",
      "seconds": 80500,
      "slug": "vscode",
      "template_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "times_used": 2,
      "type": "builtin"
    }
  ],
  "end_time": "2019-08-24T14:15:22Z",
  "parameters_usage": [
    {
      "description": "string",
      "display_name": "string",
      "name": "string",
      "options": [
        {
          "description": "string",
          "icon": "string",
          "name": "string",
          "value": "string"
        }
      ],
      "template_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "type": "string",
      "values": [
        {
          "count": 0,
          "value": "string"
        }
      ]
    }
  ],
  "start_time": "2019-08-24T14:15:22Z",
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
active_users	integer	false
apps_usage	array of codersdk.TemplateAppUsage	false
end_time	string	false
parameters_usage	array of codersdk.TemplateParameterUsage	false
start_time	string	false
template_ids	array of string	false

codersdk.TemplateInsightsResponse

{
  "interval_reports": [
    {
      "active_users": 14,
      "end_time": "2019-08-24T14:15:22Z",
      "interval": "week",
      "start_time": "2019-08-24T14:15:22Z",
      "template_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ]
    }
  ],
  "report": {
    "active_users": 22,
    "apps_usage": [
      {
        "display_name": "Visual Studio Code",
        "icon": "string",
        "seconds": 80500,
        "slug": "vscode",
        "template_ids": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "times_used": 2,
        "type": "builtin"
      }
    ],
    "end_time": "2019-08-24T14:15:22Z",
    "parameters_usage": [
      {
        "description": "string",
        "display_name": "string",
        "name": "string",
        "options": [
          {
            "description": "string",
            "icon": "string",
            "name": "string",
            "value": "string"
          }
        ],
        "template_ids": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "type": "string",
        "values": [
          {
            "count": 0,
            "value": "string"
          }
        ]
      }
    ],
    "start_time": "2019-08-24T14:15:22Z",
    "template_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
interval_reports	array of codersdk.TemplateInsightsIntervalReport	false
report	codersdk.TemplateInsightsReport	false

codersdk.TemplateParameterUsage

{
  "description": "string",
  "display_name": "string",
  "name": "string",
  "options": [
    {
      "description": "string",
      "icon": "string",
      "name": "string",
      "value": "string"
    }
  ],
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "string",
  "values": [
    {
      "count": 0,
      "value": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
display_name	string	false
name	string	false
options	array of codersdk.TemplateVersionParameterOption	false
template_ids	array of string	false
type	string	false
values	array of codersdk.TemplateParameterValue	false

codersdk.TemplateParameterValue

{
  "count": 0,
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
value	string	false

codersdk.TemplateRole

"admin"

Properties

Enumerated Values

Value(s)
``, admin, use

codersdk.TemplateUser

{
  "avatar_url": "http://example.com",
  "created_at": "2019-08-24T14:15:22Z",
  "email": "user@example.com",
  "has_ai_seat": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "is_service_account": true,
  "last_seen_at": "2019-08-24T14:15:22Z",
  "login_type": "",
  "name": "string",
  "organization_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "role": "admin",
  "roles": [
    {
      "display_name": "string",
      "name": "string",
      "organization_id": "string"
    }
  ],
  "status": "active",
  "theme_preference": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
created_at	string	true
email	string	true
has_ai_seat	boolean	false		Has ai seat intentionally omits omitempty so the API always includes the field, even when false.
id	string	true
is_service_account	boolean	false
last_seen_at	string	false
login_type	codersdk.LoginType	false
name	string	false
organization_ids	array of string	false
role	codersdk.TemplateRole	false
roles	array of codersdk.SlimRole	false
status	codersdk.UserStatus	false
theme_preference	string	false		Deprecated: this value should be retrieved from codersdk.UserPreferenceSettings instead.
updated_at	string	false
username	string	true

Enumerated Values

Property	Value(s)
role	admin, use
status	active, suspended

codersdk.TemplateVersion

{
  "archived": true,
  "created_at": "2019-08-24T14:15:22Z",
  "created_by": {
    "avatar_url": "http://example.com",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "username": "string"
  },
  "has_external_agent": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "job": {
    "available_workers": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "canceled_at": "2019-08-24T14:15:22Z",
    "completed_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "error": "string",
    "error_code": "REQUIRED_TEMPLATE_VARIABLES",
    "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
    "input": {
      "error": "string",
      "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
      "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
    },
    "logs_overflowed": true,
    "metadata": {
      "template_display_name": "string",
      "template_icon": "string",
      "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
      "template_name": "string",
      "template_version_name": "string",
      "workspace_build_transition": "start",
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
      "workspace_name": "string"
    },
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "queue_position": 0,
    "queue_size": 0,
    "started_at": "2019-08-24T14:15:22Z",
    "status": "pending",
    "tags": {
      "property1": "string",
      "property2": "string"
    },
    "type": "template_version_import",
    "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
    "worker_name": "string"
  },
  "matched_provisioners": {
    "available": 0,
    "count": 0,
    "most_recently_seen": "2019-08-24T14:15:22Z"
  },
  "message": "string",
  "name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "readme": "string",
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "updated_at": "2019-08-24T14:15:22Z",
  "warnings": [
    "UNSUPPORTED_WORKSPACES"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
archived	boolean	false
created_at	string	false
created_by	codersdk.MinimalUser	false
has_external_agent	boolean	false
id	string	false
job	codersdk.ProvisionerJob	false
matched_provisioners	codersdk.MatchedProvisioners	false
message	string	false
name	string	false
organization_id	string	false
readme	string	false
template_id	string	false
updated_at	string	false
warnings	array of codersdk.TemplateVersionWarning	false

codersdk.TemplateVersionExternalAuth

{
  "authenticate_url": "string",
  "authenticated": true,
  "display_icon": "string",
  "display_name": "string",
  "id": "string",
  "optional": true,
  "type": "string"
}

Properties

Name	Type	Required	Restrictions	Description
authenticate_url	string	false
authenticated	boolean	false
display_icon	string	false
display_name	string	false
id	string	false
optional	boolean	false
type	string	false

codersdk.TemplateVersionParameter

{
  "default_value": "string",
  "description": "string",
  "description_plaintext": "string",
  "display_name": "string",
  "ephemeral": true,
  "form_type": "",
  "icon": "string",
  "mutable": true,
  "name": "string",
  "options": [
    {
      "description": "string",
      "icon": "string",
      "name": "string",
      "value": "string"
    }
  ],
  "required": true,
  "type": "string",
  "validation_error": "string",
  "validation_max": 0,
  "validation_min": 0,
  "validation_monotonic": "increasing",
  "validation_regex": "string"
}

Properties

Name	Type	Required	Restrictions	Description
default_value	string	false
description	string	false
description_plaintext	string	false
display_name	string	false
ephemeral	boolean	false
form_type	string	false		Form type has an enum value of empty string, "". Keep the leading comma in the enums struct tag.
icon	string	false
mutable	boolean	false
name	string	false
options	array of codersdk.TemplateVersionParameterOption	false
required	boolean	false
type	string	false
validation_error	string	false
validation_max	integer	false
validation_min	integer	false
validation_monotonic	codersdk.ValidationMonotonicOrder	false
validation_regex	string	false

Enumerated Values

Property	Value(s)
form_type	``, checkbox, dropdown, error, input, multi-select, radio, slider, switch, tag-select, textarea
type	bool, list(string), number, string
validation_monotonic	decreasing, increasing

codersdk.TemplateVersionParameterOption

{
  "description": "string",
  "icon": "string",
  "name": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
icon	string	false
name	string	false
value	string	false

codersdk.TemplateVersionVariable

{
  "default_value": "string",
  "description": "string",
  "name": "string",
  "required": true,
  "sensitive": true,
  "type": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
default_value	string	false
description	string	false
name	string	false
required	boolean	false
sensitive	boolean	false
type	string	false
value	string	false

Enumerated Values

Property	Value(s)
type	bool, number, string

codersdk.TemplateVersionWarning

"UNSUPPORTED_WORKSPACES"

Properties

Enumerated Values

Value(s)
UNSUPPORTED_WORKSPACES

codersdk.TerminalFontName

""

Properties

Enumerated Values

Value(s)
``, fira-code, geist-mono, ibm-plex-mono, jetbrains-mono, source-code-pro

codersdk.ThemeMode

""

Properties

Enumerated Values

Value(s)
``, single, sync

codersdk.ThinkingDisplayMode

"auto"

Properties

Enumerated Values

Value(s)
always_collapsed, always_expanded, auto, preview

codersdk.TimingStage

"init"

Properties

Enumerated Values

Value(s)
apply, connect, cron, graph, init, plan, start, stop

codersdk.TokenConfig

{
  "max_token_lifetime": 0
}

Properties

Name	Type	Required	Restrictions	Description
max_token_lifetime	integer	false

codersdk.TraceConfig

{
  "capture_logs": true,
  "data_dog": true,
  "enable": true,
  "honeycomb_api_key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
capture_logs	boolean	false
data_dog	boolean	false
enable	boolean	false
honeycomb_api_key	string	false

codersdk.TransitionStats

{
  "p50": 123,
  "p95": 146
}

Properties

Name	Type	Required	Restrictions	Description
p50	integer	false
p95	integer	false

codersdk.UpdateAIProviderRequest

{
  "api_keys": [
    {
      "api_key": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    }
  ],
  "base_url": "string",
  "display_name": "string",
  "enabled": true,
  "settings": {}
}

Properties

Name	Type	Required	Restrictions	Description
api_keys	array of codersdk.AIProviderKeyMutation	false
base_url	string	false
display_name	string	false
enabled	boolean	false
settings	codersdk.AIProviderSettings	false

codersdk.UpdateActiveTemplateVersion

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true

codersdk.UpdateAppearanceConfig

{
  "announcement_banners": [
    {
      "background_color": "string",
      "enabled": true,
      "message": "string"
    }
  ],
  "application_name": "string",
  "logo_url": "string",
  "service_banner": {
    "background_color": "string",
    "enabled": true,
    "message": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
announcement_banners	array of codersdk.BannerConfig	false
application_name	string	false
logo_url	string	false
service_banner	codersdk.BannerConfig	false		Deprecated: ServiceBanner has been replaced by AnnouncementBanners.

codersdk.UpdateChatACL

{
  "group_roles": {
    "property1": "read",
    "property2": "read"
  },
  "user_roles": {
    "property1": "read",
    "property2": "read"
  }
}

Properties

Name	Type	Required	Restrictions	Description
group_roles	object	false
» [any property]	codersdk.ChatRole	false
user_roles	object	false
» [any property]	codersdk.ChatRole	false

codersdk.UpdateChatRequest

{
  "archived": true,
  "labels": {
    "property1": "string",
    "property2": "string"
  },
  "pin_order": 0,
  "plan_mode": "plan",
  "title": "string",
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}

Properties

Name	Type	Required	Restrictions	Description
archived	boolean	false
labels	object	false
» [any property]	string	false
pin_order	integer	false		Pin order controls the chat's pinned state and position. - nil: no change to pin state. - 0: unpin the chat. - >0 (chat is unpinned): pin the chat, appending it to the end of the pinned list. The specific value is ignored; the server assigns the next available position. - >0 (chat is already pinned): move the chat to the requested position, shifting neighbors as needed. The value is clamped to [1, pinned_count].
plan_mode	codersdk.ChatPlanMode	false		Plan mode switches the chat's persistent plan mode. nil: no change, ptr to "plan": enable, ptr to "": clear.
title	string	false
workspace_id	string	false

codersdk.UpdateChatRetentionDaysRequest

{
  "retention_days": 0
}

Properties

Name	Type	Required	Restrictions	Description
retention_days	integer	false

codersdk.UpdateCheckResponse

{
  "current": true,
  "url": "string",
  "version": "string"
}

Properties

Name	Type	Required	Restrictions	Description
current	boolean	false		Current indicates whether the server version is the same as the latest.
url	string	false		URL to download the latest release of Coder.
version	string	false		Version is the semantic version for the latest release of Coder.

codersdk.UpdateOrganizationRequest

{
  "description": "string",
  "display_name": "string",
  "icon": "string",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
display_name	string	false
icon	string	false
name	string	false

codersdk.UpdateRoles

{
  "roles": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
roles	array of string	false

codersdk.UpdateTaskInputRequest

{
  "input": "string"
}

Properties

Name	Type	Required	Restrictions	Description
input	string	false

codersdk.UpdateTemplateACL

{
  "group_perms": {
    "8bd26b20-f3e8-48be-a903-46bb920cf671": "use",
    "<group_id>": "admin"
  },
  "user_perms": {
    "4df59e74-c027-470b-ab4d-cbba8963a5e9": "use",
    "<user_id>": "admin"
  }
}

Properties

Name	Type	Required	Restrictions	Description
group_perms	object	false		Group perms is a mapping from valid group UUIDs to the template role they should be granted. To remove a group from the template, use "" as the role (available as a constant named codersdk.TemplateRoleDeleted)
» [any property]	codersdk.TemplateRole	false
user_perms	object	false		User perms is a mapping from valid user UUIDs to the template role they should be granted. To remove a user from the template, use "" as the role (available as a constant named codersdk.TemplateRoleDeleted)
» [any property]	codersdk.TemplateRole	false

codersdk.UpdateTemplateMeta

{
  "activity_bump_ms": 0,
  "allow_user_autostart": true,
  "allow_user_autostop": true,
  "allow_user_cancel_workspace_jobs": true,
  "autostart_requirement": {
    "days_of_week": [
      "monday"
    ]
  },
  "autostop_requirement": {
    "days_of_week": [
      "monday"
    ],
    "weeks": 0
  },
  "cors_behavior": "simple",
  "default_ttl_ms": 0,
  "deprecation_message": "string",
  "description": "string",
  "disable_everyone_group_access": true,
  "disable_module_cache": true,
  "display_name": "string",
  "failure_ttl_ms": 0,
  "icon": "string",
  "max_port_share_level": "owner",
  "name": "string",
  "require_active_version": true,
  "time_til_dormant_autodelete_ms": 0,
  "time_til_dormant_ms": 0,
  "update_workspace_dormant_at": true,
  "update_workspace_last_used_at": true,
  "use_classic_parameter_flow": true
}

Properties

Name	Type	Required	Restrictions	Description
activity_bump_ms	integer	false		Activity bump ms allows optionally specifying the activity bump duration for all workspaces created from this template. Defaults to 1h but can be set to 0 to disable activity bumping.
allow_user_autostart	boolean	false
allow_user_autostop	boolean	false
allow_user_cancel_workspace_jobs	boolean	false
autostart_requirement	codersdk.TemplateAutostartRequirement	false
autostop_requirement	codersdk.TemplateAutostopRequirement	false		Autostop requirement and AutostartRequirement can only be set if your license includes the advanced template scheduling feature. If you attempt to set this value while unlicensed, it will be ignored.
cors_behavior	codersdk.CORSBehavior	false
default_ttl_ms	integer	false
deprecation_message	string	false		Deprecation message if set, will mark the template as deprecated and block any new workspaces from using this template. If passed an empty string, will remove the deprecated message, making the template usable for new workspaces again.
description	string	false
disable_everyone_group_access	boolean	false		Disable everyone group access allows optionally disabling the default behavior of granting the 'everyone' group access to use the template. If this is set to true, the template will not be available to all users, and must be explicitly granted to users or groups in the permissions settings of the template.
disable_module_cache	boolean	false		Disable module cache disables the using of cached Terraform modules during provisioning. It is recommended not to disable this.
display_name	string	false
failure_ttl_ms	integer	false
icon	string	false
max_port_share_level	codersdk.WorkspaceAgentPortShareLevel	false
name	string	false
require_active_version	boolean	false		Require active version mandates workspaces built using this template use the active version of the template. This option has no effect on template admins.
time_til_dormant_autodelete_ms	integer	false
time_til_dormant_ms	integer	false
update_workspace_dormant_at	boolean	false		Update workspace dormant at updates the dormant_at field of workspaces spawned from the template. This is useful for preventing dormant workspaces being immediately deleted when updating the dormant_ttl field to a new, shorter value.
update_workspace_last_used_at	boolean	false		Update workspace last used at updates the last_used_at field of workspaces spawned from the template. This is useful for preventing workspaces being immediately locked when updating the inactivity_ttl field to a new, shorter value.
use_classic_parameter_flow	boolean	false		Use classic parameter flow is a flag that switches the default behavior to use the classic parameter flow when creating a workspace. This only affects deployments with the experiment "dynamic-parameters" enabled. This setting will live for a period after the experiment is made the default. An "opt-out" is present in case the new feature breaks some existing templates.

codersdk.UpdateUserAppearanceSettingsRequest

{
  "terminal_font": "",
  "theme_dark": "light",
  "theme_light": "light",
  "theme_mode": "sync",
  "theme_preference": "string"
}

Properties

Name	Type	Required	Restrictions	Description
terminal_font	codersdk.TerminalFontName	true
theme_dark	string	false		Theme dark is required when ThemeMode is "sync". In "single" mode an empty value means "preserve the previously persisted slot" rather than "clear the slot", so partial updates that send only one slot keep the other intact.
theme_light	string	false		Theme light is required when ThemeMode is "sync". In "single" mode an empty value means "preserve the previously persisted slot" rather than "clear the slot", so partial updates that send only one slot keep the other intact.
theme_mode	codersdk.ThemeMode	false		Theme mode is optional for backward compatibility. When empty, the server leaves theme_mode, theme_light, and theme_dark unchanged so older CLI clients do not erase sync-mode settings. Legacy auto preferences are the exception: they clear theme_mode so clients can migrate the old sync-with-system setting.
theme_preference	string	true

Enumerated Values

Property	Value(s)
theme_dark	dark, dark-protan-deuter, dark-tritan, light, light-protan-deuter, light-tritan
theme_light	dark, dark-protan-deuter, dark-tritan, light, light-protan-deuter, light-tritan
theme_mode	single, sync

codersdk.UpdateUserNotificationPreferences

{
  "template_disabled_map": {
    "property1": true,
    "property2": true
  }
}

Properties

Name	Type	Required	Restrictions	Description
template_disabled_map	object	false
» [any property]	boolean	false

codersdk.UpdateUserPasswordRequest

{
  "old_password": "string",
  "password": "string"
}

Properties

Name	Type	Required	Restrictions	Description
old_password	string	false
password	string	true

codersdk.UpdateUserPreferenceSettingsRequest

{
  "agent_chat_send_shortcut": "enter",
  "code_diff_display_mode": "auto",
  "shell_tool_display_mode": "auto",
  "task_notification_alert_dismissed": true,
  "thinking_display_mode": "auto"
}

Properties

Name	Type	Required	Restrictions	Description
agent_chat_send_shortcut	codersdk.AgentChatSendShortcut	false
code_diff_display_mode	codersdk.AgentDisplayMode	false
shell_tool_display_mode	codersdk.AgentDisplayMode	false
task_notification_alert_dismissed	boolean	false
thinking_display_mode	codersdk.ThinkingDisplayMode	false

codersdk.UpdateUserProfileRequest

{
  "name": "string",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
name	string	false
username	string	true

codersdk.UpdateUserQuietHoursScheduleRequest

{
  "schedule": "string"
}

Properties

Name	Type	Required	Restrictions	Description
schedule	string	true		Schedule is a cron expression that defines when the user's quiet hours window is. Schedule must not be empty. For new users, the schedule is set to 2am in their browser or computer's timezone. The schedule denotes the beginning of a 4 hour window where the workspace is allowed to automatically stop or restart due to maintenance or template schedule.
The schedule must be daily with a single time, and should have a timezone specified via a CRON_TZ prefix (otherwise UTC will be used).
If the schedule is empty, the user will be updated to use the default schedule.

codersdk.UpdateUserSecretRequest

{
  "description": "string",
  "env_name": "string",
  "file_path": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
env_name	string	false
file_path	string	false
value	string	false

codersdk.UpdateUserSkillRequest

{
  "content": "string"
}

Properties

Name	Type	Required	Restrictions	Description
content	string	false		Content must be SKILL.md-format Markdown with YAML frontmatter. The frontmatter must include name, may include description, and must be followed by a non-empty body.

codersdk.UpdateWorkspaceACL

{
  "group_roles": {
    "property1": "admin",
    "property2": "admin"
  },
  "user_roles": {
    "property1": "admin",
    "property2": "admin"
  }
}

Properties

Name	Type	Required	Restrictions	Description
group_roles	object	false		Group roles is a mapping from valid group UUIDs to the workspace role they should be granted. To remove a group from the workspace, use "" as the role (available as a constant named codersdk.WorkspaceRoleDeleted)
» [any property]	codersdk.WorkspaceRole	false
user_roles	object	false		User roles is a mapping from valid user UUIDs to the workspace role they should be granted. To remove a user from the workspace, use "" as the role (available as a constant named codersdk.WorkspaceRoleDeleted)
» [any property]	codersdk.WorkspaceRole	false

codersdk.UpdateWorkspaceAutomaticUpdatesRequest

{
  "automatic_updates": "always"
}

Properties

Name	Type	Required	Restrictions	Description
automatic_updates	codersdk.AutomaticUpdates	false

codersdk.UpdateWorkspaceAutostartRequest

{
  "schedule": "string"
}

Properties

Name	Type	Required	Restrictions	Description
schedule	string	false		Schedule is expected to be of the form CRON_TZ=<IANA Timezone> <min> <hour> * * <dow> Example: CRON_TZ=US/Central 30 9 * * 1-5 represents 0930 in the timezone US/Central on weekdays (Mon-Fri). CRON_TZ defaults to UTC if not present.

codersdk.UpdateWorkspaceBuildStateRequest

{
  "state": [
    0
  ]
}

Properties

Name	Type	Required	Restrictions	Description
state	array of integer	false

codersdk.UpdateWorkspaceDormancy

{
  "dormant": true
}

Properties

Name	Type	Required	Restrictions	Description
dormant	boolean	false

codersdk.UpdateWorkspaceRequest

{
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
name	string	false

codersdk.UpdateWorkspaceSharingSettingsRequest

{
  "shareable_workspace_owners": "none",
  "sharing_disabled": true
}

Properties

Name	Type	Required	Restrictions	Description
shareable_workspace_owners	codersdk.ShareableWorkspaceOwners	false		Shareable workspace owners controls whose workspaces can be shared within the organization.
sharing_disabled	boolean	false		Sharing disabled is deprecated and left for backward compatibility purposes. Deprecated: use ShareableWorkspaceOwners instead

Enumerated Values

Property	Value(s)
shareable_workspace_owners	everyone, none, service_accounts

codersdk.UpdateWorkspaceTTLRequest

{
  "ttl_ms": 0
}

Properties

Name	Type	Required	Restrictions	Description
ttl_ms	integer	false

codersdk.UploadChatFileResponse

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	false

codersdk.UploadResponse

{
  "hash": "19686d84-b10d-4f90-b18e-84fd3fa038fd"
}

Properties

Name	Type	Required	Restrictions	Description
hash	string	false

codersdk.UpsertGroupAIBudgetRequest

{
  "spend_limit_micros": 0
}

Properties

Name	Type	Required	Restrictions	Description
spend_limit_micros	integer	false

codersdk.UpsertUserAIBudgetOverrideRequest

{
  "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
  "spend_limit_micros": 0
}

Properties

Name	Type	Required	Restrictions	Description
group_id	string	true		Group ID is the group the user's spend is attributed to. The user must be a member of this group.
spend_limit_micros	integer	false

codersdk.UpsertWorkspaceAgentPortShareRequest

{
  "agent_name": "string",
  "port": 0,
  "protocol": "http",
  "share_level": "owner"
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false
port	integer	false
protocol	codersdk.WorkspaceAgentPortShareProtocol	false
share_level	codersdk.WorkspaceAgentPortShareLevel	false

Enumerated Values

Property	Value(s)
protocol	http, https
share_level	authenticated, organization, owner, public

codersdk.UsageAppName

"vscode"

Properties

Enumerated Values

Value(s)
jetbrains, reconnecting-pty, ssh, vscode

codersdk.UsagePeriod

{
  "end": "2019-08-24T14:15:22Z",
  "issued_at": "2019-08-24T14:15:22Z",
  "start": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
end	string	false
issued_at	string	false
start	string	false

codersdk.UsageStatsConfig

{
  "enable": true
}

Properties

Name	Type	Required	Restrictions	Description
enable	boolean	false

codersdk.User

{
  "avatar_url": "http://example.com",
  "created_at": "2019-08-24T14:15:22Z",
  "email": "user@example.com",
  "has_ai_seat": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "is_service_account": true,
  "last_seen_at": "2019-08-24T14:15:22Z",
  "login_type": "",
  "name": "string",
  "organization_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "roles": [
    {
      "display_name": "string",
      "name": "string",
      "organization_id": "string"
    }
  ],
  "status": "active",
  "theme_preference": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
created_at	string	true
email	string	true
has_ai_seat	boolean	false		Has ai seat intentionally omits omitempty so the API always includes the field, even when false.
id	string	true
is_service_account	boolean	false
last_seen_at	string	false
login_type	codersdk.LoginType	false
name	string	false
organization_ids	array of string	false
roles	array of codersdk.SlimRole	false
status	codersdk.UserStatus	false
theme_preference	string	false		Deprecated: this value should be retrieved from codersdk.UserPreferenceSettings instead.
updated_at	string	false
username	string	true

Enumerated Values

Property	Value(s)
status	active, suspended

codersdk.UserAIBudgetOverride

{
  "created_at": "2019-08-24T14:15:22Z",
  "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
  "spend_limit_micros": 0,
  "updated_at": "2019-08-24T14:15:22Z",
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
group_id	string	false
spend_limit_micros	integer	false
updated_at	string	false
user_id	string	false

codersdk.UserActivity

{
  "avatar_url": "http://example.com",
  "seconds": 80500,
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
seconds	integer	false
template_ids	array of string	false
user_id	string	false
username	string	false

codersdk.UserActivityInsightsReport

{
  "end_time": "2019-08-24T14:15:22Z",
  "start_time": "2019-08-24T14:15:22Z",
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "users": [
    {
      "avatar_url": "http://example.com",
      "seconds": 80500,
      "template_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
end_time	string	false
start_time	string	false
template_ids	array of string	false
users	array of codersdk.UserActivity	false

codersdk.UserActivityInsightsResponse

{
  "report": {
    "end_time": "2019-08-24T14:15:22Z",
    "start_time": "2019-08-24T14:15:22Z",
    "template_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "users": [
      {
        "avatar_url": "http://example.com",
        "seconds": 80500,
        "template_ids": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
        "username": "string"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
report	codersdk.UserActivityInsightsReport	false

codersdk.UserAppearanceSettings

{
  "terminal_font": "",
  "theme_dark": "string",
  "theme_light": "string",
  "theme_mode": "",
  "theme_preference": "string"
}

Properties

Name	Type	Required	Restrictions	Description
terminal_font	codersdk.TerminalFontName	false
theme_dark	string	false		Ignored when ThemeMode is "single"
theme_light	string	false		Ignored when ThemeMode is "single"
theme_mode	codersdk.ThemeMode	false
theme_preference	string	false		Theme preference is the legacy single-field appearance setting. In "single" mode it mirrors the active theme. In "sync" mode modern clients normally mirror the active OS slot, but older clients can update only this field, so it may diverge from ThemeLight or ThemeDark until a modern client saves the full appearance state again.

codersdk.UserLatency

{
  "avatar_url": "http://example.com",
  "latency_ms": {
    "p50": 31.312,
    "p95": 119.832
  },
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
latency_ms	codersdk.ConnectionLatency	false
template_ids	array of string	false
user_id	string	false
username	string	false

codersdk.UserLatencyInsightsReport

{
  "end_time": "2019-08-24T14:15:22Z",
  "start_time": "2019-08-24T14:15:22Z",
  "template_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "users": [
    {
      "avatar_url": "http://example.com",
      "latency_ms": {
        "p50": 31.312,
        "p95": 119.832
      },
      "template_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
end_time	string	false
start_time	string	false
template_ids	array of string	false
users	array of codersdk.UserLatency	false

codersdk.UserLatencyInsightsResponse

{
  "report": {
    "end_time": "2019-08-24T14:15:22Z",
    "start_time": "2019-08-24T14:15:22Z",
    "template_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "users": [
      {
        "avatar_url": "http://example.com",
        "latency_ms": {
          "p50": 31.312,
          "p95": 119.832
        },
        "template_ids": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
        "username": "string"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
report	codersdk.UserLatencyInsightsReport	false

codersdk.UserLoginType

{
  "login_type": ""
}

Properties

Name	Type	Required	Restrictions	Description
login_type	codersdk.LoginType	false

codersdk.UserParameter

{
  "name": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
name	string	false
value	string	false

codersdk.UserPreferenceSettings

{
  "agent_chat_send_shortcut": "enter",
  "code_diff_display_mode": "auto",
  "shell_tool_display_mode": "auto",
  "task_notification_alert_dismissed": true,
  "thinking_display_mode": "auto"
}

Properties

Name	Type	Required	Restrictions	Description
agent_chat_send_shortcut	codersdk.AgentChatSendShortcut	false
code_diff_display_mode	codersdk.AgentDisplayMode	false
shell_tool_display_mode	codersdk.AgentDisplayMode	false
task_notification_alert_dismissed	boolean	false
thinking_display_mode	codersdk.ThinkingDisplayMode	false

codersdk.UserQuietHoursScheduleConfig

{
  "allow_user_custom": true,
  "default_schedule": "string"
}

Properties

Name	Type	Required	Restrictions	Description
allow_user_custom	boolean	false
default_schedule	string	false

codersdk.UserQuietHoursScheduleResponse

{
  "next": "2019-08-24T14:15:22Z",
  "raw_schedule": "string",
  "time": "string",
  "timezone": "string",
  "user_can_set": true,
  "user_set": true
}

Properties

Name	Type	Required	Restrictions	Description
next	string	false		Next is the next time that the quiet hours window will start.
raw_schedule	string	false
time	string	false		Time is the time of day that the quiet hours window starts in the given Timezone each day.
timezone	string	false		raw format from the cron expression, UTC if unspecified
user_can_set	boolean	false		User can set is true if the user is allowed to set their own quiet hours schedule. If false, the user cannot set a custom schedule and the default schedule will always be used.
user_set	boolean	false		User set is true if the user has set their own quiet hours schedule. If false, the user is using the default schedule.

codersdk.UserSecret

{
  "created_at": "2019-08-24T14:15:22Z",
  "description": "string",
  "env_name": "string",
  "file_path": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
description	string	false
env_name	string	false
file_path	string	false
id	string	false
name	string	false
updated_at	string	false

codersdk.UserSkill

{
  "content": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "description": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
content	string	false
created_at	string	false
description	string	false
id	string	false
name	string	false
updated_at	string	false

codersdk.UserSkillMetadata

{
  "created_at": "2019-08-24T14:15:22Z",
  "description": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
description	string	false
id	string	false
name	string	false
updated_at	string	false

codersdk.UserStatus

"active"

Properties

Enumerated Values

Value(s)
active, dormant, suspended

codersdk.UserStatusChangeCount

{
  "count": 10,
  "date": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
date	string	false

codersdk.ValidateUserPasswordRequest

{
  "password": "string"
}

Properties

Name	Type	Required	Restrictions	Description
password	string	true

codersdk.ValidateUserPasswordResponse

{
  "details": "string",
  "valid": true
}

Properties

Name	Type	Required	Restrictions	Description
details	string	false
valid	boolean	false

codersdk.ValidationError

{
  "detail": "string",
  "field": "string"
}

Properties

Name	Type	Required	Restrictions	Description
detail	string	true
field	string	true

codersdk.ValidationMonotonicOrder

"increasing"

Properties

Enumerated Values

Value(s)
decreasing, increasing

codersdk.VariableValue

{
  "name": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
name	string	false
value	string	false

codersdk.WebpushSubscription

{
  "auth_key": "string",
  "endpoint": "string",
  "p256dh_key": "string"
}

Properties

Name	Type	Required	Restrictions	Description
auth_key	string	false
endpoint	string	false
p256dh_key	string	false

codersdk.Workspace

{
  "allow_renames": true,
  "automatic_updates": "always",
  "autostart_schedule": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "deleting_at": "2019-08-24T14:15:22Z",
  "dormant_at": "2019-08-24T14:15:22Z",
  "favorite": true,
  "health": {
    "failing_agents": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "healthy": false
  },
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "is_prebuild": true,
  "last_used_at": "2019-08-24T14:15:22Z",
  "latest_app_status": {
    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
    "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
    "created_at": "2019-08-24T14:15:22Z",
    "icon": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "message": "string",
    "needs_user_attention": true,
    "state": "working",
    "uri": "string",
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
  },
  "latest_build": {
    "build_number": 0,
    "created_at": "2019-08-24T14:15:22Z",
    "daily_cost": 0,
    "deadline": "2019-08-24T14:15:22Z",
    "has_ai_task": true,
    "has_external_agent": true,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
    "initiator_name": "string",
    "job": {
      "available_workers": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "canceled_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "error": "string",
      "error_code": "REQUIRED_TEMPLATE_VARIABLES",
      "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
      "input": {
        "error": "string",
        "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
        "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
      },
      "logs_overflowed": true,
      "metadata": {
        "template_display_name": "string",
        "template_icon": "string",
        "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
        "template_name": "string",
        "template_version_name": "string",
        "workspace_build_transition": "start",
        "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
        "workspace_name": "string"
      },
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "queue_position": 0,
      "queue_size": 0,
      "started_at": "2019-08-24T14:15:22Z",
      "status": "pending",
      "tags": {
        "property1": "string",
        "property2": "string"
      },
      "type": "template_version_import",
      "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
      "worker_name": "string"
    },
    "matched_provisioners": {
      "available": 0,
      "count": 0,
      "most_recently_seen": "2019-08-24T14:15:22Z"
    },
    "max_deadline": "2019-08-24T14:15:22Z",
    "reason": "initiator",
    "resources": [
      {
        "agents": [
          {
            "api_version": "string",
            "apps": [
              {
                "command": "string",
                "display_name": "string",
                "external": true,
                "group": "string",
                "health": "disabled",
                "healthcheck": {
                  "interval": 0,
                  "threshold": 0,
                  "url": "string"
                },
                "hidden": true,
                "icon": "string",
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "open_in": "slim-window",
                "sharing_level": "owner",
                "slug": "string",
                "statuses": [
                  {
                    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
                    "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
                    "created_at": "2019-08-24T14:15:22Z",
                    "icon": "string",
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "message": "string",
                    "needs_user_attention": true,
                    "state": "working",
                    "uri": "string",
                    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
                  }
                ],
                "subdomain": true,
                "subdomain_name": "string",
                "tooltip": "string",
                "url": "string"
              }
            ],
            "architecture": "string",
            "connection_timeout_seconds": 0,
            "created_at": "2019-08-24T14:15:22Z",
            "directory": "string",
            "disconnected_at": "2019-08-24T14:15:22Z",
            "display_apps": [
              "vscode"
            ],
            "environment_variables": {
              "property1": "string",
              "property2": "string"
            },
            "expanded_directory": "string",
            "first_connected_at": "2019-08-24T14:15:22Z",
            "health": {
              "healthy": false,
              "reason": "agent has lost connection"
            },
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "instance_id": "string",
            "last_connected_at": "2019-08-24T14:15:22Z",
            "latency": {
              "property1": {
                "latency_ms": 0,
                "preferred": true
              },
              "property2": {
                "latency_ms": 0,
                "preferred": true
              }
            },
            "lifecycle_state": "created",
            "log_sources": [
              {
                "created_at": "2019-08-24T14:15:22Z",
                "display_name": "string",
                "icon": "string",
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
              }
            ],
            "logs_length": 0,
            "logs_overflowed": true,
            "name": "string",
            "operating_system": "string",
            "parent_id": {
              "uuid": "string",
              "valid": true
            },
            "ready_at": "2019-08-24T14:15:22Z",
            "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
            "scripts": [
              {
                "cron": "string",
                "display_name": "string",
                "exit_code": 0,
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "log_path": "string",
                "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
                "run_on_start": true,
                "run_on_stop": true,
                "script": "string",
                "start_blocks_login": true,
                "status": "ok",
                "timeout": 0
              }
            ],
            "started_at": "2019-08-24T14:15:22Z",
            "startup_script_behavior": "blocking",
            "status": "connecting",
            "subsystems": [
              "envbox"
            ],
            "troubleshooting_url": "string",
            "updated_at": "2019-08-24T14:15:22Z",
            "version": "string"
          }
        ],
        "created_at": "2019-08-24T14:15:22Z",
        "daily_cost": 0,
        "hide": true,
        "icon": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
        "metadata": [
          {
            "key": "string",
            "sensitive": true,
            "value": "string"
          }
        ],
        "name": "string",
        "type": "string",
        "workspace_transition": "start"
      }
    ],
    "status": "pending",
    "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
    "template_version_name": "string",
    "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
    "transition": "start",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
    "workspace_name": "string",
    "workspace_owner_avatar_url": "string",
    "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
    "workspace_owner_name": "string"
  },
  "name": "string",
  "next_start_at": "2019-08-24T14:15:22Z",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_name": "string",
  "outdated": true,
  "owner_avatar_url": "string",
  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
  "owner_name": "string",
  "shared_with": [
    {
      "actor_type": "group",
      "avatar_url": "http://example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "roles": [
        "admin"
      ]
    }
  ],
  "task_id": {
    "uuid": "string",
    "valid": true
  },
  "template_active_version_id": "b0da9c29-67d8-4c87-888c-bafe356f7f3c",
  "template_allow_user_cancel_workspace_jobs": true,
  "template_display_name": "string",
  "template_icon": "string",
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "template_name": "string",
  "template_require_active_version": true,
  "template_use_classic_parameter_flow": true,
  "ttl_ms": 0,
  "updated_at": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
allow_renames	boolean	false
automatic_updates	codersdk.AutomaticUpdates	false
autostart_schedule	string	false
created_at	string	false
deleting_at	string	false		Deleting at indicates the time at which the workspace will be permanently deleted. A workspace is eligible for deletion if it is dormant (a non-nil dormant_at value) and a value has been specified for time_til_dormant_autodelete on its template.
dormant_at	string	false		Dormant at being non-nil indicates a workspace that is dormant. A dormant workspace is no longer accessible must be activated. It is subject to deletion if it breaches the duration of the time_til_ field on its template.
favorite	boolean	false
health	codersdk.WorkspaceHealth	false		Health shows the health of the workspace and information about what is causing an unhealthy status.
id	string	false
is_prebuild	boolean	false		Is prebuild indicates whether the workspace is a prebuilt workspace. Prebuilt workspaces are owned by the prebuilds system user and have specific behavior, such as being managed differently from regular workspaces. Once a prebuilt workspace is claimed by a user, it transitions to a regular workspace, and IsPrebuild returns false.
last_used_at	string	false
latest_app_status	codersdk.WorkspaceAppStatus	false
latest_build	codersdk.WorkspaceBuild	false
name	string	false
next_start_at	string	false
organization_id	string	false
organization_name	string	false
outdated	boolean	false
owner_avatar_url	string	false
owner_id	string	false
owner_name	string	false		Owner name is the username of the owner of the workspace.
shared_with	array of codersdk.SharedWorkspaceActor	false
task_id	uuid.NullUUID	false		Task ID if set, indicates that the workspace is relevant to the given codersdk.Task.
template_active_version_id	string	false
template_allow_user_cancel_workspace_jobs	boolean	false
template_display_name	string	false
template_icon	string	false
template_id	string	false
template_name	string	false
template_require_active_version	boolean	false
template_use_classic_parameter_flow	boolean	false
ttl_ms	integer	false
updated_at	string	false

Enumerated Values

Property	Value(s)
automatic_updates	always, never

codersdk.WorkspaceACL

{
  "group": [
    {
      "avatar_url": "http://example.com",
      "display_name": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "members": [
        {
          "avatar_url": "http://example.com",
          "created_at": "2019-08-24T14:15:22Z",
          "email": "user@example.com",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "is_service_account": true,
          "last_seen_at": "2019-08-24T14:15:22Z",
          "login_type": "",
          "name": "string",
          "status": "active",
          "theme_preference": "string",
          "updated_at": "2019-08-24T14:15:22Z",
          "username": "string"
        }
      ],
      "name": "string",
      "organization_display_name": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "organization_name": "string",
      "quota_allowance": 0,
      "role": "admin",
      "source": "user",
      "total_member_count": 0
    }
  ],
  "users": [
    {
      "avatar_url": "http://example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "role": "admin",
      "username": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
group	array of codersdk.WorkspaceGroup	false
users	array of codersdk.WorkspaceUser	false

codersdk.WorkspaceAgent

{
  "api_version": "string",
  "apps": [
    {
      "command": "string",
      "display_name": "string",
      "external": true,
      "group": "string",
      "health": "disabled",
      "healthcheck": {
        "interval": 0,
        "threshold": 0,
        "url": "string"
      },
      "hidden": true,
      "icon": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "open_in": "slim-window",
      "sharing_level": "owner",
      "slug": "string",
      "statuses": [
        {
          "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
          "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
          "created_at": "2019-08-24T14:15:22Z",
          "icon": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "message": "string",
          "needs_user_attention": true,
          "state": "working",
          "uri": "string",
          "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
        }
      ],
      "subdomain": true,
      "subdomain_name": "string",
      "tooltip": "string",
      "url": "string"
    }
  ],
  "architecture": "string",
  "connection_timeout_seconds": 0,
  "created_at": "2019-08-24T14:15:22Z",
  "directory": "string",
  "disconnected_at": "2019-08-24T14:15:22Z",
  "display_apps": [
    "vscode"
  ],
  "environment_variables": {
    "property1": "string",
    "property2": "string"
  },
  "expanded_directory": "string",
  "first_connected_at": "2019-08-24T14:15:22Z",
  "health": {
    "healthy": false,
    "reason": "agent has lost connection"
  },
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "instance_id": "string",
  "last_connected_at": "2019-08-24T14:15:22Z",
  "latency": {
    "property1": {
      "latency_ms": 0,
      "preferred": true
    },
    "property2": {
      "latency_ms": 0,
      "preferred": true
    }
  },
  "lifecycle_state": "created",
  "log_sources": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "display_name": "string",
      "icon": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
    }
  ],
  "logs_length": 0,
  "logs_overflowed": true,
  "name": "string",
  "operating_system": "string",
  "parent_id": {
    "uuid": "string",
    "valid": true
  },
  "ready_at": "2019-08-24T14:15:22Z",
  "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
  "scripts": [
    {
      "cron": "string",
      "display_name": "string",
      "exit_code": 0,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "log_path": "string",
      "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
      "run_on_start": true,
      "run_on_stop": true,
      "script": "string",
      "start_blocks_login": true,
      "status": "ok",
      "timeout": 0
    }
  ],
  "started_at": "2019-08-24T14:15:22Z",
  "startup_script_behavior": "blocking",
  "status": "connecting",
  "subsystems": [
    "envbox"
  ],
  "troubleshooting_url": "string",
  "updated_at": "2019-08-24T14:15:22Z",
  "version": "string"
}

Properties

Name	Type	Required	Restrictions	Description
api_version	string	false
apps	array of codersdk.WorkspaceApp	false
architecture	string	false
connection_timeout_seconds	integer	false
created_at	string	false
directory	string	false
disconnected_at	string	false
display_apps	array of codersdk.DisplayApp	false
environment_variables	object	false
» [any property]	string	false
expanded_directory	string	false
first_connected_at	string	false
health	codersdk.WorkspaceAgentHealth	false		Health reports the health of the agent.
id	string	false
instance_id	string	false
last_connected_at	string	false
latency	object	false		Latency is mapped by region name (e.g. "New York City", "Seattle").
» [any property]	codersdk.DERPRegion	false
lifecycle_state	codersdk.WorkspaceAgentLifecycle	false
log_sources	array of codersdk.WorkspaceAgentLogSource	false
logs_length	integer	false
logs_overflowed	boolean	false
name	string	false
operating_system	string	false
parent_id	uuid.NullUUID	false
ready_at	string	false
resource_id	string	false
scripts	array of codersdk.WorkspaceAgentScript	false
started_at	string	false
startup_script_behavior	codersdk.WorkspaceAgentStartupScriptBehavior	false		Startup script behavior is a legacy field that is deprecated in favor of the coder_script resource. It's only referenced by old clients. Deprecated: Remove in the future!
status	codersdk.WorkspaceAgentStatus	false
subsystems	array of codersdk.AgentSubsystem	false
troubleshooting_url	string	false
updated_at	string	false
version	string	false

codersdk.WorkspaceAgentContainer

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "image": "string",
  "labels": {
    "property1": "string",
    "property2": "string"
  },
  "name": "string",
  "ports": [
    {
      "host_ip": "string",
      "host_port": 0,
      "network": "string",
      "port": 0
    }
  ],
  "running": true,
  "status": "string",
  "volumes": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false		Created at is the time the container was created.
id	string	false		ID is the unique identifier of the container.
image	string	false		Image is the name of the container image.
labels	object	false		Labels is a map of key-value pairs of container labels.
» [any property]	string	false
name	string	false		Name is the human-readable name of the container.
ports	array of codersdk.WorkspaceAgentContainerPort	false		Ports includes ports exposed by the container.
running	boolean	false		Running is true if the container is currently running.
status	string	false		Status is the current status of the container. This is somewhat implementation-dependent, but should generally be a human-readable string.
volumes	object	false		Volumes is a map of "things" mounted into the container. Again, this is somewhat implementation-dependent.
» [any property]	string	false

codersdk.WorkspaceAgentContainerPort

{
  "host_ip": "string",
  "host_port": 0,
  "network": "string",
  "port": 0
}

Properties

Name	Type	Required	Restrictions	Description
host_ip	string	false		Host ip is the IP address of the host interface to which the port is bound. Note that this can be an IPv4 or IPv6 address.
host_port	integer	false		Host port is the port number outside the container.
network	string	false		Network is the network protocol used by the port (tcp, udp, etc).
port	integer	false		Port is the port number inside the container.

codersdk.WorkspaceAgentDevcontainer

{
  "agent": {
    "directory": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string"
  },
  "config_path": "string",
  "container": {
    "created_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "image": "string",
    "labels": {
      "property1": "string",
      "property2": "string"
    },
    "name": "string",
    "ports": [
      {
        "host_ip": "string",
        "host_port": 0,
        "network": "string",
        "port": 0
      }
    ],
    "running": true,
    "status": "string",
    "volumes": {
      "property1": "string",
      "property2": "string"
    }
  },
  "dirty": true,
  "error": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "status": "running",
  "subagent_id": {
    "uuid": "string",
    "valid": true
  },
  "workspace_folder": "string"
}

Properties

Name	Type	Required	Restrictions	Description
agent	codersdk.WorkspaceAgentDevcontainerAgent	false
config_path	string	false
container	codersdk.WorkspaceAgentContainer	false
dirty	boolean	false
error	string	false
id	string	false
name	string	false
status	codersdk.WorkspaceAgentDevcontainerStatus	false		Additional runtime fields.
subagent_id	uuid.NullUUID	false
workspace_folder	string	false

codersdk.WorkspaceAgentDevcontainerAgent

{
  "directory": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
directory	string	false
id	string	false
name	string	false

codersdk.WorkspaceAgentDevcontainerStatus

"running"

Properties

Enumerated Values

Value(s)
deleting, error, running, starting, stopped, stopping

codersdk.WorkspaceAgentGitServerMessage

{
  "message": "string",
  "repositories": [
    {
      "branch": "string",
      "remote_origin": "string",
      "removed": true,
      "repo_root": "string",
      "unified_diff": "string"
    }
  ],
  "scanned_at": "2019-08-24T14:15:22Z",
  "type": "changes"
}

Properties

Name	Type	Required	Restrictions	Description
message	string	false
repositories	array of codersdk.WorkspaceAgentRepoChanges	false
scanned_at	string	false
type	codersdk.WorkspaceAgentGitServerMessageType	false

codersdk.WorkspaceAgentGitServerMessageType

"changes"

Properties

Enumerated Values

Value(s)
changes, error

codersdk.WorkspaceAgentHealth

{
  "healthy": false,
  "reason": "agent has lost connection"
}

Properties

Name	Type	Required	Restrictions	Description
healthy	boolean	false		Healthy is true if the agent is healthy.
reason	string	false		Reason is a human-readable explanation of the agent's health. It is empty if Healthy is true.

codersdk.WorkspaceAgentLifecycle

"created"

Properties

Enumerated Values

Value(s)
created, off, ready, shutdown_error, shutdown_timeout, shutting_down, start_error, start_timeout, starting

codersdk.WorkspaceAgentListContainersResponse

{
  "containers": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "id": "string",
      "image": "string",
      "labels": {
        "property1": "string",
        "property2": "string"
      },
      "name": "string",
      "ports": [
        {
          "host_ip": "string",
          "host_port": 0,
          "network": "string",
          "port": 0
        }
      ],
      "running": true,
      "status": "string",
      "volumes": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "devcontainers": [
    {
      "agent": {
        "directory": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
      },
      "config_path": "string",
      "container": {
        "created_at": "2019-08-24T14:15:22Z",
        "id": "string",
        "image": "string",
        "labels": {
          "property1": "string",
          "property2": "string"
        },
        "name": "string",
        "ports": [
          {
            "host_ip": "string",
            "host_port": 0,
            "network": "string",
            "port": 0
          }
        ],
        "running": true,
        "status": "string",
        "volumes": {
          "property1": "string",
          "property2": "string"
        }
      },
      "dirty": true,
      "error": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "status": "running",
      "subagent_id": {
        "uuid": "string",
        "valid": true
      },
      "workspace_folder": "string"
    }
  ],
  "warnings": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
containers	array of codersdk.WorkspaceAgentContainer	false		Containers is a list of containers visible to the workspace agent.
devcontainers	array of codersdk.WorkspaceAgentDevcontainer	false		Devcontainers is a list of devcontainers visible to the workspace agent.
warnings	array of string	false		Warnings is a list of warnings that may have occurred during the process of listing containers. This should not include fatal errors.

codersdk.WorkspaceAgentListeningPort

{
  "network": "string",
  "port": 0,
  "process_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
network	string	false		only "tcp" at the moment
port	integer	false
process_name	string	false		may be empty

codersdk.WorkspaceAgentListeningPortsResponse

{
  "ports": [
    {
      "network": "string",
      "port": 0,
      "process_name": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
ports	array of codersdk.WorkspaceAgentListeningPort	false		If there are no ports in the list, nothing should be displayed in the UI. There must not be a "no ports available" message or anything similar, as there will always be no ports displayed on platforms where our port detection logic is unsupported.

codersdk.WorkspaceAgentLog

{
  "created_at": "2019-08-24T14:15:22Z",
  "id": 0,
  "level": "trace",
  "output": "string",
  "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
id	integer	false
level	codersdk.LogLevel	false
output	string	false
source_id	string	false

codersdk.WorkspaceAgentLogSource

{
  "created_at": "2019-08-24T14:15:22Z",
  "display_name": "string",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
display_name	string	false
icon	string	false
id	string	false
workspace_agent_id	string	false

codersdk.WorkspaceAgentPortShare

{
  "agent_name": "string",
  "port": 0,
  "protocol": "http",
  "share_level": "owner",
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}

Properties

Name	Type	Required	Restrictions	Description
agent_name	string	false
port	integer	false
protocol	codersdk.WorkspaceAgentPortShareProtocol	false
share_level	codersdk.WorkspaceAgentPortShareLevel	false
workspace_id	string	false

Enumerated Values

Property	Value(s)
protocol	http, https
share_level	authenticated, organization, owner, public

codersdk.WorkspaceAgentPortShareLevel

"owner"

Properties

Enumerated Values

Value(s)
authenticated, organization, owner, public

codersdk.WorkspaceAgentPortShareProtocol

"http"

Properties

Enumerated Values

Value(s)
http, https

codersdk.WorkspaceAgentPortShares

{
  "shares": [
    {
      "agent_name": "string",
      "port": 0,
      "protocol": "http",
      "share_level": "owner",
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
shares	array of codersdk.WorkspaceAgentPortShare	false

codersdk.WorkspaceAgentRepoChanges

{
  "branch": "string",
  "remote_origin": "string",
  "removed": true,
  "repo_root": "string",
  "unified_diff": "string"
}

Properties

Name	Type	Required	Restrictions	Description
branch	string	false
remote_origin	string	false
removed	boolean	false
repo_root	string	false
unified_diff	string	false

codersdk.WorkspaceAgentScript

{
  "cron": "string",
  "display_name": "string",
  "exit_code": 0,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "log_path": "string",
  "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
  "run_on_start": true,
  "run_on_stop": true,
  "script": "string",
  "start_blocks_login": true,
  "status": "ok",
  "timeout": 0
}

Properties

Name	Type	Required	Restrictions	Description
cron	string	false
display_name	string	false
exit_code	integer	false
id	string	false
log_path	string	false
log_source_id	string	false
run_on_start	boolean	false
run_on_stop	boolean	false
script	string	false
start_blocks_login	boolean	false
status	codersdk.WorkspaceAgentScriptStatus	false
timeout	integer	false

codersdk.WorkspaceAgentScriptStatus

"ok"

Properties

Enumerated Values

Value(s)
exit_failure, ok, pipes_left_open, timed_out

codersdk.WorkspaceAgentStartupScriptBehavior

"blocking"

Properties

Enumerated Values

Value(s)
blocking, non-blocking

codersdk.WorkspaceAgentStatus

"connecting"

Properties

Enumerated Values

Value(s)
connected, connecting, disconnected, timeout

codersdk.WorkspaceApp

{
  "command": "string",
  "display_name": "string",
  "external": true,
  "group": "string",
  "health": "disabled",
  "healthcheck": {
    "interval": 0,
    "threshold": 0,
    "url": "string"
  },
  "hidden": true,
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "open_in": "slim-window",
  "sharing_level": "owner",
  "slug": "string",
  "statuses": [
    {
      "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
      "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
      "created_at": "2019-08-24T14:15:22Z",
      "icon": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "message": "string",
      "needs_user_attention": true,
      "state": "working",
      "uri": "string",
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
    }
  ],
  "subdomain": true,
  "subdomain_name": "string",
  "tooltip": "string",
  "url": "string"
}

Properties

Name	Type	Required	Restrictions	Description
command	string	false
display_name	string	false		Display name is a friendly name for the app.
external	boolean	false		External specifies whether the URL should be opened externally on the client or not.
group	string	false
health	codersdk.WorkspaceAppHealth	false
healthcheck	codersdk.Healthcheck	false		Healthcheck specifies the configuration for checking app health.
hidden	boolean	false
icon	string	false		Icon is a relative path or external URL that specifies an icon to be displayed in the dashboard.
id	string	false
open_in	codersdk.WorkspaceAppOpenIn	false
sharing_level	codersdk.WorkspaceAppSharingLevel	false
slug	string	false		Slug is a unique identifier within the agent.
statuses	array of codersdk.WorkspaceAppStatus	false		Statuses is a list of statuses for the app.
subdomain	boolean	false		Subdomain denotes whether the app should be accessed via a path on the coder server or via a hostname-based dev URL. If this is set to true and there is no app wildcard configured on the server, the app will not be accessible in the UI.
subdomain_name	string	false		Subdomain name is the application domain exposed on the coder server.
tooltip	string	false		Tooltip is an optional markdown supported field that is displayed when hovering over workspace apps in the UI.
url	string	false		URL is the address being proxied to inside the workspace. If external is specified, this will be opened on the client.

Enumerated Values

Property	Value(s)
sharing_level	authenticated, organization, owner, public

codersdk.WorkspaceAppHealth

"disabled"

Properties

Enumerated Values

Value(s)
disabled, healthy, initializing, unhealthy

codersdk.WorkspaceAppOpenIn

"slim-window"

Properties

Enumerated Values

Value(s)
slim-window, tab

codersdk.WorkspaceAppSharingLevel

"owner"

Properties

Enumerated Values

Value(s)
authenticated, organization, owner, public

codersdk.WorkspaceAppStatus

{
  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
  "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
  "created_at": "2019-08-24T14:15:22Z",
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "message": "string",
  "needs_user_attention": true,
  "state": "working",
  "uri": "string",
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}

Properties

Name	Type	Required	Restrictions	Description
agent_id	string	false
app_id	string	false
created_at	string	false
icon	string	false		Deprecated: This field is unused and will be removed in a future version. Icon is an external URL to an icon that will be rendered in the UI.
id	string	false
message	string	false
needs_user_attention	boolean	false		Deprecated: This field is unused and will be removed in a future version. NeedsUserAttention specifies whether the status needs user attention.
state	codersdk.WorkspaceAppStatusState	false
uri	string	false		Uri is the URI of the resource that the status is for. e.g. https://github.com/org/repo/pull/123 e.g. file:///path/to/file
workspace_id	string	false

codersdk.WorkspaceAppStatusState

"working"

Properties

Enumerated Values

Value(s)
complete, failure, idle, working

codersdk.WorkspaceBuild

{
  "build_number": 0,
  "created_at": "2019-08-24T14:15:22Z",
  "daily_cost": 0,
  "deadline": "2019-08-24T14:15:22Z",
  "has_ai_task": true,
  "has_external_agent": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
  "initiator_name": "string",
  "job": {
    "available_workers": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "canceled_at": "2019-08-24T14:15:22Z",
    "completed_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "error": "string",
    "error_code": "REQUIRED_TEMPLATE_VARIABLES",
    "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
    "input": {
      "error": "string",
      "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
      "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
    },
    "logs_overflowed": true,
    "metadata": {
      "template_display_name": "string",
      "template_icon": "string",
      "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
      "template_name": "string",
      "template_version_name": "string",
      "workspace_build_transition": "start",
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
      "workspace_name": "string"
    },
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "queue_position": 0,
    "queue_size": 0,
    "started_at": "2019-08-24T14:15:22Z",
    "status": "pending",
    "tags": {
      "property1": "string",
      "property2": "string"
    },
    "type": "template_version_import",
    "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
    "worker_name": "string"
  },
  "matched_provisioners": {
    "available": 0,
    "count": 0,
    "most_recently_seen": "2019-08-24T14:15:22Z"
  },
  "max_deadline": "2019-08-24T14:15:22Z",
  "reason": "initiator",
  "resources": [
    {
      "agents": [
        {
          "api_version": "string",
          "apps": [
            {
              "command": "string",
              "display_name": "string",
              "external": true,
              "group": "string",
              "health": "disabled",
              "healthcheck": {
                "interval": 0,
                "threshold": 0,
                "url": "string"
              },
              "hidden": true,
              "icon": "string",
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "open_in": "slim-window",
              "sharing_level": "owner",
              "slug": "string",
              "statuses": [
                {
                  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
                  "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
                  "created_at": "2019-08-24T14:15:22Z",
                  "icon": "string",
                  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                  "message": "string",
                  "needs_user_attention": true,
                  "state": "working",
                  "uri": "string",
                  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
                }
              ],
              "subdomain": true,
              "subdomain_name": "string",
              "tooltip": "string",
              "url": "string"
            }
          ],
          "architecture": "string",
          "connection_timeout_seconds": 0,
          "created_at": "2019-08-24T14:15:22Z",
          "directory": "string",
          "disconnected_at": "2019-08-24T14:15:22Z",
          "display_apps": [
            "vscode"
          ],
          "environment_variables": {
            "property1": "string",
            "property2": "string"
          },
          "expanded_directory": "string",
          "first_connected_at": "2019-08-24T14:15:22Z",
          "health": {
            "healthy": false,
            "reason": "agent has lost connection"
          },
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "instance_id": "string",
          "last_connected_at": "2019-08-24T14:15:22Z",
          "latency": {
            "property1": {
              "latency_ms": 0,
              "preferred": true
            },
            "property2": {
              "latency_ms": 0,
              "preferred": true
            }
          },
          "lifecycle_state": "created",
          "log_sources": [
            {
              "created_at": "2019-08-24T14:15:22Z",
              "display_name": "string",
              "icon": "string",
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
            }
          ],
          "logs_length": 0,
          "logs_overflowed": true,
          "name": "string",
          "operating_system": "string",
          "parent_id": {
            "uuid": "string",
            "valid": true
          },
          "ready_at": "2019-08-24T14:15:22Z",
          "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
          "scripts": [
            {
              "cron": "string",
              "display_name": "string",
              "exit_code": 0,
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "log_path": "string",
              "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
              "run_on_start": true,
              "run_on_stop": true,
              "script": "string",
              "start_blocks_login": true,
              "status": "ok",
              "timeout": 0
            }
          ],
          "started_at": "2019-08-24T14:15:22Z",
          "startup_script_behavior": "blocking",
          "status": "connecting",
          "subsystems": [
            "envbox"
          ],
          "troubleshooting_url": "string",
          "updated_at": "2019-08-24T14:15:22Z",
          "version": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "daily_cost": 0,
      "hide": true,
      "icon": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
      "metadata": [
        {
          "key": "string",
          "sensitive": true,
          "value": "string"
        }
      ],
      "name": "string",
      "type": "string",
      "workspace_transition": "start"
    }
  ],
  "status": "pending",
  "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
  "template_version_name": "string",
  "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
  "transition": "start",
  "updated_at": "2019-08-24T14:15:22Z",
  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
  "workspace_name": "string",
  "workspace_owner_avatar_url": "string",
  "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
  "workspace_owner_name": "string"
}

Properties

Name	Type	Required	Restrictions	Description
build_number	integer	false
created_at	string	false
daily_cost	integer	false
deadline	string	false
has_ai_task	boolean	false		Deprecated: This field has been deprecated in favor of Task WorkspaceID.
has_external_agent	boolean	false
id	string	false
initiator_id	string	false
initiator_name	string	false
job	codersdk.ProvisionerJob	false
matched_provisioners	codersdk.MatchedProvisioners	false
max_deadline	string	false
reason	codersdk.BuildReason	false
resources	array of codersdk.WorkspaceResource	false
status	codersdk.WorkspaceStatus	false
template_version_id	string	false
template_version_name	string	false
template_version_preset_id	string	false
transition	codersdk.WorkspaceTransition	false
updated_at	string	false
workspace_id	string	false
workspace_name	string	false
workspace_owner_avatar_url	string	false
workspace_owner_id	string	false
workspace_owner_name	string	false		Workspace owner name is the username of the owner of the workspace.

Enumerated Values

Property	Value(s)
reason	autostart, autostop, initiator
status	canceled, canceling, deleted, deleting, failed, pending, running, starting, stopped, stopping
transition	delete, start, stop

codersdk.WorkspaceBuildParameter

{
  "name": "string",
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
name	string	false
value	string	false

codersdk.WorkspaceBuildTimings

{
  "agent_connection_timings": [
    {
      "ended_at": "2019-08-24T14:15:22Z",
      "stage": "init",
      "started_at": "2019-08-24T14:15:22Z",
      "workspace_agent_id": "string",
      "workspace_agent_name": "string"
    }
  ],
  "agent_script_timings": [
    {
      "display_name": "string",
      "ended_at": "2019-08-24T14:15:22Z",
      "exit_code": 0,
      "stage": "init",
      "started_at": "2019-08-24T14:15:22Z",
      "status": "string",
      "workspace_agent_id": "string",
      "workspace_agent_name": "string"
    }
  ],
  "provisioner_timings": [
    {
      "action": "string",
      "ended_at": "2019-08-24T14:15:22Z",
      "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
      "resource": "string",
      "source": "string",
      "stage": "init",
      "started_at": "2019-08-24T14:15:22Z"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
agent_connection_timings	array of codersdk.AgentConnectionTiming	false
agent_script_timings	array of codersdk.AgentScriptTiming	false		Agent script timings Consolidate agent-related timing metrics into a single struct when updating the API version
provisioner_timings	array of codersdk.ProvisionerTiming	false

codersdk.WorkspaceConnectionLatencyMS

{
  "p50": 0,
  "p95": 0
}

Properties

Name	Type	Required	Restrictions	Description
p50	number	false
p95	number	false

codersdk.WorkspaceDeploymentStats

{
  "building": 0,
  "connection_latency_ms": {
    "p50": 0,
    "p95": 0
  },
  "failed": 0,
  "pending": 0,
  "running": 0,
  "rx_bytes": 0,
  "stopped": 0,
  "tx_bytes": 0
}

Properties

Name	Type	Required	Restrictions	Description
building	integer	false
connection_latency_ms	codersdk.WorkspaceConnectionLatencyMS	false
failed	integer	false
pending	integer	false
running	integer	false
rx_bytes	integer	false
stopped	integer	false
tx_bytes	integer	false

codersdk.WorkspaceGroup

{
  "avatar_url": "http://example.com",
  "display_name": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "members": [
    {
      "avatar_url": "http://example.com",
      "created_at": "2019-08-24T14:15:22Z",
      "email": "user@example.com",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_service_account": true,
      "last_seen_at": "2019-08-24T14:15:22Z",
      "login_type": "",
      "name": "string",
      "status": "active",
      "theme_preference": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "username": "string"
    }
  ],
  "name": "string",
  "organization_display_name": "string",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "organization_name": "string",
  "quota_allowance": 0,
  "role": "admin",
  "source": "user",
  "total_member_count": 0
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
display_name	string	false
id	string	false
members	array of codersdk.ReducedUser	false
name	string	false
organization_display_name	string	false
organization_id	string	false
organization_name	string	false
quota_allowance	integer	false
role	codersdk.WorkspaceRole	false
source	codersdk.GroupSource	false
total_member_count	integer	false		How many members are in this group. Shows the total count, even if the user is not authorized to read group member details. May be greater than len(Group.Members).

Enumerated Values

Property	Value(s)
role	admin, use

codersdk.WorkspaceHealth

{
  "failing_agents": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "healthy": false
}

Properties

Name	Type	Required	Restrictions	Description
failing_agents	array of string	false		Failing agents lists the IDs of the agents that are failing, if any.
healthy	boolean	false		Healthy is true if the workspace is healthy.

codersdk.WorkspaceProxy

{
  "created_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "derp_enabled": true,
  "derp_only": true,
  "display_name": "string",
  "healthy": true,
  "icon_url": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "path_app_url": "string",
  "status": {
    "checked_at": "2019-08-24T14:15:22Z",
    "report": {
      "errors": [
        "string"
      ],
      "warnings": [
        "string"
      ]
    },
    "status": "ok"
  },
  "updated_at": "2019-08-24T14:15:22Z",
  "version": "string",
  "wildcard_hostname": "string"
}

Properties

Name	Type	Required	Restrictions	Description
created_at	string	false
deleted	boolean	false
derp_enabled	boolean	false
derp_only	boolean	false
display_name	string	false
healthy	boolean	false
icon_url	string	false
id	string	false
name	string	false
path_app_url	string	false		Path app URL is the URL to the base path for path apps. Optional unless wildcard_hostname is set. E.g. https://us.example.com
status	codersdk.WorkspaceProxyStatus	false		Status is the latest status check of the proxy. This will be empty for deleted proxies. This value can be used to determine if a workspace proxy is healthy and ready to use.
updated_at	string	false
version	string	false
wildcard_hostname	string	false		Wildcard hostname is the wildcard hostname for subdomain apps. E.g. .us.example.com E.g.--suffix.au.example.com Optional. Does not need to be on the same domain as PathAppURL.

codersdk.WorkspaceProxyStatus

{
  "checked_at": "2019-08-24T14:15:22Z",
  "report": {
    "errors": [
      "string"
    ],
    "warnings": [
      "string"
    ]
  },
  "status": "ok"
}

Properties

Name	Type	Required	Restrictions	Description
checked_at	string	false
report	codersdk.ProxyHealthReport	false		Report provides more information about the health of the workspace proxy.
status	codersdk.ProxyHealthStatus	false

codersdk.WorkspaceQuota

{
  "budget": 0,
  "credits_consumed": 0
}

Properties

Name	Type	Required	Restrictions	Description
budget	integer	false
credits_consumed	integer	false

codersdk.WorkspaceResource

{
  "agents": [
    {
      "api_version": "string",
      "apps": [
        {
          "command": "string",
          "display_name": "string",
          "external": true,
          "group": "string",
          "health": "disabled",
          "healthcheck": {
            "interval": 0,
            "threshold": 0,
            "url": "string"
          },
          "hidden": true,
          "icon": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "open_in": "slim-window",
          "sharing_level": "owner",
          "slug": "string",
          "statuses": [
            {
              "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
              "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
              "created_at": "2019-08-24T14:15:22Z",
              "icon": "string",
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "message": "string",
              "needs_user_attention": true,
              "state": "working",
              "uri": "string",
              "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
            }
          ],
          "subdomain": true,
          "subdomain_name": "string",
          "tooltip": "string",
          "url": "string"
        }
      ],
      "architecture": "string",
      "connection_timeout_seconds": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "directory": "string",
      "disconnected_at": "2019-08-24T14:15:22Z",
      "display_apps": [
        "vscode"
      ],
      "environment_variables": {
        "property1": "string",
        "property2": "string"
      },
      "expanded_directory": "string",
      "first_connected_at": "2019-08-24T14:15:22Z",
      "health": {
        "healthy": false,
        "reason": "agent has lost connection"
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "instance_id": "string",
      "last_connected_at": "2019-08-24T14:15:22Z",
      "latency": {
        "property1": {
          "latency_ms": 0,
          "preferred": true
        },
        "property2": {
          "latency_ms": 0,
          "preferred": true
        }
      },
      "lifecycle_state": "created",
      "log_sources": [
        {
          "created_at": "2019-08-24T14:15:22Z",
          "display_name": "string",
          "icon": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
        }
      ],
      "logs_length": 0,
      "logs_overflowed": true,
      "name": "string",
      "operating_system": "string",
      "parent_id": {
        "uuid": "string",
        "valid": true
      },
      "ready_at": "2019-08-24T14:15:22Z",
      "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
      "scripts": [
        {
          "cron": "string",
          "display_name": "string",
          "exit_code": 0,
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "log_path": "string",
          "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
          "run_on_start": true,
          "run_on_stop": true,
          "script": "string",
          "start_blocks_login": true,
          "status": "ok",
          "timeout": 0
        }
      ],
      "started_at": "2019-08-24T14:15:22Z",
      "startup_script_behavior": "blocking",
      "status": "connecting",
      "subsystems": [
        "envbox"
      ],
      "troubleshooting_url": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "version": "string"
    }
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "daily_cost": 0,
  "hide": true,
  "icon": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "metadata": [
    {
      "key": "string",
      "sensitive": true,
      "value": "string"
    }
  ],
  "name": "string",
  "type": "string",
  "workspace_transition": "start"
}

Properties

Name	Type	Required	Restrictions	Description
agents	array of codersdk.WorkspaceAgent	false
created_at	string	false
daily_cost	integer	false
hide	boolean	false
icon	string	false
id	string	false
job_id	string	false
metadata	array of codersdk.WorkspaceResourceMetadata	false
name	string	false
type	string	false
workspace_transition	codersdk.WorkspaceTransition	false

Enumerated Values

Property	Value(s)
workspace_transition	delete, start, stop

codersdk.WorkspaceResourceMetadata

{
  "key": "string",
  "sensitive": true,
  "value": "string"
}

Properties

Name	Type	Required	Restrictions	Description
key	string	false
sensitive	boolean	false
value	string	false

codersdk.WorkspaceRole

"admin"

Properties

Enumerated Values

Value(s)
``, admin, use

codersdk.WorkspaceSharingSettings

{
  "shareable_workspace_owners": "none",
  "sharing_disabled": true,
  "sharing_globally_disabled": true
}

Properties

Name	Type	Required	Restrictions	Description
shareable_workspace_owners	codersdk.ShareableWorkspaceOwners	false		Shareable workspace owners controls whose workspaces can be shared within the organization.
sharing_disabled	boolean	false		Sharing disabled is deprecated and left for backward compatibility purposes. Deprecated: use ShareableWorkspaceOwners instead
sharing_globally_disabled	boolean	false		Sharing globally disabled is true if sharing has been disabled for this organization because of a deployment-wide setting.

Enumerated Values

Property	Value(s)
shareable_workspace_owners	everyone, none, service_accounts

codersdk.WorkspaceStatus

"pending"

Properties

Enumerated Values

Value(s)
canceled, canceling, deleted, deleting, failed, pending, running, starting, stopped, stopping

codersdk.WorkspaceTransition

"start"

Properties

Enumerated Values

Value(s)
delete, start, stop

codersdk.WorkspaceUser

{
  "avatar_url": "http://example.com",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "role": "admin",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avatar_url	string	false
id	string	true
name	string	false
role	codersdk.WorkspaceRole	false
username	string	true

Enumerated Values

Property	Value(s)
role	admin, use

codersdk.WorkspacesResponse

{
  "count": 0,
  "workspaces": [
    {
      "allow_renames": true,
      "automatic_updates": "always",
      "autostart_schedule": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "deleting_at": "2019-08-24T14:15:22Z",
      "dormant_at": "2019-08-24T14:15:22Z",
      "favorite": true,
      "health": {
        "failing_agents": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "healthy": false
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "is_prebuild": true,
      "last_used_at": "2019-08-24T14:15:22Z",
      "latest_app_status": {
        "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
        "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
        "created_at": "2019-08-24T14:15:22Z",
        "icon": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "message": "string",
        "needs_user_attention": true,
        "state": "working",
        "uri": "string",
        "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
      },
      "latest_build": {
        "build_number": 0,
        "created_at": "2019-08-24T14:15:22Z",
        "daily_cost": 0,
        "deadline": "2019-08-24T14:15:22Z",
        "has_ai_task": true,
        "has_external_agent": true,
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
        "initiator_name": "string",
        "job": {
          "available_workers": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          ],
          "canceled_at": "2019-08-24T14:15:22Z",
          "completed_at": "2019-08-24T14:15:22Z",
          "created_at": "2019-08-24T14:15:22Z",
          "error": "string",
          "error_code": "REQUIRED_TEMPLATE_VARIABLES",
          "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "initiator_id": "06588898-9a84-4b35-ba8f-f9cbd64946f3",
          "input": {
            "error": "string",
            "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
            "workspace_build_id": "badaf2eb-96c5-4050-9f1d-db2d39ca5478"
          },
          "logs_overflowed": true,
          "metadata": {
            "template_display_name": "string",
            "template_icon": "string",
            "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
            "template_name": "string",
            "template_version_name": "string",
            "workspace_build_transition": "start",
            "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
            "workspace_name": "string"
          },
          "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
          "queue_position": 0,
          "queue_size": 0,
          "started_at": "2019-08-24T14:15:22Z",
          "status": "pending",
          "tags": {
            "property1": "string",
            "property2": "string"
          },
          "type": "template_version_import",
          "worker_id": "ae5fa6f7-c55b-40c1-b40a-b36ac467652b",
          "worker_name": "string"
        },
        "matched_provisioners": {
          "available": 0,
          "count": 0,
          "most_recently_seen": "2019-08-24T14:15:22Z"
        },
        "max_deadline": "2019-08-24T14:15:22Z",
        "reason": "initiator",
        "resources": [
          {
            "agents": [
              {
                "api_version": "string",
                "apps": [
                  {
                    "command": "string",
                    "display_name": "string",
                    "external": true,
                    "group": "string",
                    "health": "disabled",
                    "healthcheck": {},
                    "hidden": true,
                    "icon": "string",
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "open_in": "slim-window",
                    "sharing_level": "owner",
                    "slug": "string",
                    "statuses": [],
                    "subdomain": true,
                    "subdomain_name": "string",
                    "tooltip": "string",
                    "url": "string"
                  }
                ],
                "architecture": "string",
                "connection_timeout_seconds": 0,
                "created_at": "2019-08-24T14:15:22Z",
                "directory": "string",
                "disconnected_at": "2019-08-24T14:15:22Z",
                "display_apps": [
                  "vscode"
                ],
                "environment_variables": {
                  "property1": "string",
                  "property2": "string"
                },
                "expanded_directory": "string",
                "first_connected_at": "2019-08-24T14:15:22Z",
                "health": {
                  "healthy": false,
                  "reason": "agent has lost connection"
                },
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "instance_id": "string",
                "last_connected_at": "2019-08-24T14:15:22Z",
                "latency": {
                  "property1": {
                    "latency_ms": 0,
                    "preferred": true
                  },
                  "property2": {
                    "latency_ms": 0,
                    "preferred": true
                  }
                },
                "lifecycle_state": "created",
                "log_sources": [
                  {
                    "created_at": "2019-08-24T14:15:22Z",
                    "display_name": "string",
                    "icon": "string",
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "workspace_agent_id": "7ad2e618-fea7-4c1a-b70a-f501566a72f1"
                  }
                ],
                "logs_length": 0,
                "logs_overflowed": true,
                "name": "string",
                "operating_system": "string",
                "parent_id": {
                  "uuid": "string",
                  "valid": true
                },
                "ready_at": "2019-08-24T14:15:22Z",
                "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
                "scripts": [
                  {
                    "cron": "string",
                    "display_name": "string",
                    "exit_code": 0,
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "log_path": "string",
                    "log_source_id": "4197ab25-95cf-4b91-9c78-f7f2af5d353a",
                    "run_on_start": true,
                    "run_on_stop": true,
                    "script": "string",
                    "start_blocks_login": true,
                    "status": "ok",
                    "timeout": 0
                  }
                ],
                "started_at": "2019-08-24T14:15:22Z",
                "startup_script_behavior": "blocking",
                "status": "connecting",
                "subsystems": [
                  "envbox"
                ],
                "troubleshooting_url": "string",
                "updated_at": "2019-08-24T14:15:22Z",
                "version": "string"
              }
            ],
            "created_at": "2019-08-24T14:15:22Z",
            "daily_cost": 0,
            "hide": true,
            "icon": "string",
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
            "metadata": [
              {
                "key": "string",
                "sensitive": true,
                "value": "string"
              }
            ],
            "name": "string",
            "type": "string",
            "workspace_transition": "start"
          }
        ],
        "status": "pending",
        "template_version_id": "0ba39c92-1f1b-4c32-aa3e-9925d7713eb1",
        "template_version_name": "string",
        "template_version_preset_id": "512a53a7-30da-446e-a1fc-713c630baff1",
        "transition": "start",
        "updated_at": "2019-08-24T14:15:22Z",
        "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
        "workspace_name": "string",
        "workspace_owner_avatar_url": "string",
        "workspace_owner_id": "e7078695-5279-4c86-8774-3ac2367a2fc7",
        "workspace_owner_name": "string"
      },
      "name": "string",
      "next_start_at": "2019-08-24T14:15:22Z",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "organization_name": "string",
      "outdated": true,
      "owner_avatar_url": "string",
      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
      "owner_name": "string",
      "shared_with": [
        {
          "actor_type": "group",
          "avatar_url": "http://example.com",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "roles": [
            "admin"
          ]
        }
      ],
      "task_id": {
        "uuid": "string",
        "valid": true
      },
      "template_active_version_id": "b0da9c29-67d8-4c87-888c-bafe356f7f3c",
      "template_allow_user_cancel_workspace_jobs": true,
      "template_display_name": "string",
      "template_icon": "string",
      "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
      "template_name": "string",
      "template_require_active_version": true,
      "template_use_classic_parameter_flow": true,
      "ttl_ms": 0,
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
count	integer	false
workspaces	array of codersdk.Workspace	false

derp.BytesSentRecv

{
  "key": {},
  "recv": 0,
  "sent": 0
}

Properties

Name	Type	Required	Restrictions	Description
key	key.NodePublic	false		Key is the public key of the client which sent/received these bytes.
recv	integer	false
sent	integer	false

derp.ServerInfoMessage

{
  "tokenBucketBytesBurst": 0,
  "tokenBucketBytesPerSecond": 0
}

Properties

Name	Type	Required	Restrictions	Description
tokenBucketBytesBurst	integer	false		Tokenbucketbytesburst is how many bytes the server will allow to burst, temporarily violating TokenBucketBytesPerSecond.
Zero means unspecified. There might be a limit, but the client need not try to respect it.
tokenBucketBytesPerSecond	integer	false		Tokenbucketbytespersecond is how many bytes per second the server says it will accept, including all framing bytes.
Zero means unspecified. There might be a limit, but the client need not try to respect it.

health.Code

"EUNKNOWN"

Properties

Enumerated Values

Value(s)
EACS01, EACS02, EACS03, EACS04, EDB01, EDB02, EDERP01, EDERP02, EDERP03, EPD01, EPD02, EPD03, EUNKNOWN, EWP01, EWP02, EWP04, EWS01, EWS02, EWS03

health.Message

{
  "code": "EUNKNOWN",
  "message": "string"
}

Properties

Name	Type	Required	Restrictions	Description
code	health.Code	false
message	string	false

health.Severity

"ok"

Properties

Enumerated Values

Value(s)
error, ok, warning

healthsdk.AccessURLReport

{
  "access_url": "string",
  "dismissed": true,
  "error": "string",
  "healthy": true,
  "healthz_response": "string",
  "reachable": true,
  "severity": "ok",
  "status_code": 0,
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
access_url	string	false
dismissed	boolean	false
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
healthz_response	string	false
reachable	boolean	false
severity	health.Severity	false
status_code	integer	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.DERPHealthReport

{
  "dismissed": true,
  "error": "string",
  "healthy": true,
  "netcheck": {
    "captivePortal": "string",
    "globalV4": "string",
    "globalV6": "string",
    "hairPinning": "string",
    "icmpv4": true,
    "ipv4": true,
    "ipv4CanSend": true,
    "ipv6": true,
    "ipv6CanSend": true,
    "mappingVariesByDestIP": "string",
    "oshasIPv6": true,
    "pcp": "string",
    "pmp": "string",
    "preferredDERP": 0,
    "regionLatency": {
      "property1": 0,
      "property2": 0
    },
    "regionV4Latency": {
      "property1": 0,
      "property2": 0
    },
    "regionV6Latency": {
      "property1": 0,
      "property2": 0
    },
    "udp": true,
    "upnP": "string"
  },
  "netcheck_err": "string",
  "netcheck_logs": [
    "string"
  ],
  "regions": {
    "property1": {
      "error": "string",
      "healthy": true,
      "node_reports": [
        {
          "can_exchange_messages": true,
          "client_errs": [
            [
              "string"
            ]
          ],
          "client_logs": [
            [
              "string"
            ]
          ],
          "error": "string",
          "healthy": true,
          "node": {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          },
          "node_info": {
            "tokenBucketBytesBurst": 0,
            "tokenBucketBytesPerSecond": 0
          },
          "round_trip_ping": "string",
          "round_trip_ping_ms": 0,
          "severity": "ok",
          "stun": {
            "canSTUN": true,
            "enabled": true,
            "error": "string"
          },
          "uses_websocket": true,
          "warnings": [
            {
              "code": "EUNKNOWN",
              "message": "string"
            }
          ]
        }
      ],
      "region": {
        "avoid": true,
        "embeddedRelay": true,
        "nodes": [
          {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          }
        ],
        "regionCode": "string",
        "regionID": 0,
        "regionName": "string"
      },
      "severity": "ok",
      "warnings": [
        {
          "code": "EUNKNOWN",
          "message": "string"
        }
      ]
    },
    "property2": {
      "error": "string",
      "healthy": true,
      "node_reports": [
        {
          "can_exchange_messages": true,
          "client_errs": [
            [
              "string"
            ]
          ],
          "client_logs": [
            [
              "string"
            ]
          ],
          "error": "string",
          "healthy": true,
          "node": {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          },
          "node_info": {
            "tokenBucketBytesBurst": 0,
            "tokenBucketBytesPerSecond": 0
          },
          "round_trip_ping": "string",
          "round_trip_ping_ms": 0,
          "severity": "ok",
          "stun": {
            "canSTUN": true,
            "enabled": true,
            "error": "string"
          },
          "uses_websocket": true,
          "warnings": [
            {
              "code": "EUNKNOWN",
              "message": "string"
            }
          ]
        }
      ],
      "region": {
        "avoid": true,
        "embeddedRelay": true,
        "nodes": [
          {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          }
        ],
        "regionCode": "string",
        "regionID": 0,
        "regionName": "string"
      },
      "severity": "ok",
      "warnings": [
        {
          "code": "EUNKNOWN",
          "message": "string"
        }
      ]
    }
  },
  "severity": "ok",
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
dismissed	boolean	false
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
netcheck	netcheck.Report	false
netcheck_err	string	false
netcheck_logs	array of string	false
regions	object	false
» [any property]	healthsdk.DERPRegionReport	false
severity	health.Severity	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.DERPNodeReport

{
  "can_exchange_messages": true,
  "client_errs": [
    [
      "string"
    ]
  ],
  "client_logs": [
    [
      "string"
    ]
  ],
  "error": "string",
  "healthy": true,
  "node": {
    "canPort80": true,
    "certName": "string",
    "derpport": 0,
    "forceHTTP": true,
    "hostName": "string",
    "insecureForTests": true,
    "ipv4": "string",
    "ipv6": "string",
    "name": "string",
    "regionID": 0,
    "stunonly": true,
    "stunport": 0,
    "stuntestIP": "string"
  },
  "node_info": {
    "tokenBucketBytesBurst": 0,
    "tokenBucketBytesPerSecond": 0
  },
  "round_trip_ping": "string",
  "round_trip_ping_ms": 0,
  "severity": "ok",
  "stun": {
    "canSTUN": true,
    "enabled": true,
    "error": "string"
  },
  "uses_websocket": true,
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
can_exchange_messages	boolean	false
client_errs	array of array	false
client_logs	array of array	false
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
node	tailcfg.DERPNode	false
node_info	derp.ServerInfoMessage	false
round_trip_ping	string	false
round_trip_ping_ms	integer	false
severity	health.Severity	false
stun	healthsdk.STUNReport	false
uses_websocket	boolean	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.DERPRegionReport

{
  "error": "string",
  "healthy": true,
  "node_reports": [
    {
      "can_exchange_messages": true,
      "client_errs": [
        [
          "string"
        ]
      ],
      "client_logs": [
        [
          "string"
        ]
      ],
      "error": "string",
      "healthy": true,
      "node": {
        "canPort80": true,
        "certName": "string",
        "derpport": 0,
        "forceHTTP": true,
        "hostName": "string",
        "insecureForTests": true,
        "ipv4": "string",
        "ipv6": "string",
        "name": "string",
        "regionID": 0,
        "stunonly": true,
        "stunport": 0,
        "stuntestIP": "string"
      },
      "node_info": {
        "tokenBucketBytesBurst": 0,
        "tokenBucketBytesPerSecond": 0
      },
      "round_trip_ping": "string",
      "round_trip_ping_ms": 0,
      "severity": "ok",
      "stun": {
        "canSTUN": true,
        "enabled": true,
        "error": "string"
      },
      "uses_websocket": true,
      "warnings": [
        {
          "code": "EUNKNOWN",
          "message": "string"
        }
      ]
    }
  ],
  "region": {
    "avoid": true,
    "embeddedRelay": true,
    "nodes": [
      {
        "canPort80": true,
        "certName": "string",
        "derpport": 0,
        "forceHTTP": true,
        "hostName": "string",
        "insecureForTests": true,
        "ipv4": "string",
        "ipv6": "string",
        "name": "string",
        "regionID": 0,
        "stunonly": true,
        "stunport": 0,
        "stuntestIP": "string"
      }
    ],
    "regionCode": "string",
    "regionID": 0,
    "regionName": "string"
  },
  "severity": "ok",
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
node_reports	array of healthsdk.DERPNodeReport	false
region	tailcfg.DERPRegion	false
severity	health.Severity	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.DatabaseReport

{
  "dismissed": true,
  "error": "string",
  "healthy": true,
  "latency": "string",
  "latency_ms": 0,
  "reachable": true,
  "severity": "ok",
  "threshold_ms": 0,
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
dismissed	boolean	false
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
latency	string	false
latency_ms	integer	false
reachable	boolean	false
severity	health.Severity	false
threshold_ms	integer	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.HealthSection

"DERP"

Properties

Enumerated Values

Value(s)
AccessURL, DERP, Database, ProvisionerDaemons, Websocket, WorkspaceProxy

healthsdk.HealthSettings

{
  "dismissed_healthchecks": [
    "DERP"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
dismissed_healthchecks	array of healthsdk.HealthSection	false

healthsdk.HealthcheckReport

{
  "access_url": {
    "access_url": "string",
    "dismissed": true,
    "error": "string",
    "healthy": true,
    "healthz_response": "string",
    "reachable": true,
    "severity": "ok",
    "status_code": 0,
    "warnings": [
      {
        "code": "EUNKNOWN",
        "message": "string"
      }
    ]
  },
  "coder_version": "string",
  "database": {
    "dismissed": true,
    "error": "string",
    "healthy": true,
    "latency": "string",
    "latency_ms": 0,
    "reachable": true,
    "severity": "ok",
    "threshold_ms": 0,
    "warnings": [
      {
        "code": "EUNKNOWN",
        "message": "string"
      }
    ]
  },
  "derp": {
    "dismissed": true,
    "error": "string",
    "healthy": true,
    "netcheck": {
      "captivePortal": "string",
      "globalV4": "string",
      "globalV6": "string",
      "hairPinning": "string",
      "icmpv4": true,
      "ipv4": true,
      "ipv4CanSend": true,
      "ipv6": true,
      "ipv6CanSend": true,
      "mappingVariesByDestIP": "string",
      "oshasIPv6": true,
      "pcp": "string",
      "pmp": "string",
      "preferredDERP": 0,
      "regionLatency": {
        "property1": 0,
        "property2": 0
      },
      "regionV4Latency": {
        "property1": 0,
        "property2": 0
      },
      "regionV6Latency": {
        "property1": 0,
        "property2": 0
      },
      "udp": true,
      "upnP": "string"
    },
    "netcheck_err": "string",
    "netcheck_logs": [
      "string"
    ],
    "regions": {
      "property1": {
        "error": "string",
        "healthy": true,
        "node_reports": [
          {
            "can_exchange_messages": true,
            "client_errs": [
              [
                "string"
              ]
            ],
            "client_logs": [
              [
                "string"
              ]
            ],
            "error": "string",
            "healthy": true,
            "node": {
              "canPort80": true,
              "certName": "string",
              "derpport": 0,
              "forceHTTP": true,
              "hostName": "string",
              "insecureForTests": true,
              "ipv4": "string",
              "ipv6": "string",
              "name": "string",
              "regionID": 0,
              "stunonly": true,
              "stunport": 0,
              "stuntestIP": "string"
            },
            "node_info": {
              "tokenBucketBytesBurst": 0,
              "tokenBucketBytesPerSecond": 0
            },
            "round_trip_ping": "string",
            "round_trip_ping_ms": 0,
            "severity": "ok",
            "stun": {
              "canSTUN": true,
              "enabled": true,
              "error": "string"
            },
            "uses_websocket": true,
            "warnings": [
              {
                "code": "EUNKNOWN",
                "message": "string"
              }
            ]
          }
        ],
        "region": {
          "avoid": true,
          "embeddedRelay": true,
          "nodes": [
            {
              "canPort80": true,
              "certName": "string",
              "derpport": 0,
              "forceHTTP": true,
              "hostName": "string",
              "insecureForTests": true,
              "ipv4": "string",
              "ipv6": "string",
              "name": "string",
              "regionID": 0,
              "stunonly": true,
              "stunport": 0,
              "stuntestIP": "string"
            }
          ],
          "regionCode": "string",
          "regionID": 0,
          "regionName": "string"
        },
        "severity": "ok",
        "warnings": [
          {
            "code": "EUNKNOWN",
            "message": "string"
          }
        ]
      },
      "property2": {
        "error": "string",
        "healthy": true,
        "node_reports": [
          {
            "can_exchange_messages": true,
            "client_errs": [
              [
                "string"
              ]
            ],
            "client_logs": [
              [
                "string"
              ]
            ],
            "error": "string",
            "healthy": true,
            "node": {
              "canPort80": true,
              "certName": "string",
              "derpport": 0,
              "forceHTTP": true,
              "hostName": "string",
              "insecureForTests": true,
              "ipv4": "string",
              "ipv6": "string",
              "name": "string",
              "regionID": 0,
              "stunonly": true,
              "stunport": 0,
              "stuntestIP": "string"
            },
            "node_info": {
              "tokenBucketBytesBurst": 0,
              "tokenBucketBytesPerSecond": 0
            },
            "round_trip_ping": "string",
            "round_trip_ping_ms": 0,
            "severity": "ok",
            "stun": {
              "canSTUN": true,
              "enabled": true,
              "error": "string"
            },
            "uses_websocket": true,
            "warnings": [
              {
                "code": "EUNKNOWN",
                "message": "string"
              }
            ]
          }
        ],
        "region": {
          "avoid": true,
          "embeddedRelay": true,
          "nodes": [
            {
              "canPort80": true,
              "certName": "string",
              "derpport": 0,
              "forceHTTP": true,
              "hostName": "string",
              "insecureForTests": true,
              "ipv4": "string",
              "ipv6": "string",
              "name": "string",
              "regionID": 0,
              "stunonly": true,
              "stunport": 0,
              "stuntestIP": "string"
            }
          ],
          "regionCode": "string",
          "regionID": 0,
          "regionName": "string"
        },
        "severity": "ok",
        "warnings": [
          {
            "code": "EUNKNOWN",
            "message": "string"
          }
        ]
      }
    },
    "severity": "ok",
    "warnings": [
      {
        "code": "EUNKNOWN",
        "message": "string"
      }
    ]
  },
  "healthy": true,
  "provisioner_daemons": {
    "dismissed": true,
    "error": "string",
    "items": [
      {
        "provisioner_daemon": {
          "api_version": "string",
          "created_at": "2019-08-24T14:15:22Z",
          "current_job": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "status": "pending",
            "template_display_name": "string",
            "template_icon": "string",
            "template_name": "string"
          },
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "key_id": "1e779c8a-6786-4c89-b7c3-a6666f5fd6b5",
          "key_name": "string",
          "last_seen_at": "2019-08-24T14:15:22Z",
          "name": "string",
          "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
          "previous_job": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "status": "pending",
            "template_display_name": "string",
            "template_icon": "string",
            "template_name": "string"
          },
          "provisioners": [
            "string"
          ],
          "status": "offline",
          "tags": {
            "property1": "string",
            "property2": "string"
          },
          "version": "string"
        },
        "warnings": [
          {
            "code": "EUNKNOWN",
            "message": "string"
          }
        ]
      }
    ],
    "severity": "ok",
    "warnings": [
      {
        "code": "EUNKNOWN",
        "message": "string"
      }
    ]
  },
  "severity": "ok",
  "time": "2019-08-24T14:15:22Z",
  "websocket": {
    "body": "string",
    "code": 0,
    "dismissed": true,
    "error": "string",
    "healthy": true,
    "severity": "ok",
    "warnings": [
      {
        "code": "EUNKNOWN",
        "message": "string"
      }
    ]
  },
  "workspace_proxy": {
    "dismissed": true,
    "error": "string",
    "healthy": true,
    "severity": "ok",
    "warnings": [
      {
        "code": "EUNKNOWN",
        "message": "string"
      }
    ],
    "workspace_proxies": {
      "regions": [
        {
          "created_at": "2019-08-24T14:15:22Z",
          "deleted": true,
          "derp_enabled": true,
          "derp_only": true,
          "display_name": "string",
          "healthy": true,
          "icon_url": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "path_app_url": "string",
          "status": {
            "checked_at": "2019-08-24T14:15:22Z",
            "report": {
              "errors": [
                "string"
              ],
              "warnings": [
                "string"
              ]
            },
            "status": "ok"
          },
          "updated_at": "2019-08-24T14:15:22Z",
          "version": "string",
          "wildcard_hostname": "string"
        }
      ]
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
access_url	healthsdk.AccessURLReport	false
coder_version	string	false		The Coder version of the server that the report was generated on.
database	healthsdk.DatabaseReport	false
derp	healthsdk.DERPHealthReport	false
healthy	boolean	false		Healthy is true if the report returns no errors. Deprecated: use Severity instead
provisioner_daemons	healthsdk.ProvisionerDaemonsReport	false
severity	health.Severity	false		Severity indicates the status of Coder health.
time	string	false		Time is the time the report was generated at.
websocket	healthsdk.WebsocketReport	false
workspace_proxy	healthsdk.WorkspaceProxyReport	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.ProvisionerDaemonsReport

{
  "dismissed": true,
  "error": "string",
  "items": [
    {
      "provisioner_daemon": {
        "api_version": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "current_job": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "status": "pending",
          "template_display_name": "string",
          "template_icon": "string",
          "template_name": "string"
        },
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "key_id": "1e779c8a-6786-4c89-b7c3-a6666f5fd6b5",
        "key_name": "string",
        "last_seen_at": "2019-08-24T14:15:22Z",
        "name": "string",
        "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
        "previous_job": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "status": "pending",
          "template_display_name": "string",
          "template_icon": "string",
          "template_name": "string"
        },
        "provisioners": [
          "string"
        ],
        "status": "offline",
        "tags": {
          "property1": "string",
          "property2": "string"
        },
        "version": "string"
      },
      "warnings": [
        {
          "code": "EUNKNOWN",
          "message": "string"
        }
      ]
    }
  ],
  "severity": "ok",
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
dismissed	boolean	false
error	string	false
items	array of healthsdk.ProvisionerDaemonsReportItem	false
severity	health.Severity	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.ProvisionerDaemonsReportItem

{
  "provisioner_daemon": {
    "api_version": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "current_job": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "status": "pending",
      "template_display_name": "string",
      "template_icon": "string",
      "template_name": "string"
    },
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "key_id": "1e779c8a-6786-4c89-b7c3-a6666f5fd6b5",
    "key_name": "string",
    "last_seen_at": "2019-08-24T14:15:22Z",
    "name": "string",
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "previous_job": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "status": "pending",
      "template_display_name": "string",
      "template_icon": "string",
      "template_name": "string"
    },
    "provisioners": [
      "string"
    ],
    "status": "offline",
    "tags": {
      "property1": "string",
      "property2": "string"
    },
    "version": "string"
  },
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
provisioner_daemon	codersdk.ProvisionerDaemon	false
warnings	array of health.Message	false

healthsdk.STUNReport

{
  "canSTUN": true,
  "enabled": true,
  "error": "string"
}

Properties

Name	Type	Required	Restrictions	Description
canSTUN	boolean	false
enabled	boolean	false
error	string	false

healthsdk.UpdateHealthSettings

{
  "dismissed_healthchecks": [
    "DERP"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
dismissed_healthchecks	array of healthsdk.HealthSection	false

healthsdk.WebsocketReport

{
  "body": "string",
  "code": 0,
  "dismissed": true,
  "error": "string",
  "healthy": true,
  "severity": "ok",
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
body	string	false
code	integer	false
dismissed	boolean	false
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
severity	health.Severity	false
warnings	array of health.Message	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

healthsdk.WorkspaceProxyReport

{
  "dismissed": true,
  "error": "string",
  "healthy": true,
  "severity": "ok",
  "warnings": [
    {
      "code": "EUNKNOWN",
      "message": "string"
    }
  ],
  "workspace_proxies": {
    "regions": [
      {
        "created_at": "2019-08-24T14:15:22Z",
        "deleted": true,
        "derp_enabled": true,
        "derp_only": true,
        "display_name": "string",
        "healthy": true,
        "icon_url": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "path_app_url": "string",
        "status": {
          "checked_at": "2019-08-24T14:15:22Z",
          "report": {
            "errors": [
              "string"
            ],
            "warnings": [
              "string"
            ]
          },
          "status": "ok"
        },
        "updated_at": "2019-08-24T14:15:22Z",
        "version": "string",
        "wildcard_hostname": "string"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
dismissed	boolean	false
error	string	false
healthy	boolean	false		Healthy is deprecated and left for backward compatibility purposes, use Severity instead.
severity	health.Severity	false
warnings	array of health.Message	false
workspace_proxies	codersdk.RegionsResponse-codersdk_WorkspaceProxy	false

Enumerated Values

Property	Value(s)
severity	error, ok, warning

key.NodePublic

{}

Properties

None

legacyscim.SCIMUser

{
  "active": true,
  "emails": [
    {
      "display": "string",
      "primary": true,
      "type": "string",
      "value": "user@example.com"
    }
  ],
  "groups": [
    null
  ],
  "id": "string",
  "meta": {
    "resourceType": "string"
  },
  "name": {
    "familyName": "string",
    "givenName": "string"
  },
  "schemas": [
    "string"
  ],
  "userName": "string"
}

Properties

Name	Type	Required	Restrictions	Description
active	boolean	false		Active is a ptr to prevent the empty value from being interpreted as false.
emails	array of object	false
» display	string	false
» primary	boolean	false
» type	string	false
» value	string	false
groups	array of undefined	false
id	string	false
meta	object	false
» resourceType	string	false
name	object	false
» familyName	string	false
» givenName	string	false
schemas	array of string	false
userName	string	false

netcheck.Report

{
  "captivePortal": "string",
  "globalV4": "string",
  "globalV6": "string",
  "hairPinning": "string",
  "icmpv4": true,
  "ipv4": true,
  "ipv4CanSend": true,
  "ipv6": true,
  "ipv6CanSend": true,
  "mappingVariesByDestIP": "string",
  "oshasIPv6": true,
  "pcp": "string",
  "pmp": "string",
  "preferredDERP": 0,
  "regionLatency": {
    "property1": 0,
    "property2": 0
  },
  "regionV4Latency": {
    "property1": 0,
    "property2": 0
  },
  "regionV6Latency": {
    "property1": 0,
    "property2": 0
  },
  "udp": true,
  "upnP": "string"
}

Properties

Name	Type	Required	Restrictions	Description
captivePortal	string	false		Captiveportal is set when we think there's a captive portal that is intercepting HTTP traffic.
globalV4	string	false		ip:port of global IPv4
globalV6	string	false		[ip]:port of global IPv6
hairPinning	string	false		Hairpinning is whether the router supports communicating between two local devices through the NATted public IP address (on IPv4).
icmpv4	boolean	false		an ICMPv4 round trip completed
ipv4	boolean	false		an IPv4 STUN round trip completed
ipv4CanSend	boolean	false		an IPv4 packet was able to be sent
ipv6	boolean	false		an IPv6 STUN round trip completed
ipv6CanSend	boolean	false		an IPv6 packet was able to be sent
mappingVariesByDestIP	string	false		Mappingvariesbydestip is whether STUN results depend which STUN server you're talking to (on IPv4).
oshasIPv6	boolean	false		could bind a socket to ::1
pcp	string	false		Pcp is whether PCP appears present on the LAN. Empty means not checked.
pmp	string	false		Pmp is whether NAT-PMP appears present on the LAN. Empty means not checked.
preferredDERP	integer	false		or 0 for unknown
regionLatency	object	false		keyed by DERP Region ID
» [any property]	integer	false
regionV4Latency	object	false		keyed by DERP Region ID
» [any property]	integer	false
regionV6Latency	object	false		keyed by DERP Region ID
» [any property]	integer	false
udp	boolean	false		a UDP STUN round trip completed
upnP	string	false		Upnp is whether UPnP appears present on the LAN. Empty means not checked.

oauth2.Token

{
  "access_token": "string",
  "expires_in": 0,
  "expiry": "string",
  "refresh_token": "string",
  "token_type": "string"
}

Properties

Name	Type	Required	Restrictions	Description
access_token	string	false		Access token is the token that authorizes and authenticates the requests.
expires_in	integer	false		Expires in is the OAuth2 wire format "expires_in" field, which specifies how many seconds later the token expires, relative to an unknown time base approximately around "now". It is the application's responsibility to populate Expiry from ExpiresIn when required.
expiry	string	false		Expiry is the optional expiration time of the access token.
If zero, [TokenSource] implementations will reuse the same token forever and RefreshToken or equivalent mechanisms for that TokenSource will not be used.
refresh_token	string	false		Refresh token is a token that's used by the application (as opposed to the user) to refresh the access token if it expires.
token_type	string	false		Token type is the type of token. The Type method returns either this or "Bearer", the default.

regexp.Regexp

{}

Properties

None

serpent.Annotations

{
  "property1": "string",
  "property2": "string"
}

Properties

Name	Type	Required	Restrictions	Description
[any property]	string	false

serpent.Group

{
  "description": "string",
  "name": "string",
  "parent": {
    "description": "string",
    "name": "string",
    "parent": {},
    "yaml": "string"
  },
  "yaml": "string"
}

Properties

Name	Type	Required	Restrictions	Description
description	string	false
name	string	false
parent	serpent.Group	false
yaml	string	false

serpent.HostPort

{
  "host": "string",
  "port": "string"
}

Properties

Name	Type	Required	Restrictions	Description
host	string	false
port	string	false

serpent.Option

{
  "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": [
    {
      "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"
    }
  ],
  "value": null,
  "value_source": "",
  "yaml": "string"
}

Properties

Name	Type	Required	Restrictions	Description
annotations	serpent.Annotations	false		Annotations enable extensions to serpent higher up in the stack. It's useful for help formatting and documentation generation.
default	string	false		Default is parsed into Value if set. Must be "" if DefaultFn != nil
description	string	false
env	string	false		Env is the environment variable used to configure this option. If unset, environment configuring is disabled.
flag	string	false		Flag is the long name of the flag used to configure this option. If unset, flag configuring is disabled.
flag_shorthand	string	false		Flag shorthand is the one-character shorthand for the flag. If unset, no shorthand is used.
group	serpent.Group	false		Group is a group hierarchy that helps organize this option in help, configs and other documentation.
hidden	boolean	false
name	string	false
required	boolean	false		Required means this value must be set by some means. It requires ValueSource != ValueSourceNone If Default is set, then Required is ignored.
use_instead	array of serpent.Option	false		Use instead is a list of options that should be used instead of this one. The field is used to generate a deprecation warning.
value	any	false		Value includes the types listed in values.go.
value_source	serpent.ValueSource	false
yaml	string	false		Yaml is the YAML key used to configure this option. If unset, YAML configuring is disabled.

serpent.Regexp

{}

Properties

None

serpent.Struct-array_codersdk_ExternalAuthConfig

{
  "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,
      "regex": "string",
      "revoke_url": "string",
      "scopes": [
        "string"
      ],
      "token_url": "string",
      "type": "string",
      "validate_url": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
value	array of codersdk.ExternalAuthConfig	false

serpent.Struct-array_codersdk_LinkConfig

{
  "value": [
    {
      "icon": "bug",
      "location": "navbar",
      "name": "string",
      "target": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
value	array of codersdk.LinkConfig	false

serpent.URL

{
  "forceQuery": true,
  "fragment": "string",
  "host": "string",
  "omitHost": true,
  "opaque": "string",
  "path": "string",
  "rawFragment": "string",
  "rawPath": "string",
  "rawQuery": "string",
  "scheme": "string",
  "user": {}
}

Properties

Name	Type	Required	Restrictions	Description
forceQuery	boolean	false		Forcequery indicates whether the original URL contained a query ('?') character. When set, the String method will include a trailing '?', even when RawQuery is empty.
fragment	string	false		fragment for references (without '#')
host	string	false		"host" or "host:port" (see Hostname and Port methods)
omitHost	boolean	false		Omithost indicates the URL has an empty host (authority). When set, the String method will not include the host when it is empty.
opaque	string	false		encoded opaque data
path	string	false		path (relative paths may omit leading slash)
rawFragment	string	false		Rawfragment is an optional field containing an encoded fragment hint. See the EscapedFragment method for more details.
In general, code should call EscapedFragment instead of reading RawFragment.
rawPath	string	false		Rawpath is an optional field containing an encoded path hint. See the EscapedPath method for more details.
In general, code should call EscapedPath instead of reading RawPath.
rawQuery	string	false		Rawquery contains the encoded query values, without the initial '?'. Use URL.Query to decode the query.
scheme	string	false
user	url.Userinfo	false		username and password information

serpent.ValueSource

""

Properties

Enumerated Values

Value(s)
``, default, env, flag, yaml

tailcfg.DERPHomeParams

{
  "regionScore": {
    "property1": 0,
    "property2": 0
  }
}

Properties

Name	Type	Required	Restrictions	Description
regionScore	object	false		Regionscore scales latencies of DERP regions by a given scaling factor when determining which region to use as the home ("preferred") DERP. Scores in the range (0, 1) will cause this region to be proportionally more preferred, and scores in the range (1, ∞) will penalize a region.
If a region is not present in this map, it is treated as having a score of 1.0.
Scores should not be 0 or negative; such scores will be ignored.
A nil map means no change from the previous value (if any); an empty non-nil map can be sent to reset all scores back to 1.0.
» [any property]	number	false

tailcfg.DERPMap

{
  "homeParams": {
    "regionScore": {
      "property1": 0,
      "property2": 0
    }
  },
  "omitDefaultRegions": true,
  "regions": {
    "property1": {
      "avoid": true,
      "embeddedRelay": true,
      "nodes": [
        {
          "canPort80": true,
          "certName": "string",
          "derpport": 0,
          "forceHTTP": true,
          "hostName": "string",
          "insecureForTests": true,
          "ipv4": "string",
          "ipv6": "string",
          "name": "string",
          "regionID": 0,
          "stunonly": true,
          "stunport": 0,
          "stuntestIP": "string"
        }
      ],
      "regionCode": "string",
      "regionID": 0,
      "regionName": "string"
    },
    "property2": {
      "avoid": true,
      "embeddedRelay": true,
      "nodes": [
        {
          "canPort80": true,
          "certName": "string",
          "derpport": 0,
          "forceHTTP": true,
          "hostName": "string",
          "insecureForTests": true,
          "ipv4": "string",
          "ipv6": "string",
          "name": "string",
          "regionID": 0,
          "stunonly": true,
          "stunport": 0,
          "stuntestIP": "string"
        }
      ],
      "regionCode": "string",
      "regionID": 0,
      "regionName": "string"
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
homeParams	tailcfg.DERPHomeParams	false		Homeparams if non-nil, is a change in home parameters.
The rest of the DEPRMap fields, if zero, means unchanged.
omitDefaultRegions	boolean	false		Omitdefaultregions specifies to not use Tailscale's DERP servers, and only use those specified in this DERPMap. If there are none set outside of the defaults, this is a noop.
This field is only meaningful if the Regions map is non-nil (indicating a change).
regions	object	false		Regions is the set of geographic regions running DERP node(s).
It's keyed by the DERPRegion.RegionID.
The numbers are not necessarily contiguous.
» [any property]	tailcfg.DERPRegion	false

tailcfg.DERPNode

{
  "canPort80": true,
  "certName": "string",
  "derpport": 0,
  "forceHTTP": true,
  "hostName": "string",
  "insecureForTests": true,
  "ipv4": "string",
  "ipv6": "string",
  "name": "string",
  "regionID": 0,
  "stunonly": true,
  "stunport": 0,
  "stuntestIP": "string"
}

Properties

Name	Type	Required	Restrictions	Description
canPort80	boolean	false		Canport80 specifies whether this DERP node is accessible over HTTP on port 80 specifically. This is used for captive portal checks.
certName	string	false		Certname optionally specifies the expected TLS cert common name. If empty, HostName is used. If CertName is non-empty, HostName is only used for the TCP dial (if IPv4/IPv6 are not present) + TLS ClientHello.
derpport	integer	false		Derpport optionally provides an alternate TLS port number for the DERP HTTPS server.
If zero, 443 is used.
forceHTTP	boolean	false		Forcehttp is used by unit tests to force HTTP. It should not be set by users.
hostName	string	false		Hostname is the DERP node's hostname.
It is required but need not be unique; multiple nodes may have the same HostName but vary in configuration otherwise.
insecureForTests	boolean	false		Insecurefortests is used by unit tests to disable TLS verification. It should not be set by users.
ipv4	string	false		Ipv4 optionally forces an IPv4 address to use, instead of using DNS. If empty, A record(s) from DNS lookups of HostName are used. If the string is not an IPv4 address, IPv4 is not used; the conventional string to disable IPv4 (and not use DNS) is "none".
ipv6	string	false		Ipv6 optionally forces an IPv6 address to use, instead of using DNS. If empty, AAAA record(s) from DNS lookups of HostName are used. If the string is not an IPv6 address, IPv6 is not used; the conventional string to disable IPv6 (and not use DNS) is "none".
name	string	false		Name is a unique node name (across all regions). It is not a host name. It's typically of the form "1b", "2a", "3b", etc. (region ID + suffix within that region)
regionID	integer	false		Regionid is the RegionID of the DERPRegion that this node is running in.
stunonly	boolean	false		Stunonly marks a node as only a STUN server and not a DERP server.
stunport	integer	false		Port optionally specifies a STUN port to use. Zero means 3478. To disable STUN on this node, use -1.
stuntestIP	string	false		Stuntestip is used in tests to override the STUN server's IP. If empty, it's assumed to be the same as the DERP server.

tailcfg.DERPRegion

{
  "avoid": true,
  "embeddedRelay": true,
  "nodes": [
    {
      "canPort80": true,
      "certName": "string",
      "derpport": 0,
      "forceHTTP": true,
      "hostName": "string",
      "insecureForTests": true,
      "ipv4": "string",
      "ipv6": "string",
      "name": "string",
      "regionID": 0,
      "stunonly": true,
      "stunport": 0,
      "stuntestIP": "string"
    }
  ],
  "regionCode": "string",
  "regionID": 0,
  "regionName": "string"
}

Properties

Name	Type	Required	Restrictions	Description
avoid	boolean	false		Avoid is whether the client should avoid picking this as its home region. The region should only be used if a peer is there. Clients already using this region as their home should migrate away to a new region without Avoid set.
embeddedRelay	boolean	false		Embeddedrelay is true when the region is bundled with the Coder control plane.
nodes	array of tailcfg.DERPNode	false		Nodes are the DERP nodes running in this region, in priority order for the current client. Client TLS connections should ideally only go to the first entry (falling back to the second if necessary). STUN packets should go to the first 1 or 2.
If nodes within a region route packets amongst themselves, but not to other regions. That said, each user/domain should get a the same preferred node order, so if all nodes for a user/network pick the first one (as they should, when things are healthy), the inter-cluster routing is minimal to zero.
regionCode	string	false		Regioncode is a short name for the region. It's usually a popular city or airport code in the region: "nyc", "sf", "sin", "fra", etc.
regionID	integer	false		Regionid is a unique integer for a geographic region.
It corresponds to the legacy derpN.tailscale.com hostnames used by older clients. (Older clients will continue to resolve derpN.tailscale.com when contacting peers, rather than use the server-provided DERPMap)
RegionIDs must be non-zero, positive, and guaranteed to fit in a JavaScript number.
RegionIDs in range 900-999 are reserved for end users to run their own DERP nodes.
regionName	string	false		Regionname is a long English name for the region: "New York City", "San Francisco", "Singapore", "Frankfurt", etc.

url.Userinfo

{}

Properties

None

uuid.NullUUID

{
  "uuid": "string",
  "valid": true
}

Properties

Name	Type	Required	Restrictions	Description
uuid	string	false
valid	boolean	false		Valid is true if UUID is not NULL

workspaceapps.AccessMethod

"path"

Properties

Enumerated Values

Value(s)
path, subdomain, terminal

workspaceapps.IssueTokenRequest

{
  "app_hostname": "string",
  "app_path": "string",
  "app_query": "string",
  "app_request": {
    "access_method": "path",
    "agent_name_or_id": "string",
    "app_prefix": "string",
    "app_slug_or_port": "string",
    "base_path": "string",
    "username_or_id": "string",
    "workspace_name_or_id": "string"
  },
  "path_app_base_url": "string",
  "session_token": "string"
}

Properties

Name	Type	Required	Restrictions	Description
app_hostname	string	false		App hostname is the optional hostname for subdomain apps on the external proxy. It must start with an asterisk.
app_path	string	false		App path is the path of the user underneath the app base path.
app_query	string	false		App query is the query parameters the user provided in the app request.
app_request	workspaceapps.Request	false
path_app_base_url	string	false		Path app base URL is required.
session_token	string	false		Session token is the session token provided by the user.

workspaceapps.Request

{
  "access_method": "path",
  "agent_name_or_id": "string",
  "app_prefix": "string",
  "app_slug_or_port": "string",
  "base_path": "string",
  "username_or_id": "string",
  "workspace_name_or_id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
access_method	workspaceapps.AccessMethod	false
agent_name_or_id	string	false		Agent name or ID is not required if the workspace has only one agent.
app_prefix	string	false		Prefix is the prefix of the subdomain app URL. Prefix should have a trailing "---" if set.
app_slug_or_port	string	false
base_path	string	false		Base path of the app. For path apps, this is the path prefix in the router for this particular app. For subdomain apps, this should be "/". This is used for setting the cookie path.
username_or_id	string	false		For the following fields, if the AccessMethod is AccessMethodTerminal, then only AgentNameOrID may be set and it must be a UUID. The other fields must be left blank.
workspace_name_or_id	string	false

workspaceapps.StatsReport

{
  "access_method": "path",
  "agent_id": "string",
  "requests": 0,
  "session_ended_at": "string",
  "session_id": "string",
  "session_started_at": "string",
  "slug_or_port": "string",
  "user_id": "string",
  "workspace_id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
access_method	workspaceapps.AccessMethod	false
agent_id	string	false
requests	integer	false
session_ended_at	string	false		Updated periodically while app is in use active and when the last connection is closed.
session_id	string	false
session_started_at	string	false
slug_or_port	string	false
user_id	string	false
workspace_id	string	false

workspacesdk.AgentConnectionInfo

{
  "derp_force_websockets": true,
  "derp_map": {
    "homeParams": {
      "regionScore": {
        "property1": 0,
        "property2": 0
      }
    },
    "omitDefaultRegions": true,
    "regions": {
      "property1": {
        "avoid": true,
        "embeddedRelay": true,
        "nodes": [
          {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          }
        ],
        "regionCode": "string",
        "regionID": 0,
        "regionName": "string"
      },
      "property2": {
        "avoid": true,
        "embeddedRelay": true,
        "nodes": [
          {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          }
        ],
        "regionCode": "string",
        "regionID": 0,
        "regionName": "string"
      }
    }
  },
  "disable_direct_connections": true,
  "hostname_suffix": "string"
}

Properties

Name	Type	Required	Restrictions	Description
derp_force_websockets	boolean	false
derp_map	tailcfg.DERPMap	false
disable_direct_connections	boolean	false
hostname_suffix	string	false

workspacesdk.AgentUpdate

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "lifecycle": "created"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	false
lifecycle	codersdk.WorkspaceAgentLifecycle	false

workspacesdk.BuildUpdate

{
  "job_status": "pending",
  "transition": "start"
}

Properties

Name	Type	Required	Restrictions	Description
job_status	codersdk.ProvisionerJobStatus	false
transition	codersdk.WorkspaceTransition	false

workspacesdk.ConnectionWatchEvent

{
  "agent_update": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "lifecycle": "created"
  },
  "build_update": {
    "job_status": "pending",
    "transition": "start"
  },
  "error": {
    "code": 0,
    "details": "string",
    "message": "string",
    "retryable": true
  }
}

Properties

Name	Type	Required	Restrictions	Description
agent_update	workspacesdk.AgentUpdate	false
build_update	workspacesdk.BuildUpdate	false
error	workspacesdk.WatchError	false

workspacesdk.WatchError

{
  "code": 0,
  "details": "string",
  "message": "string",
  "retryable": true
}

Properties

Name	Type	Required	Restrictions	Description
code	workspacesdk.WatchErrorCode	false
details	string	false
message	string	false
retryable	boolean	false

workspacesdk.WatchErrorCode

0

Properties

Enumerated Values

Value(s)
0, 1, 2, 3, 4, 5, 6

wsproxysdk.CryptoKeysResponse

{
  "crypto_keys": [
    {
      "deletes_at": "2019-08-24T14:15:22Z",
      "feature": "workspace_apps_api_key",
      "secret": "string",
      "sequence": 0,
      "starts_at": "2019-08-24T14:15:22Z"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
crypto_keys	array of codersdk.CryptoKey	false

wsproxysdk.DeregisterWorkspaceProxyRequest

{
  "replica_id": "string"
}

Properties

Name	Type	Required	Restrictions	Description
replica_id	string	false		Replica ID is a unique identifier for the replica of the proxy that is deregistering. It should be generated by the client on startup and should've already been passed to the register endpoint.

wsproxysdk.IssueSignedAppTokenResponse

{
  "signed_token_str": "string"
}

Properties

Name	Type	Required	Restrictions	Description
signed_token_str	string	false		Signed token str should be set as a cookie on the response.

wsproxysdk.RegisterWorkspaceProxyRequest

{
  "access_url": "string",
  "derp_enabled": true,
  "derp_only": true,
  "hostname": "string",
  "replica_error": "string",
  "replica_id": "string",
  "replica_relay_address": "string",
  "version": "string",
  "wildcard_hostname": "string"
}

Properties

Name	Type	Required	Restrictions	Description
access_url	string	false		Access URL that hits the workspace proxy api.
derp_enabled	boolean	false		Derp enabled indicates whether the proxy should be included in the DERP map or not.
derp_only	boolean	false		Derp only indicates whether the proxy should only be included in the DERP map and should not be used for serving apps.
hostname	string	false		Hostname is the OS hostname of the machine that the proxy is running on. This is only used for tracking purposes in the replicas table.
replica_error	string	false		Replica error is the error that the replica encountered when trying to dial it's peers. This is stored in the replicas table for debugging purposes but does not affect the proxy's ability to register.
This value is only stored on subsequent requests to the register endpoint, not the first request.
replica_id	string	false		Replica ID is a unique identifier for the replica of the proxy that is registering. It should be generated by the client on startup and persisted (in memory only) until the process is restarted.
replica_relay_address	string	false		Replica relay address is the DERP address of the replica that other replicas may use to connect internally for DERP meshing.
version	string	false		Version is the Coder version of the proxy.
wildcard_hostname	string	false		Wildcard hostname that the workspace proxy api is serving for subdomain apps.

wsproxysdk.RegisterWorkspaceProxyResponse

{
  "derp_force_websockets": true,
  "derp_map": {
    "homeParams": {
      "regionScore": {
        "property1": 0,
        "property2": 0
      }
    },
    "omitDefaultRegions": true,
    "regions": {
      "property1": {
        "avoid": true,
        "embeddedRelay": true,
        "nodes": [
          {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          }
        ],
        "regionCode": "string",
        "regionID": 0,
        "regionName": "string"
      },
      "property2": {
        "avoid": true,
        "embeddedRelay": true,
        "nodes": [
          {
            "canPort80": true,
            "certName": "string",
            "derpport": 0,
            "forceHTTP": true,
            "hostName": "string",
            "insecureForTests": true,
            "ipv4": "string",
            "ipv6": "string",
            "name": "string",
            "regionID": 0,
            "stunonly": true,
            "stunport": 0,
            "stuntestIP": "string"
          }
        ],
        "regionCode": "string",
        "regionID": 0,
        "regionName": "string"
      }
    }
  },
  "derp_mesh_key": "string",
  "derp_region_id": 0,
  "sibling_replicas": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "database_latency": 0,
      "error": "string",
      "hostname": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "region_id": 0,
      "relay_address": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
derp_force_websockets	boolean	false
derp_map	tailcfg.DERPMap	false
derp_mesh_key	string	false
derp_region_id	integer	false
sibling_replicas	array of codersdk.Replica	false		Sibling replicas is a list of all other replicas of the proxy that have not timed out.

wsproxysdk.ReportAppStatsRequest

{
  "stats": [
    {
      "access_method": "path",
      "agent_id": "string",
      "requests": 0,
      "session_ended_at": "string",
      "session_id": "string",
      "session_started_at": "string",
      "slug_or_port": "string",
      "user_id": "string",
      "workspace_id": "string"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
stats	array of workspaceapps.StatsReport	false