Declare product stack | Runtype Documentation

curl -X PUT https://api.runtype.com/v1/products/id/stack/declared \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    {
      "key": "string",
      "label": "string"
    }
  ],
  "source": "mcp"
}'

{
  "declaration": {
    "actorLabel": "string",
    "declaredAt": "string",
    "items": [
      {
        "key": "string",
        "label": "string",
        "category": "string",
        "mark": "string",
        "url": "string",
        "version": "string",
        "where": "string"
      }
    ],
    "actorUserId": "string"
  },
  "productId": "string",
  "source": "mcp",
  "stack": {
    "declared": {
      "api": {
        "actorLabel": "string",
        "declaredAt": "string",
        "items": [
          {
            "key": "string",
            "label": "string",
            "category": "string",
            "mark": "string",
            "url": "string",
            "version": "string",
            "where": "string"
          }
        ],
        "actorUserId": "string"
      },
      "cli": {
        "actorLabel": "string",
        "declaredAt": "string",
        "items": [
          {
            "key": "string",
            "label": "string",
            "category": "string",
            "mark": "string",
            "url": "string",
            "version": "string",
            "where": "string"
          }
        ],
        "actorUserId": "string"
      },
      "mcp": {
        "actorLabel": "string",
        "declaredAt": "string",
        "items": [
          {
            "key": "string",
            "label": "string",
            "category": "string",
            "mark": "string",
            "url": "string",
            "version": "string",
            "where": "string"
          }
        ],
        "actorUserId": "string"
      }
    },
    "detected": {
      "derivedAt": "string",
      "items": [
        {
          "key": "string",
          "label": "string",
          "category": "string",
          "mark": "string",
          "url": "string",
          "version": "string",
          "where": "string"
        }
      ]
    },
    "hidden": [
      "string"
    ],
    "hiddenAt": {},
    "manual": [
      {
        "key": "string",
        "label": "string",
        "category": "string",
        "mark": "string",
        "url": "string",
        "version": "string",
        "where": "string"
      }
    ]
  }
}

Replace what one source declares the product is built on (frameworks, vector databases, upstream services, versions). The Overview shows declared items beside the ones detected from the product’s own configuration. The actor is the caller’s credential: a named API key reads as its name, anyone else by first name.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.

itemslist of objectsRequired

Everything this source says the product is built on. Replaces the previous declaration from the same source whole; an empty list clears it. Keys follow the detected ones (model:<id>, data:<engine>, runtime:<name>, integration:<id>) so a declared item and a detected one show once, else custom:<slug>.

sourceenumRequired

Where the declaration comes from: the Runtype MCP server, the CLI, or the API

Allowed values:

Response

Declaration stored

declarationobject

productIdstring

sourceenum

Allowed values:

stackobject

The Overview's stack. The legacy techStack buckets are separate and unchanged.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error