Download artifact HTML or converted Markdown

Default format is HTML, the stored bytes, Content-Type: text/html. format=markdown converts that HTML on a worker and returns text/markdown. Markdown is not stored. Accept does not choose the format. Optional access is a short-lived HMAC grant for HTML in the viewer iframe and authenticates the request by itself when no Authorization or x-api-key header is present. A present credential header disables the grant. Markdown ignores it. Missing credentials without a valid grant are the same 404 as an unknown id.

GET /api/v1/artifacts/{id}/content

200

Example

<string>

Authorizations

bearerAuthsessionCookieaccessGrant

Authorization · string · header · required

Factrove API key, usually prefixed ftrv_. Send Authorization: Bearer <key>. Product routes do not accept x-api-key as a credential. A present Authorization header that is not a valid key does not fall back to the session cookie.

Path Parameters

id · string<uuid> · required

Artifact UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Query Parameters

format · enum<string>

html or markdown. Omitted means html.

Available options: html, markdown

access · string

Viewer content grant. HTML only, at most five minutes, ignored when a credential header is present. A valid grant returns 200 with no cookie or bearer key.

Minimum string length: 1

Response

200

text/html

HTML (text/html) or Markdown (text/markdown) bytes with charset=utf-8.

The response is of type string.