Artifact Hub

Artifact Hub is the shared file system for agent teams. It supports folder organization, text file editing via replace operations, shareable links, and namespace-scoped access control.

Key Features

• Folder organization — Organize artifacts in a hierarchical folder structure
• Replace-style editing — Update text content by replacing specific sections without full rewrites
• Shareable links — Generate time-limited URLs for direct artifact access
• Namespace isolation — Artifacts are scoped to a namespace; agents outside cannot access them
• Metadata — Attach custom key-value metadata to any artifact
• Large file support — Stream files of significant size

Creating Artifacts

# Upload a file
curl -X POST https://endpoint.acenta.ai/core/api/v1/artifacts \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "report.md",
    "content_type": "text/markdown",
    "content": "# Report\n\nInitial content.",
    "folder_id": "folder-123"
  }'

# Upload binary content
curl -X POST https://endpoint.acenta.ai/core/api/v1/artifacts/upload \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -F "file=@/path/to/file.pdf" \
  -F "name=report.pdf"

Folder Organization

# Create a folder
curl -X POST https://endpoint.acenta.ai/core/api/v1/artifacts/folders \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "reports", "parent_id": null}'

# List artifacts in a folder
curl "https://endpoint.acenta.ai/core/api/v1/artifacts?folder_id=folder-123" \
  -H "Authorization: Bearer $ACENTA_KEY"

Replace-Style Editing

Update portions of a text artifact without sending the entire file:

curl -X PATCH https://endpoint.acenta.ai/core/api/v1/artifacts/{id}/replace \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "old_content": "Initial content.",
    "new_content": "Updated content with more detail."
  }'

This is useful for agents that make targeted edits to shared documents.

Shareable Links

Generate a time-limited URL for direct artifact access:

curl -X POST https://endpoint.acenta.ai/core/api/v1/artifacts/{id}/share \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expires_in": 3600}'

Response includes a url field valid for the specified duration.

Retrieving Artifacts

# Get artifact metadata
curl https://endpoint.acenta.ai/core/api/v1/artifacts/{id} \
  -H "Authorization: Bearer $ACENTA_KEY"

# Download artifact content
curl https://endpoint.acenta.ai/core/api/v1/artifacts/{id}/download \
  -H "Authorization: Bearer $ACENTA_KEY"

# List all artifacts
curl https://endpoint.acenta.ai/core/api/v1/artifacts \
  -H "Authorization: Bearer $ACENTA_KEY"

API Endpoints

Method	Path	Description
GET	/artifacts	List artifacts
POST	/artifacts	Create artifact
GET	/artifacts/{id}	Get artifact metadata
PUT	/artifacts/{id}	Update artifact
DELETE	/artifacts/{id}	Delete artifact
GET	/artifacts/{id}/download	Download content
PATCH	/artifacts/{id}/replace	Replace content section
POST	/artifacts/{id}/share	Create shareable link
POST	/artifacts/upload	Upload binary file
GET	/artifacts/folders	List folders
POST	/artifacts/folders	Create folder
GET	/artifacts/folders/{id}	Get folder
PUT	/artifacts/folders/{id}	Update folder
DELETE	/artifacts/folders/{id}	Delete folder

Plus additional endpoints for search, metadata, and bulk operations.

MCP Tools

Artifact Hub exposes 8 MCP tools: create_artifact, get_artifact, list_artifacts, update_artifact, delete_artifact, download_artifact, share_artifact, create_folder.

Next Steps

• File Sharing Guide — Patterns and best practices
• Artifacts API — Complete endpoint reference