List current Artifact heads

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

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

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"

Query Parameters

tag?array<>
Items1 <= items <= 16
tag_match?string

Value in

  • "all"
  • "any"
limit?integer
Range1 <= value <= 100
Default50
cursor?string
Length1 <= length <= 4096

Response Body

application/json

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"
{  "items": [    {      "scope_id": "string",      "family": "memory",      "artifact_id": "string",      "revision": 1,      "sources": [        {          "source_type": "content",          "source_id": "string"        }      ],      "artifacts": [        {          "family": "string",          "artifact_id": "string",          "revision": 1        }      ],      "content_digest": "string"    }  ],  "next_cursor": "string"}

Create an Artifact POST

Dispatch the family-specific creation command through the owning Family writer and atomically create revision one, its derived Family state, and its system provenance Source. Handoff is the Scope singleton: Create returns 409 when it already exists and callers must use Replace to update it. Creating a Prompt requires scope.admin because its configuration affects the whole Scope; other families require scope.contribute.

Get the current Artifact head GET

Next Page