Create a new configuration, or a new version of a configuration.

PUT

https://app.mk.io/api/v1/projects/:project_name/templating/configs/:config_type/:name

PUT

/api/v1/projects/:project_name/templating/configs/:config_type/:name

curl -X PUT https://app.mk.io/api/v1/projects/project_name/templating/configs/config_type/name \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "spec": {
    "config": {}
  }
}'

{
  "metadata": {
    "id": "string",
    "type": "string",
    "created": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "createdByEmail": "string",
    "description": "",
    "hash": "string",
    "labels": {
      "label1": "value1",
      "label2": "value2"
    },
    "name": "string",
    "tags": [
      "string"
    ],
    "updated": "2024-01-15T09:30:00Z",
    "updatedBy": "string",
    "updatedByEmail": "string"
  },
  "kind": "string",
  "spec": {
    "config": {},
    "parameters": [
      {
        "name": "source_id_0",
        "paths": [
          "[\"/input/sources/0/id\"]"
        ],
        "description": "string"
      }
    ]
  },
  "status": {
    "inputPins": [
      {
        "name": "string",
        "allowMultipleBindings": true
      }
    ],
    "outputPins": [
      {
        "name": "string",
        "allowMultipleBindings": true
      }
    ]
  }
}

This will create a new Configuration object, or a new version of a Configuration if one with this name exists. Any tags set in this request will be removed from any other version of this Configuration.

RBAC Capability Required: templating.configs.create

Authentication

AuthorizationBearer

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

Path parameters

project_namestringRequired

config_typestringRequired

namestringRequired

Request

This endpoint expects an object.

specobjectRequired

Specification for the template

metadataobjectOptional

Metadata.

Response

Updated configuration

metadataobject

Metadata.

kindstringOptional

The kind of record.

specobjectOptional

Specification.

statusobjectOptional

Computed status including available input/output pin names.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error