Files & artifacts

Send files into a task, retrieve the files an agent produces, generate media, and render polished documents server-side.

Uploads (files in)

POST/v1/workspaces/{workspace_id}/uploads —

upload a file (multipart); its extracted text can be folded into a chat or agent task.

Artifacts (files out)

Files an agent creates are tracked as artifacts:

GET/v1/workspaces/{workspace_id}/artifacts —

list (filter by kind, favorites_only, paginate).

GET/v1/workspaces/{workspace_id}/artifacts/{artifact_id}/download —

a fresh signed download URL.

POST/v1/workspaces/{workspace_id}/artifacts/preview —

an inline preview payload (tables parsed server-side; Office → PDF).

POST/v1/workspaces/{workspace_id}/artifacts/{artifact_id}/convert —

convert to another format (to).

Generate media

Image / video / speech generation is asynchronous — submit, then poll the task:

POST/v1/workspaces/{workspace_id}/generate/image —

prompt → poll

GET/v1/workspaces/{workspace_id}/generate/image/{task_id} —

POST/v1/workspaces/{workspace_id}/generate/video —

prompt, duration_sec, aspect_ratio.

POST/v1/workspaces/{workspace_id}/generate/speech —

text, voice.

GET/v1/workspaces/{workspace_id}/generate/pricing —

current per-unit rates.

Render documents

POST/v1/workspaces/{workspace_id}/render —

render a polished file from structured input: format (pdf / docx / xlsx / slides / md) plus sections, slides, or sheets. CJK is handled (no tofu).

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/render \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format": "pdf", "title": "Q2 Review",
     "sections": [{"heading": "Summary", "markdown_text": "Revenue **up 18%**."}]}'

Generation and rendering bill at the rates shown by /generate/pricing; the charge settles against the workspace balance when the file is delivered.