Create a sandbox environment

Create a sandbox environment

cURL

curl --request POST \
  --url https://agentgateway.atlan.engineering/agent/v1/environments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "workspace_id": "<string>"
}
'

201

{
  "artifact_status": "<string>",
  "commit_ts": "<string>",
  "content_hash_hex": "<string>",
  "created_at": "<string>",
  "created_by": "<string>",
  "extension": "<string>",
  "id": "<string>",
  "is_latest": true,
  "kind": "<string>",
  "name": "<string>",
  "source_type": "<string>",
  "updated_at": "<string>",
  "updated_by": "<string>",
  "version_ordinal": 123,
  "workspace_id": "<string>",
  "environment_type": "cloud",
  "network_mode": "unrestricted",
  "display_name": "<string>",
  "identity": {
    "client_id": "<string>",
    "credential_kind": "<string>",
    "api_key": "<string>",
    "expires_at": "<string>"
  },
  "oidc_client_id": "<string>",
  "owner_id": "<string>",
  "project_id": "<string>",
  "repo_id": "<string>",
  "source_created_at": "<string>",
  "source_created_by": "<string>",
  "source_digest": "<string>",
  "source_id": "<string>",
  "source_last_modified_at": "<string>",
  "source_last_modified_by": "<string>",
  "source_metadata": "<unknown>",
  "source_synced_at": "<string>",
  "source_uri": "<string>",
  "source_version": "<string>",
  "version_label": "<string>",
  "agent_provider_id": "<string>",
  "allow_mcp_servers": true,
  "allow_package_managers": true,
  "allowed_hosts": [
    "<string>"
  ],
  "is_system": true,
  "packages": {
    "apt": [
      "<string>"
    ],
    "cargo": [
      "<string>"
    ],
    "gem": [
      "<string>"
    ],
    "go": [
      "<string>"
    ],
    "npm": [
      "<string>"
    ],
    "pip": [
      "<string>"
    ]
  },
  "permissions": {},
  "relationships": {
    "count": 1,
    "incoming": [
      {
        "direction": "<string>",
        "provenance": "<string>",
        "rel_type": "<string>",
        "relationship_status": "<string>",
        "attributes": {},
        "confidence": 123,
        "from": {
          "id": "<string>",
          "kind": "<string>"
        },
        "label": "<string>",
        "role": "<string>",
        "to": {
          "id": "<string>",
          "kind": "<string>"
        },
        "weight": 123
      }
    ],
    "outgoing": [
      {
        "direction": "<string>",
        "provenance": "<string>",
        "rel_type": "<string>",
        "relationship_status": "<string>",
        "attributes": {},
        "confidence": 123,
        "from": {
          "id": "<string>",
          "kind": "<string>"
        },
        "label": "<string>",
        "role": "<string>",
        "to": {
          "id": "<string>",
          "kind": "<string>"
        },
        "weight": 123
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

workspace_id · string · required

environment_type · enum<string> · required

Available options: cloud, self_hosted

network_mode · enum<string> · required

Available options: unrestricted, limited

source_created_at · string | null

source_created_by · string | null

source_id · string | null

source_last_modified_at · string | null

source_last_modified_by · string | null

source_metadata · any

source_synced_at · string | null

source_type · string | null

source_uri · string | null

source_version · string | null

display_name · string | null

owner_id · string | null

project_id · string | null

repo_id · string | null

agent_provider_id · string | null

allow_mcp_servers · boolean | null

allow_package_managers · boolean | null

allowed_hosts · string[]

packages · object

Show child attributes

Response

201

application/json

HTTP 201 response.

artifact_status · string · required

commit_ts · string · required

content_hash_hex · string · required

created_at · string · required

created_by · string · required

extension · string · required

id · string · required

is_latest · boolean · required

kind · string · required

name · string · required

source_type · string · required

updated_at · string · required

updated_by · string · required

version_ordinal · integer<int64> · required

workspace_id · string · required

environment_type · enum<string> · required

Available options: cloud, self_hosted

network_mode · enum<string> · required

Available options: unrestricted, limited

display_name · string

identity · null | object

Show child attributes

oidc_client_id · string | null

owner_id · string | null

project_id · string | null

repo_id · string | null

source_created_at · string | null

source_created_by · string | null

source_digest · string | null

source_id · string | null

source_last_modified_at · string | null

source_last_modified_by · string | null

source_metadata · any

source_synced_at · string | null

source_uri · string | null

source_version · string | null

version_label · string | null

agent_provider_id · string | null

allow_mcp_servers · boolean

allow_package_managers · boolean

allowed_hosts · string[]

is_system · boolean

packages · object

Show child attributes

permissions · null | object

Show child attributes

relationships · null | object

Show child attributes