# Example request using curl curl -X GET http://coder-server:8080/api/v2/derp-map \ -H 'Coder-Session-Token: API_KEY'
GET /derp-map
To perform this operation, you must be authenticated. Learn more.
User-scoped tailnet RPC connection Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/tailnet \ -H 'Coder-Session-Token: API_KEY'
GET /tailnet
To perform this operation, you must be authenticated. Learn more.
Authenticate agent on AWS instance Code samples# Example request using curl curl -X POST http://coder-server:8080/api/v2/workspaceagents/aws-instance-identity \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
POST /workspaceagents/aws-instance-identity
Body parameter
{ "document": "string", "signature": "string" }
200 Response
{ "session_token": "string" }
To perform this operation, you must be authenticated. Learn more.
Authenticate agent on Azure instance Code samples# Example request using curl curl -X POST http://coder-server:8080/api/v2/workspaceagents/azure-instance-identity \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
POST /workspaceagents/azure-instance-identity
Body parameter
{ "encoding": "string", "signature": "string" }
200 Response
{ "session_token": "string" }
To perform this operation, you must be authenticated. Learn more.
Authenticate agent on Google Cloud instance Code samples# Example request using curl curl -X POST http://coder-server:8080/api/v2/workspaceagents/google-instance-identity \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
POST /workspaceagents/google-instance-identity
Body parameter
{ "json_web_token": "string" }
200 Response
{ "session_token": "string" }
To perform this operation, you must be authenticated. Learn more.
Patch workspace agent app status Code samples# Example request using curl curl -X PATCH http://coder-server:8080/api/v2/workspaceagents/me/app-status \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
PATCH /workspaceagents/me/app-status
Body parameter
{ "app_slug": "string", "icon": "string", "message": "string", "needs_user_attention": true, "state": "working", "uri": "string" }
200 Response
{ "detail": "string", "message": "string", "validations": [ { "detail": "string", "field": "string" } ] }
To perform this operation, you must be authenticated. Learn more.
Get workspace agent external auth Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/me/external-auth?match=string&id=string \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/me/external-auth
match
query string true Match id
query string true Provider ID listen
query boolean false Wait for a new token to be issued Example responses
200 Response
{ "access_token": "string", "password": "string", "token_extra": {}, "type": "string", "url": "string", "username": "string" }
To perform this operation, you must be authenticated. Learn more.
Removed: Get workspace agent git auth Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/me/gitauth?match=string&id=string \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/me/gitauth
match
query string true Match id
query string true Provider ID listen
query boolean false Wait for a new token to be issued Example responses
200 Response
{ "access_token": "string", "password": "string", "token_extra": {}, "type": "string", "url": "string", "username": "string" }
To perform this operation, you must be authenticated. Learn more.
Get workspace agent Git SSH key Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/me/gitsshkey \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/me/gitsshkey
200 Response
{ "private_key": "string", "public_key": "string" }
To perform this operation, you must be authenticated. Learn more.
Post workspace agent log source Code samples# Example request using curl curl -X POST http://coder-server:8080/api/v2/workspaceagents/me/log-source \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
POST /workspaceagents/me/log-source
Body parameter
{ "display_name": "string", "icon": "string", "id": "string" }
200 Response
{ "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" }
To perform this operation, you must be authenticated. Learn more.
Patch workspace agent logs Code samples# Example request using curl curl -X PATCH http://coder-server:8080/api/v2/workspaceagents/me/logs \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
PATCH /workspaceagents/me/logs
Body parameter
{ "log_source_id": "string", "logs": [ { "created_at": "string", "level": "trace", "output": "string" } ] }
200 Response
{ "detail": "string", "message": "string", "validations": [ { "detail": "string", "field": "string" } ] }
To perform this operation, you must be authenticated. Learn more.
Get workspace agent reinitialization Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/me/reinit \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/me/reinit
200 Response
{ "reason": "prebuild_claimed", "workspaceID": "string" }
To perform this operation, you must be authenticated. Learn more.
Get workspace agent by ID Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent} \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}
workspaceagent
path string(uuid) true Workspace agent ID Example responses
200 Response
{ "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", "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", "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, "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" }
To perform this operation, you must be authenticated. Learn more.
Get connection info for workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/connection \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/connection
workspaceagent
path string(uuid) true Workspace agent ID Example responses
200 Response
{ "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" }
To perform this operation, you must be authenticated. Learn more.
Get running containers for workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/containers?label=string \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/containers
workspaceagent
path string(uuid) true Workspace agent ID label
query string(key=value) true Labels Example responses
200 Response
{ "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", "workspace_folder": "string" } ], "warnings": [ "string" ] }
To perform this operation, you must be authenticated. Learn more.
Recreate devcontainer for workspace agent Code samples# Example request using curl curl -X POST http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/containers/devcontainers/{devcontainer}/recreate \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
POST /workspaceagents/{workspaceagent}/containers/devcontainers/{devcontainer}/recreate
workspaceagent
path string(uuid) true Workspace agent ID devcontainer
path string true Devcontainer ID Example responses
202 Response
{ "detail": "string", "message": "string", "validations": [ { "detail": "string", "field": "string" } ] }
To perform this operation, you must be authenticated. Learn more.
Watch workspace agent for container updates Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/containers/watch \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/containers/watch
workspaceagent
path string(uuid) true Workspace agent ID Example responses
200 Response
{ "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", "workspace_folder": "string" } ], "warnings": [ "string" ] }
To perform this operation, you must be authenticated. Learn more.
Coordinate workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/coordinate \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/coordinate
workspaceagent
path string(uuid) true Workspace agent ID Responses
To perform this operation, you must be authenticated. Learn more.
Get listening ports for workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/listening-ports \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/listening-ports
workspaceagent
path string(uuid) true Workspace agent ID Example responses
200 Response
{ "ports": [ { "network": "string", "port": 0, "process_name": "string" } ] }
To perform this operation, you must be authenticated. Learn more.
Get logs by workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/logs \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/logs
workspaceagent
path string(uuid) true Workspace agent ID before
query integer false Before log id after
query integer false After log id follow
query boolean false Follow log stream no_compression
query boolean false Disable compression for WebSocket connection Example responses
200 Response
[ { "created_at": "2019-08-24T14:15:22Z", "id": 0, "level": "trace", "output": "string", "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81" } ]
Status Code 200
Name Type Required Restrictions Description[array item]
array false » created_at
string(date-time) false » id
integer false » level
codersdk.LogLevel false » output
string false » source_id
string(uuid) false Enumerated Values Property Value level
trace
level
debug
level
info
level
warn
level
error
To perform this operation, you must be authenticated. Learn more.
Open PTY to workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/pty \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/pty
workspaceagent
path string(uuid) true Workspace agent ID Responses
To perform this operation, you must be authenticated. Learn more.
Removed: Get logs by workspace agent Code samples# Example request using curl curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/startup-logs \ -H 'Accept: application/json' \ -H 'Coder-Session-Token: API_KEY'
GET /workspaceagents/{workspaceagent}/startup-logs
workspaceagent
path string(uuid) true Workspace agent ID before
query integer false Before log id after
query integer false After log id follow
query boolean false Follow log stream no_compression
query boolean false Disable compression for WebSocket connection Example responses
200 Response
[ { "created_at": "2019-08-24T14:15:22Z", "id": 0, "level": "trace", "output": "string", "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81" } ]
Status Code 200
Name Type Required Restrictions Description[array item]
array false » created_at
string(date-time) false » id
integer false » level
codersdk.LogLevel false » output
string false » source_id
string(uuid) false Enumerated Values Property Value level
trace
level
debug
level
info
level
warn
level
error
To perform this operation, you must be authenticated. Learn more.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4