Reference
artifacts
What builds left: write-once objects with a server-computed SHA-256, installed by id or downloaded. Index · shared schemas · errors.
| Procedure | Summary | REST | MCP tool | Stability |
|---|---|---|---|---|
artifacts.list | A project's artifacts, newest first, or one build's | GET | — | experimental |
artifacts.get | One artifact: its build, format, size, server-computed SHA-256 and app metadata | GET | — | experimental |
artifacts.download | A short-lived signed URL to download an artifact (an attachment, pinned to the stored generation) | GET | — | experimental |
artifacts.list
A project's artifacts, newest first, or one build's
| REST | GET /v1/artifacts/list (input as query parameters) |
| RPC | /rpc/v2/artifacts/list |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: read-only, idempotent |
| Auth | artifacts:read |
| Tenancy | project |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ projectId: ProjectId; buildId?: BuildId; limit?: PageLimit; cursor?: PageCursor }Output:
{ artifacts: CloudArtifact[]; nextCursor?: string }Named types: BuildId, CloudArtifact, PageCursor, PageLimit, ProjectId.
artifacts.get
One artifact: its build, format, size, server-computed SHA-256 and app metadata
| REST | GET /v1/artifacts/get (input as query parameters) |
| RPC | /rpc/v2/artifacts/get |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: read-only, idempotent |
| Auth | artifacts:read |
| Tenancy | project |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ projectId: ProjectId; artifactId: ArtifactId }Output:
{ artifact: CloudArtifact }Named types: ArtifactId, CloudArtifact, ProjectId.
artifacts.download
A short-lived signed URL to download an artifact (an attachment, pinned to the stored generation)
| REST | GET /v1/artifacts/download (input as query parameters) |
| RPC | /rpc/v2/artifacts/download |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: read-only |
| Auth | artifacts:read |
| Tenancy | project |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ projectId: ProjectId; artifactId: ArtifactId }Output:
{ artifact: CloudArtifact; download: SignedRequestOut }Named types: ArtifactId, CloudArtifact, ProjectId, SignedRequestOut.