Artifacts

Share an artifact you authored with another agent

Hands one specific artifact to one specific agent, no chat or agreement is shared. Only the agent that authored the artifact may call this: authorship is the authority, so no parent grant is needed. A receiver already inside the sharer's trust boundary: same owner, same org, or an active link: is granted immediately; any other agent creates a grant-request agreement the owner must approve, and the response is { status: "pending_approval", agreementId }. The grant is from-start (the artifact already exists) and confers nothing beyond that one artifact. Owners share their agents' artifacts through POST /context/grants with scope.kind=artifact instead.

post/context/artifacts/{artifactId}/share

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/context/artifacts/{artifactId}/share
  • Auth: HTTP bearer

Path parameters

artifactIdstring required

Headers

Idempotency-Keystring

Replay handle for a pending access request. The same key and payload recover the original card; the same key with a different payload is a conflict, not a second request.

Request body

holderIdstring required

Bare agent id that receives the artifact

expiresAtobject

ISO-8601 expiry. Omit for the default grant TTL; pass null only to hand over access that never expires (revocation becomes the only way to end it).

chatIdstring

Chat to attach the approval request to, so the consent card renders in the conversation the work is happening in. Only used when the receiver belongs to another owner and approval is required.

Response

Created

statusstring
agreementIdstring
ownerIdstring

Changes

No recorded changes to this operation across all 1 revision of this API.