Compozy Symbol
ALPHA
DocsInstallGetting StartedFeaturesPricing
CoreCLI ReferenceSchema DefinitionAPI Reference
Attachments

Overview

Attach images, audio, video, PDFs, files, and URLs to tasks/agents/actions with security-first resolution and multimodal LLM integration

What Are Attachments?

Attachments provide a unified way to include external content (files and URLs) in Compozy workflows. They work across task, agent, and action scopes and are converted into multimodal parts for LLM calls when supported.

Key Capabilities

Unified Model

Single, consistent schema for images, audio, video, PDFs, files, and URL references

Templating Aware

Supports template expressions with staged normalization to safely resolve .tasks.* values

Multimodal Ready

Maps resolved content to LLM parts (image URLs, text, or binary) for vision and audio/video models

Security-First

SSRF protection, MIME allow-lists, CWD-bound file access, and bounded downloads

Hierarchical Scopes

Declare attachments at task, agent, or action level with deterministic merge and de-dup

Configurable Limits

Control size, timeouts, redirects, extraction limits, and detection depth via app config

Where Attachments Apply

  • 1
    Tasks

    Add inputs for basic/router/collection flows; available to nested agent actions

  • 2
    Agents

    Provide shared context (e.g., brand assets, guidelines) for all actions

  • 3
    Actions

    Attach operation-specific inputs (e.g., the document under review)

Tasks
Attach inputs to basic/router tasks and more
Agents
How attachments fit into agent actions and prompts
YAML Templates
Use context variables and expressions in attachment fields
Global Configuration
Tune download limits, MIME allow-lists, and security policies

Event API

The Event API provides programmatic access to Compozy's signal system, enabling external applications, services, and integrations to participate in event-driven workflows. This RESTful API is essential for building complex integrations, webhook handlers, and distributed system coordination with Compozy workflows.

Types & Sources

Supported attachment kinds, source fields, mutual exclusivity rules, and metadata