Render

Definition rendering to markdown

2 endpoints

Render a definition

Get the rendered markdown for a definition. Requires `name@version` syntax.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name with version (name@version format)

renderProfilestringquery

Controls which UluOps-specific sections appear in rendered agent prompts. Only applies to agent definitions; ignored for command/workflow.

coreuluops-full

Default: core

targetstringquery

Target harness format (e.g., opencode, codex, gemini). Wraps output in a target-specific envelope.

modelstringquery

Model override for target envelope generation.

Responses

200Rendered markdown

404Resource not found

Response fields

dataobject

GET/api/v1/definitions/{type}/{name}/render

curl -X GET "https://api.uluops.ai/api/v1/definitions/agent/my-project/render"

Response

{
  "data": {
    "markdown": "...",
    "promptHash": "...",
    "normalizedYaml": "..."
  }
}

Preview render from YAML

Render a definition from raw YAML without storing it. Useful for previewing content before creating a definition.

Requires authentication

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

Request Body

yamlrequiredstring

YAML content to render

sourcePathstring

Optional source file path for error reporting

renderProfilestring

Controls which UluOps-specific sections appear in rendered agent prompts. Only applies to agent definitions; ignored for command/workflow.

coreuluops-full

Default: core

Responses

200Rendered preview

400Invalid request parameters

422Request could not be processed (e.g., invalid YAML)

Response fields

dataobject

POST/api/v1/render/{type}/preview

curl -X POST "https://api.uluops.ai/api/v1/render/agent/preview" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "yaml": "name: example-agent\nversion: 1.0.0"
  }'

Response

{
  "data": {
    "markdown": "...",
    "promptHash": "...",
    "normalizedYaml": "..."
  }
}