Mcp Deployment API

List MCP deployments in the environment

Path	Method	Protected
`/v1/envs/{environment_id}/mcp-deployments`	GET	Yes

Example Response JSON


{
  "values": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "revision": 0,
      "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
      "domain": "string",
      "hash": "string",
      "agents": {
        "property1": {
          "securityScheme": "string"
        },
        "property2": {
          "securityScheme": "string"
        }
      },
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ]
}

Create a new MCP deployment in the environment

Path	Method	Protected
`/v1/envs/{environment_id}/mcp-deployments`	POST	Yes

Example Request JSON


{
  "domain": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  }
}

Example Response JSON


{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "revision": 0,
  "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
  "domain": "string",
  "hash": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

Get MCP deployment by domain in the environment

Path	Method	Protected
`/v1/envs/{environment_id}/mcp-deployments/{domain}`	GET	Yes

Example Response JSON


{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "revision": 0,
  "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
  "domain": "string",
  "hash": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

Get MCP deployment by ID

Path	Method	Protected
`/v1/mcp-deployments/{mcp_deployment_id}`	GET	Yes

Example Response JSON


{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "revision": 0,
  "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
  "domain": "string",
  "hash": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

Delete MCP deployment

Path	Method	Protected
`/v1/mcp-deployments/{mcp_deployment_id}`	DELETE	Yes

Query Parameters

Name	Type	Required	Description
current_revision	integer	Yes	-

Update MCP deployment

Path	Method	Protected
`/v1/mcp-deployments/{mcp_deployment_id}`	PATCH	Yes

Example Request JSON


{
  "currentRevision": 0,
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  }
}

Example Response JSON


{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "revision": 0,
  "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
  "domain": "string",
  "hash": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

Get a specific MCP deployment revision

Path	Method	Protected
`/v1/mcp-deployment/{mcp_deployment_id}/revisions/{revision}`	GET	Yes

Example Response JSON


{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "revision": 0,
  "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
  "domain": "string",
  "hash": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

Get MCP deployment by domain in the deployment

Path	Method	Protected
`/v1/envs/{environment_id}/deployments/{deployment_revision}/mcp-deployments/{domain}`	GET	Yes

Example Response JSON


{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "revision": 0,
  "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
  "domain": "string",
  "hash": "string",
  "agents": {
    "property1": {
      "securityScheme": "string"
    },
    "property2": {
      "securityScheme": "string"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

List MCP deployments by domain in the deployment

Path	Method	Protected
`/v1/envs/{environment_id}/deployments/{deployment_revision}/mcp-deployments`	GET	Yes

Example Response JSON


{
  "values": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "revision": 0,
      "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
      "domain": "string",
      "hash": "string",
      "agents": {
        "property1": {
          "securityScheme": "string"
        },
        "property2": {
          "securityScheme": "string"
        }
      },
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ]
}

Mcp Deployment API Errors

Status Code	Description	Body
400	Invalid request, returning with a list of issues detected in the request	`{"code":"string","errors":["string"]}`
401	Unauthorized request	`{"code":"string","error":"string"}`
403	Forbidden Request	`{"code":"string","error":"string"}`
404	Entity not found	`{"code":"string","error":"string"}`
409		`{"code":"string","error":"string"}`
422	Limits of the plan exceeded	`{"code":"string","error":"string"}`
500	Internal server error	`{"code":"string","error":"string"}`