Create a new MCP Portal

POST /accounts/{account_id}/access/ai-controls/mcp/portals

Responses

201 Returns the created Object

Data is at body["result"]

{
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "secure_web_gateway": "*boolean*"
}

400 Input Validation Error

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*",
      "path": [
        "*string*"
      ]
    }
  ],
  "success": "*boolean*"
}

List MCP Portals

GET /accounts/{account_id}/access/ai-controls/mcp/portals

Responses

200 List objects

Data is at body["result"]

[
  {
    "created_at": "*string*",
    "created_by": "*string*",
    "description": "*string*",
    "hostname": "*string*",
    "id": "*string*",
    "modified_at": "*string*",
    "modified_by": "*string*",
    "name": "*string*",
    "secure_web_gateway": "*boolean*"
  }
]

400 Bad Request

{
  "errors": [
    {
      "message": "*string*"
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Update a MCP Portal

PUT /accounts/{account_id}/access/ai-controls/mcp/portals/{id}

Responses

200 Returns the updated Object

Data is at body["result"]

{
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "secure_web_gateway": "*boolean*"
}

400 Input Validation Error

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*",
      "path": [
        "*string*"
      ]
    }
  ],
  "success": "*boolean*"
}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}

Read details of an MCP Portal

GET /accounts/{account_id}/access/ai-controls/mcp/portals/{id}

Responses

200 Returns a single object if found

Data is at body["result"]

{
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "secure_web_gateway": "*boolean*",
  "servers": [
    {
      "auth_type": "*string*",
      "created_at": "*string*",
      "created_by": "*string*",
      "default_disabled": "*boolean*",
      "description": "*string*",
      "error": "*string*",
      "hostname": "*string*",
      "id": "*string*",
      "last_successful_sync": "*string*",
      "last_synced": "*string*",
      "modified_at": "*string*",
      "modified_by": "*string*",
      "name": "*string*",
      "on_behalf": "*boolean*",
      "prompts": [
        {}
      ],
      "status": "*string*",
      "tools": [
        {}
      ],
      "updated_prompts": [
        {}
      ],
      "updated_tools": [
        {}
      ]
    }
  ]
}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}

Delete a MCP Portal

DELETE /accounts/{account_id}/access/ai-controls/mcp/portals/{id}

Responses

200 Returns the Object if it was successfully deleted

Data is at body["result"]

{
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "secure_web_gateway": "*boolean*"
}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}