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>

Static bearer token used when local Server authentication is enabled.

In: header

Path Parameters

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

Value in

  • "memory"
  • "experience"
  • "skill"
  • "handoff"

Query Parameters

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

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.

Get the current Artifact head GET

Next Page