Skip to content
HALOWERK

Denkwerk

agent card generate

Builds an Agent2Agent protocol Agent Card with protocolVersion, name, description, url, version, capabilities, default input/output modes and skills. Skills come from the supplied list or are derived from OpenAPI operations (operationId, summary, tags). Missing required fields are reported as errors instead of being invented. Output is ready to serve at /.well-known/agent-card.json.

POST https://denk.halowerk.com/v1/agent-card-generate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
namestringYes
descriptionstringYes
urlstringYes
versionstringNo
protocol_versionstringNo
providerobjectNo
documentation_urlstringNo
streamingbooleanNo
skillsarrayNo
openapiobjectNoOptional OpenAPI document to derive skills from.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "name",
    "description",
    "url"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "minLength": 10,
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "version": {
      "type": "string",
      "default": "1.0.0"
    },
    "protocol_version": {
      "type": "string",
      "default": "0.3.0"
    },
    "provider": {
      "type": "object",
      "properties": {
        "organization": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "organization",
        "url"
      ]
    },
    "documentation_url": {
      "type": "string",
      "format": "uri"
    },
    "streaming": {
      "type": "boolean",
      "default": false
    },
    "skills": {
      "type": "array",
      "maxItems": 200,
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "description"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "examples": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "openapi": {
      "type": "object",
      "description": "Optional OpenAPI document to derive skills from."
    }
  }
}

Open original schema

Published input example

{
  "name": "Invoice Agent",
  "description": "Creates and checks German e-invoices.",
  "url": "https://agent.halowerk.com",
  "skills": [
    {
      "id": "xrechnung",
      "name": "Create XRechnung",
      "description": "Builds an XRechnung from order data.",
      "tags": [
        "invoice"
      ]
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’