​

ves-io-schema-endpoint-API-List

Published April 5, 2023 | Last modified September 19, 2025

Examples of listing endpoint

Usecase:

List all endpoints in the current namespace

Request using vesctl:

vesctl configuration list endpoint --namespace documentation

vesctl yaml response:

errors: []
items:
- annotations: {}
  labels: {}
  name: details-endpoint
  namespace: documentation
  statusSet: []
  tenant: acmecorp
  uid: d199f476-15c5-420f-ab5c-98244c211231
- annotations: {}
  labels: {}
  name: productpage-endpoint
  namespace: documentation
  statusSet: []
  tenant: acmecorp
  uid: 01729d0c-9534-4a29-94ce-8f81a8e20a5d
- annotations: {}
  labels: {}
  name: ratings-endpoint
  namespace: documentation
  statusSet: []
  tenant: acmecorp
  uid: d25e0b80-c9e8-4048-90d5-56faf3b1e45f
- annotations: {}
  labels: {}
  name: reviews-endpoint
  namespace: documentation
  statusSet: []
  tenant: acmecorp
  uid: 04585a4b-ed5b-45c6-9b0d-2c3d4ea934ec
Copied!

Request using curl:

curl -X 'GET' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build2850427035_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/config/namespaces/documentation/endpoints'
Copied!

curl response

HTTP/1.1 200 OK
Content-Type: application/json
Date: Fri, 19 Sep 2025 02:00:04 GMT
Vary: Accept-Encoding

{
  "items": [
    {
      "tenant": "acmecorp",
      "namespace": "documentation",
      "name": "details-endpoint",
      "uid": "d199f476-15c5-420f-ab5c-98244c211231",
      "description": "",
      "disabled": false,
      "labels": {
      },
      "annotations": {
      },
      "owner_view": null,
      "metadata": null,
      "system_metadata": null,
      "get_spec": null,
      "status_set": [
      ]
    },
    {
      "tenant": "acmecorp",
      "namespace": "documentation",
      "name": "productpage-endpoint",
      "uid": "01729d0c-9534-4a29-94ce-8f81a8e20a5d",
      "description": "",
      "disabled": false,
      "labels": {
      },
      "annotations": {
      },
      "owner_view": null,
      "metadata": null,
      "system_metadata": null,
      "get_spec": null,
      "status_set": [
      ]
    },
    {
      "tenant": "acmecorp",
      "namespace": "documentation",
      "name": "ratings-endpoint",
      "uid": "d25e0b80-c9e8-4048-90d5-56faf3b1e45f",
      "description": "",
      "disabled": false,
      "labels": {
      },
      "annotations": {
      },
      "owner_view": null,
      "metadata": null,
      "system_metadata": null,
      "get_spec": null,
      "status_set": [
      ]
    },
    {
      "tenant": "acmecorp",
      "namespace": "documentation",
      "name": "reviews-endpoint",
      "uid": "04585a4b-ed5b-45c6-9b0d-2c3d4ea934ec",
      "description": "",
      "disabled": false,
      "labels": {
      },
      "annotations": {
      },
      "owner_view": null,
      "metadata": null,
      "system_metadata": null,
      "get_spec": null,
      "status_set": [
      ]
    }
  ],
  "errors": [
  ]
}
Copied!
On this page: