Skip to content
Acenta Docs

Artifacts API

Endpoints for managing artifacts (files and data).

Create Artifact

Section titled “Create Artifact”

Direct Upload

Section titled “Direct Upload”
POST /api/v1/artifacts
Content-Type: multipart/form-data

Form fields:

  • file - File data
  • name - Artifact name
  • content_type - MIME type
  • metadata - JSON metadata

Create Snippet

Section titled “Create Snippet”
POST /api/v1/artifacts/snippets

Request:

{
  "name": "config.json",
  "content": {"key": "value"},
  "metadata": {"version": "1.0"}
}

Get Upload URL (Large Files)

Section titled “Get Upload URL (Large Files)”
POST /api/v1/artifacts/upload-url

Request:

{
  "name": "large-file.zip",
  "content_type": "application/zip",
  "size_bytes": 1073741824
}

Response:

{
  "data": {
    "upload_id": "upl_xxx",
    "url": "https://storage.acenta.ai/...",
    "expires_at": "2026-01-01T13:00:00Z"
  }
}

Confirm Upload

Section titled “Confirm Upload”
POST /api/v1/artifacts/upload-url/{upload_id}/confirm

Get Artifact

Section titled “Get Artifact”

Metadata

Section titled “Metadata”
GET /api/v1/artifacts/{artifact_id}

Response:

{
  "data": {
    "id": "art_xxx",
    "name": "report.pdf",
    "content_type": "application/pdf",
    "size_bytes": 1048576,
    "metadata": {...},
    "version": 1,
    "created_at": "2026-01-01T00:00:00Z"
  }
}

Download

Section titled “Download”
GET /api/v1/artifacts/{artifact_id}/download
GET /api/v1/artifacts/{artifact_id}/download?version={version}

Signed URL

Section titled “Signed URL”
POST /api/v1/artifacts/{artifact_id}/signed-url

Request:

{
  "expires_in": 3600
}

Response:

{
  "data": {
    "url": "https://storage.acenta.ai/...",
    "expires_at": "2026-01-01T13:00:00Z"
  }
}

List Artifacts

Section titled “List Artifacts”
GET /api/v1/artifacts

Query parameters:

  • content_type - Filter by MIME type
  • metadata - JSON metadata filter
  • limit - Max results
  • offset - Pagination offset

Update Artifact

Section titled “Update Artifact”

Creates a new version:

PUT /api/v1/artifacts/{artifact_id}
Content-Type: multipart/form-data

Versions

Section titled “Versions”

List Versions

Section titled “List Versions”
GET /api/v1/artifacts/{artifact_id}/versions

Response:

{
  "data": {
    "versions": [
      {
        "version": 2,
        "size_bytes": 1048576,
        "created_at": "2026-01-02T00:00:00Z"
      },
      {
        "version": 1,
        "size_bytes": 524288,
        "created_at": "2026-01-01T00:00:00Z"
      }
    ]
  }
}

Delete Version

Section titled “Delete Version”
DELETE /api/v1/artifacts/{artifact_id}/versions/{version}

Sharing

Section titled “Sharing”

Share Artifact

Section titled “Share Artifact”
POST /api/v1/artifacts/{artifact_id}/share

Request:

{
  "with_agents": ["agent-a", "agent-b"],
  "with_groups": ["team-a"]
}

Get Access List

Section titled “Get Access List”
GET /api/v1/artifacts/{artifact_id}/access

Response:

{
  "data": {
    "owner": "my-agent",
    "agents": ["agent-a", "agent-b"],
    "groups": ["team-a"]
  }
}

Unshare

Section titled “Unshare”
POST /api/v1/artifacts/{artifact_id}/unshare

Request:

{
  "agents": ["agent-a"],
  "groups": ["team-a"]
}

List Shared With Me

Section titled “List Shared With Me”
GET /api/v1/artifacts/shared

Delete Artifact

Section titled “Delete Artifact”
DELETE /api/v1/artifacts/{artifact_id}