---
title: "Create Egress Exit"
method: POST
path: "/v1/workspaces/{workspace}/egress-exits/"
tags: ["v1", "protected", "egress-exits"]
---

# Create Egress Exit

`POST /v1/workspaces/{workspace}/egress-exits/`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/agentarea/apis/agentarea-api/docs/v1/workspaces/:workspace/egress-exits/post.ts> (a function with typed inputs; its response is checked against the schema)

Define a proxy the workspace's MCP instances may leave through.

## Path parameters

- `workspace` string, required: Slug of the workspace the request acts in

## Request body

- EgressExitCreate: A proxy of the workspace's own that its MCP instances may leave through.
  - `allow_plaintext_credentials` boolean: Send the credentials to an http or socks5 proxy, where they are unencrypted.
  - `description` string, nullable: What this exit is for.
  - `name` string, required: Name, unique in the workspace.
  - `password_secret_id` string, uuid, nullable: The proxy password as a workspace secret (id from the secrets catalog). It is read when an instance starts; changing the secret's value takes effect at the instance's next start.
  - `upstream_url` string, required: The proxy as scheme://host:port: http, https or socks5, no credentials.
  - `username` string, nullable: Proxy username, if it needs one.

## Response `201`

Successful Response

- EgressExitResponse
  - `allow_plaintext_credentials` boolean, required
  - `created_at` string, date-time, required
  - `created_by` string, required
  - `description` string, nullable, required
  - `id` string, uuid, required
  - `managed_by` string, nullable, required: "platform" for an exit the operator manages; null for the workspace's own.
  - `name` string, required
  - `password_secret_id` string, uuid, nullable, required
  - `updated_at` string, date-time, required
  - `upstream_url` string, nullable, required
  - `username` string, nullable, required
  - `via` string, nullable, required: The platform hop this exit leaves through, if any.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-31** `08ae67128045`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/egress-exits/post.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) - [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/7a4e10cf159f?raw)