Get artifact revision

Read an artifact revision with its full source. Supply revision_id alone, or artifact_id with an exact version, or artifact_id alone for the highest version. Returns null when the revision ID or the requested version of an existing artifact is absent, and 404 when the artifact is absent.

GET/v1/projects/{projectId}/artifact-revisions

Authorization

AuthorizationPersonal API key · headerrequired

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

X-Organization-IdOrganization ID · headerrequired

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path parameters

projectIdstringrequired

Query parameters

revision_idstring<uuid>

Exact revision ID; omit artifact_id and version when supplied

matches ^([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)$

artifact_idstring<uuid>

Artifact to read; required when revision_id is omitted

matches ^([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)$

versioninteger

Exact version for artifact_id; omit to read its highest version

min 1 · max 2147483647

Responses

200

Response for status 200

revisionobject | nullrequired

Show properties

Any of:

object

idstringrequired

artifact_idstringrequired

versionintegerrequired

max 9007199254740991

storagestringrequired

filenamestringrequired

size_bytesintegerrequired

min 0 · max 9007199254740991

created_bystring | nullrequired

created_atstringrequired

source_codestring | nullrequired

null

null

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Personal API keyOrganization IDRemember on this deviceInclude my values in samples

Parameters

projectIdpath*revision_idqueryExact revision ID; omit artifact_id and version when suppliedartifact_idqueryArtifact to read; required when revision_id is omittedversionqueryExact version for artifact_id; omit to read its highest version

Request

curl -X GET 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/artifact-revisions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORGANIZATION_ID' \
  -H 'Accept: application/json'

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/artifact-revisions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/artifact-revisions",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json"
    },
)

Response

{
  "revision": {
    "id": "string",
    "artifact_id": "string",
    "version": 1,
    "storage": "string",
    "filename": "string",
    "size_bytes": 0,
    "created_by": "string",
    "created_at": "string",
    "source_code": "string"
  }
}