Get the current Artifact head

GET
/v1/scopes/{scope_id}/artifacts/{family}/{artifact_id}

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Path Parameters

scope_id*string
Match.*\S.*
Length1 <= length <= 256
family*string

Value in

  • "memory"
  • "experience"
  • "skill"
  • "handoff"
  • "prompt"
artifact_id*string
Match^[\x21-\x7E]+$
Length1 <= length <= 128

Header Parameters

If-None-Match?string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/scopes/string/artifacts/memory/string"
{  "scope_id": "string",  "family": "memory",  "artifact_id": "string",  "revision": 1,  "content": {},  "sources": [    {      "source_type": "content",      "source_id": "string"    }  ],  "artifacts": [    {      "family": "string",      "artifact_id": "string",      "revision": 1    }  ],  "content_digest": "string"}

List current Artifact heads GET

List current heads for exactly one built-in Artifact family.

Replace the current Artifact head PUT

Commit a complete next revision when If-Match identifies the current head. Replacing a Prompt requires current scope.admin authority, including switching to Auto and restoring an earlier revision. Artifact ownership does not authorize Prompt replacement after Scope role revocation.