Record Lenses Artifact Event

Receive and store Lenses artifact pin/unpin events from the power-api service.

post/api/v1/integration/lenses-artifact-events

Request

Base URL: https://carbonarc.ai (the document declares no server; this is the origin it was published from)
URL: https://carbonarc.ai/api/v1/integration/lenses-artifact-events
Auth: API key in header x-api-key

Request body

event_typestring required

Type of artifact event: 'pin' or 'unpin'

artifact_idstring required

UUID of the artifact

artifact_typestring required

Type of artifact: markdown, chart, executive-summary, follow-up

session_idstring required

Lenses chat session ID the artifact belongs to

user_emailstring email required

Email of the user who performed the action

client_namestring required

Name of the client/organization the user belongs to

titlestring required

Display title of the artifact

created_atstring date-time nullable

Timestamp of the event (defaults to now if not provided)

Example request

{
  "artifact_id": "7abf23dd-2eb7-424a-a9e5-b764cae0e88e",
  "artifact_type": "chart",
  "client_name": "carbonarc",
  "created_at": "2026-04-10T15:00:00Z",
  "event_type": "pin",
  "session_id": "lenses-7abf23dd-2eb7-424a-a9e5-b764cae0e88e",
  "title": "Walmart vs Target card spend",
  "user_email": "karl.deek@carbonarc.co"
}

Response

Successful Response

idstring uuid required

messagestring

Example response

{
  "id": "7abf23dd-2eb7-424a-a9e5-b764cae0e88e",
  "message": "Event recorded successfully"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.