SharePoint Integration

SharePoint integrations ingest libraries and documents into your workspace. Enable SharePoint at the instance level first—see the operator guide: SharePoint integration setup. If OAuth is required, use the login endpoints in OpenID & OAuth.

Basic request and response

Fetch integration configuration with GET /api/v1/app/integration/sharepoint/{integrationId}/config.

curl "https://{BASE_URL}/api/v1/app/integration/sharepoint/{integrationID}/config" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Example response

{
  "site_url": "https://auroralabs.sharepoint.com/sites/support",
  "library": "Shared Documents"
}

Start an ingest sync

curl -X POST "https://{BASE_URL}/api/v1/app/integration/sharepoint/{integrationID}/ingest" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json"

Example response

{
  "type": "sync_started",
  "current_artifact_count": 18,
  "integration_item_count": 64
}

Errors and edge cases

403: integration not enabled or missing permissions.
404: integration ID not found.

Filesystem Integration

Claromentis Integration

​Basic request and response

​Start an ingest sync

​Errors and edge cases

Basic request and response

Start an ingest sync

Errors and edge cases