​

ves-io-schema-known_label-CustomAPI-Create

Published April 5, 2023 | Last modified November 14, 2025

Examples of performing known_label CustomAPI Create

Usecase:

Create known_label acmecorp/storetype=superstore

Request:

Request using vesctl:

vesctl request rpc known_label.CustomAPI.Create -i request.yaml --uri /public/namespaces/shared/known_label/create --http-method POST

where file request.yaml has following contents:

description: acmecorp site type is superstore
key: acmecorp/storetype
namespace: shared
value: superstore
Copied!

vesctl yaml response:

label:
  description: acmecorp site type is superstore
  key: acmecorp/storetype
  value: superstore
Copied!

Request using curl:

curl -X 'POST' -d '{"namespace":"shared","key":"acmecorp/storetype","value":"superstore","description":"acmecorp site type is superstore"}' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build4194363419_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/config/namespaces/shared/known_label/create'
Copied!

curl response:

HTTP/1.1 200 OK
Content-Length: 134
Content-Type: application/json
Date: Thu, 13 Nov 2025 23:06:23 GMT
Vary: Accept-Encoding

{
  "label": {
    "key": "acmecorp/storetype",
    "value": "superstore",
    "description": "acmecorp site type is superstore"
  }
}
Copied!
On this page: