Get part thumbnail
GET/v1/parts/:id/thumbnail
Requires Analyze a part (PATCH /parts/{id}) to have run and its job to have succeeded.
Serves the rendered PNG thumbnail for a part as image bytes, so a client can fetch it with the
API key it already holds rather than reading thumbnailUrl off GET /v1/parts/{id} first.
The thumbnail is the kernel’s three-quarter view of the analyzed part.
The bytes are served through this request rather than as a redirect to a presigned URL: a
thumbnail is a few kB, and streaming it keeps the disclosure on this request’s access audit
instead of handing out a bearer grant that outlives it. thumbnailUrl on the part response is
still the right choice for an <img src>, which cannot carry an Authorization header.
Resolves the same artifact GET /v1/parts/{id} reports — the latest analysis run by default,
or the run named by ?jobId=. A part whose analysis produced no thumbnail answers 404.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 410
- 500
- 503
The rendered PNG thumbnail.
The request is invalid.
The API key is missing or invalid.
The API key may not perform this operation: it has no access to this part of the API, it may only read it, or its creator has not met the organization’s two-factor requirement.
The part, its result, or its thumbnail was not found.
The part is older than the retention window and is no longer available.
The thumbnail could not be retrieved.
Authentication is temporarily unavailable.