List shares created by the caller

GET /v1/shares

List shares created by the caller

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/shares \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "<string>",
      "type": "conversation",
      "context_id": "<string>",
      "message_id": "<string>",
      "artifact_id": "<string>",
      "agent_id": "<string>",
      "title": "<string>",
      "agent_name": "<string>",
      "artifact_type": "<string>",
      "url": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Query Parameters

type · enum<string>

Available options: conversation, message, artifact

Maximum string length: 32

agent_id · string

Maximum string length: 64

limit · string

Page size (default 20).

page · string

Response

200

application/json

Page of shares.

items · object[]

Hide child attributes

items. id · string

items. type · enum<string>

Available options: conversation, message, artifact

items. context_id · string

items. message_id · string

items. artifact_id · string

items. agent_id · string

items. title · string

items. agent_name · string

items. artifact_type · string

items. url · string

Workspace-relative public viewer URL.

items. created_at · string<date-time>