PortSharing
Get workspace agent port shares
Code samples
# Example request using curl
curl -X DELETE http://coder-server:8080/api/v2/workspaces/{workspace}/port-share \
-H 'Content-Type: application/json' \
-H 'Coder-Session-Token: API_KEY'
DELETE /workspaces/{workspace}/port-share
Body parameter
{
"agent_name": "string",
"port": 0
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
workspace | path | string(uuid) | true | Workspace ID |
body | body | codersdk.DeleteWorkspaceAgentPortShareRequest | true | Delete port sharing level request |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK |
To perform this operation, you must be authenticated. Learn more.
Upsert workspace agent port share
Code samples
# Example request using curl
curl -X POST http://coder-server:8080/api/v2/workspaces/{workspace}/port-share \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Coder-Session-Token: API_KEY'
POST /workspaces/{workspace}/port-share
Body parameter
{
"agent_name": "string",
"port": 0,
"protocol": "http",
"share_level": "owner"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
workspace | path | string(uuid) | true | Workspace ID |
body | body | codersdk.UpsertWorkspaceAgentPortShareRequest | true | Upsert port sharing level request |
Example responses
200 Response
{
"agent_name": "string",
"port": 0,
"protocol": "http",
"share_level": "owner",
"workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK | codersdk.WorkspaceAgentPortShare |
To perform this operation, you must be authenticated. Learn more.