Skip to main content
Returns all artifacts (generated files) associated with a specific conversation or task.

​
Endpoint

GET /artifacts?contextType={type}&contextId={id}

​
Query parameters

ParameterTypeRequiredDescription
contextType"conversation" or "task"YesWhat the artifacts are linked to
contextIdstringYesThe conversation or task ID
workspacestringNoIf provided, also checks workspace artifact directory

​
Response

{
  "artifacts": [
    {
      "id": "art-abc123",
      "name": "ai_research_summary.md",
      "path": "/home/user/.niom/artifacts/conv-123/ai_research_summary.md",
      "mimeType": "text/markdown",
      "size": 4520,
      "contextType": "task",
      "contextId": "task-456",
      "createdAt": 1709556000000
    }
  ]
}

​
Example

# List artifacts for a conversation
curl "http://localhost:3001/artifacts?contextType=conversation&contextId=conv-123"

# List artifacts for a task
curl "http://localhost:3001/artifacts?contextType=task&contextId=task-456"