curl --request POST \
  --url https://api.sigmora.org/v1/workflow/context-snapshots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "scope": {
    "kind": "workspace",
    "workspaceId": "ws_91c2"
  },
  "projectId": "prj_9x2a4c",
  "purpose": "Draft Week 5 of the Statistics for AI course from the approved lesson plan.",
  "audience": "Course students and the editor who approves each lesson.",
  "sources": [
    {
      "sourceId": "src_lesson_plan_w5",
      "connector": "google_drive",
      "externalRef": "drive:file/1aB2cD3eF4gH5iJ6kL7mN8oP9",
      "version": "42",
      "contentHash": "c08e3351fa65c229dddbf93f49178b53ebb085597e2902cb901b9447d2eb9161",
      "aclDecisionId": "acl_7f3a91",
      "aclCheckedAt": "2026-08-12T08:30:00Z",
      "capturedAt": "2026-08-12T08:30:00Z",
      "scope": {
        "kind": "workspace",
        "workspaceId": "ws_91c2"
      },
      "role": "primary",
      "displayName": "Week 5 lesson plan",
      "mimeType": "application/vnd.google-apps.document"
    }
  ],
  "retrievedPassages": [],
  "exclusions": [],
  "policyVersion": "policy-2026-08",
  "retentionMode": "artifacts_only"
}
'

import requests

url = "https://api.sigmora.org/v1/workflow/context-snapshots"

payload = {
    "scope": {
        "kind": "workspace",
        "workspaceId": "ws_91c2"
    },
    "projectId": "prj_9x2a4c",
    "purpose": "Draft Week 5 of the Statistics for AI course from the approved lesson plan.",
    "audience": "Course students and the editor who approves each lesson.",
    "sources": [
        {
            "sourceId": "src_lesson_plan_w5",
            "connector": "google_drive",
            "externalRef": "drive:file/1aB2cD3eF4gH5iJ6kL7mN8oP9",
            "version": "42",
            "contentHash": "c08e3351fa65c229dddbf93f49178b53ebb085597e2902cb901b9447d2eb9161",
            "aclDecisionId": "acl_7f3a91",
            "aclCheckedAt": "2026-08-12T08:30:00Z",
            "capturedAt": "2026-08-12T08:30:00Z",
            "scope": {
                "kind": "workspace",
                "workspaceId": "ws_91c2"
            },
            "role": "primary",
            "displayName": "Week 5 lesson plan",
            "mimeType": "application/vnd.google-apps.document"
        }
    ],
    "retrievedPassages": [],
    "exclusions": [],
    "policyVersion": "policy-2026-08",
    "retentionMode": "artifacts_only"
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    scope: {kind: 'workspace', workspaceId: 'ws_91c2'},
    projectId: 'prj_9x2a4c',
    purpose: 'Draft Week 5 of the Statistics for AI course from the approved lesson plan.',
    audience: 'Course students and the editor who approves each lesson.',
    sources: [
      {
        sourceId: 'src_lesson_plan_w5',
        connector: 'google_drive',
        externalRef: 'drive:file/1aB2cD3eF4gH5iJ6kL7mN8oP9',
        version: '42',
        contentHash: 'c08e3351fa65c229dddbf93f49178b53ebb085597e2902cb901b9447d2eb9161',
        aclDecisionId: 'acl_7f3a91',
        aclCheckedAt: '2026-08-12T08:30:00Z',
        capturedAt: '2026-08-12T08:30:00Z',
        scope: {kind: 'workspace', workspaceId: 'ws_91c2'},
        role: 'primary',
        displayName: 'Week 5 lesson plan',
        mimeType: 'application/vnd.google-apps.document'
      }
    ],
    retrievedPassages: [],
    exclusions: [],
    policyVersion: 'policy-2026-08',
    retentionMode: 'artifacts_only'
  })
};

fetch('https://api.sigmora.org/v1/workflow/context-snapshots', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "contextSnapshot": {
    "id": "<string>"
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}