Returns pong — useful for verifying connectivity

List stories via GET /api/v1/stories. WARNING: This endpoint does NOT support OData filtering. All query parameters ($filter, $top, $orderby, etc.) are silently ignored by the SAC API — it always returns every story on the tenant (3000+). The response does NOT include an 'owner' field. Response fields per story: storyId, name, createdBy, changedBy (and optionally model metadata). TO FILTER STORIES BY USER OR TYPE use sac_filerepository_list instead, which supports real OData $filter on createdBy, modifiedBy, resourceType, createdTime, etc.

Copy a story.

Rename a story.

Delete a story.

Get OData metadata document for the SAC REST API.

List resources via GET /api/v1/Resources (OData v2, returns XML/Atom format — not recommended for filtering). Use sac_filerepository_list for JSON responses with working OData $filter support.

Get a single resource by ID.

List story types, enumerate content types, and filter file repository resources via GET /api/v1/filerepository/Resources. Use to list all story types (standard story, story template, analytic application), enumerate design experiences (Classic vs Optimized), or filter stories/apps by user, date, or type. OData $filter, $top, $orderby, $select, $count all work. IMPORTANT — visibility scope: By default (applyManagePrivilege=false), only content the service account has Read access to is returned (typically a small subset of tenant content). Set applyManagePrivilege=true to get ALL tenant content (all users' private folders, public folders, workspaces) — requires the service account to have the "Manage" permission for Private Files and Public Files. Always use applyManagePrivilege=true when the user wants to search/list across the whole tenant. Response fields: resourceId, objectId, name, description, resourceType, resourceSubtype, createdTime, createdBy, modifiedTime, modifiedBy, folderType, workspaceId, workspaceName, openURL, isMobile, isFeatured. Filterable fields: resourceType (values: STORY, APPLICATION, DATAACTION, PLANNINGSEQUENCE, MULTIACCOUNT, DIMENSION, ANALYTIC_MODEL), createdBy (exact username/ID), modifiedBy, createdTime, modifiedTime, name, folderType (PUBLIC, PRIVATE, SYSTEM, INPUT_SCHEDULE). STORY TYPES — resourceSubtype and objectId encoding: resourceSubtype="" (empty) → standard story (covers both Classic and Optimized design experience) resourceSubtype="TEMPLATE" → story template resourceSubtype="APPLICATION" → Analytic Application (scripted, code-based) Design experience is NOT in resourceSubtype — it is encoded in the objectId prefix: objectId prefix "t.D:" → Classic design experience (legacy) objectId prefix "t.B:" → Optimized design experience (recommended, newer) To list story types: $select=name,resourceSubtype,objectId and $orderby=resourceSubtype asc — groups stories by subtype and lets you read the objectId prefix for design experience. Filter examples: $filter=resourceType eq 'STORY' — all stories $filter=resourceType eq 'STORY' and createdBy eq 'USERNAME' — stories by a specific user $filter=resourceType eq 'STORY' and modifiedBy eq 'USERNAME' — stories last modified by user $filter=resourceType eq 'STORY' and createdTime gt 2024-01-01T00:00:00Z — recently created WORKSPACE / TEAM FILES: To list all workspaces (team files spaces), filter by folderType eq 'INPUT_SCHEDULE' and workspaceId ne null. This returns exactly one entry per workspace with its workspaceId and workspaceName. Example: $filter=folderType eq 'INPUT_SCHEDULE' and workspaceId ne null with $select=workspaceId,workspaceName and $orderby=workspaceName asc.

List repositories. Supports OData query params.

Get widget data from a story.

List data export namespaces (sac, sac_currency_tables, sac_public_dimensions, sac_unit_conversion).

Get namespace details.

List data providers (models) in a namespace.

List all data export subscriptions.

Get subscription by composite key.

List subscriptions for a provider.

Create data export subscription for delta tracking.

Delete data export subscription(s).

Get OData metadata for admin service.

Get OData metadata (EDMX) for a provider.

List available entity sets for a provider.

Get fact data. Supports OData params, delta tracking (trackChanges/deltaid/externalid), CSV export.

Get aggregated fact data grouped by dimensions and measures. PREREQUISITE: call sac_import_get_model_metadata first to discover valid dimension and measure names for $select. Use $select for dims/measures. 'provider' is the model ID — resolve name→ID via sac_filerepository_list ($filter=name eq 'MODEL_NAME' and resourceType eq 'ANALYTIC_MODEL'). Namespace for analytic models is 'sac'.

Get measure value differences over subscription period. Requires trackChanges or deltaid.

Get master data and level-based hierarchies for all dimensions.

Get master data for a single dimension ({DimensionName}Master entity set).

Get master data with parent-child hierarchy for a dimension.

Get audit data (change history). Requires Data Audit enabled on model.

Get currency conversion rates. Namespace: sac_currency_tables.

Get unit conversion rates. Namespace: sac_unit_conversion.

Get public dimension master data. Namespace: sac_public_dimensions.

Generic: get data from any provider entity set. For Distinct queries use '{col}___Distinct'.

List models available for data import. Does NOT support name filtering — returns all models. To find a model ID by name, use sac_filerepository_list with $filter=name eq 'MODEL_NAME' and resourceType eq 'ANALYTIC_MODEL' — the returned resourceId is the model ID.

Get model import types, versions, settings, and metadata URL.

Get model dimension names, measure names and field types. Call this BEFORE sac_export_get_fact_data_aggregation to discover valid $select fields (e.g. PD_O_BusinessUnit, SignedData). Required whenever field names are unknown. Use when: aggregating fact data, exporting by dimension, querying model structure.

Create import job for a model. Returns JobID/JobURL.

List all import jobs.

Upload data to an import job. Returns upserted/failed row counts.

Validate import job before running.

Execute validated import job.

Get job status: READY_FOR_DATA, READY_FOR_WRITE, PROCESSING, COMPLETED, FAILED.

Get rejected rows with rejection reasons.

Delete an import job.

One-click: create job, upload, validate, run in one request.

List public dimensions available for import.

Get public dimension import types and metadata URL.

Get public dimension metadata: columns, types, keys.

Create import job for a public dimension.

List currency conversion tables for import.

Get currency conversion import types and settings.

Get currency conversion metadata: columns, types, keys.

Create import job for a currency conversion table.

List unit conversion tables for import.

Get unit conversion import types and settings.

Get unit conversion metadata: columns, types, keys.

Create import job for a unit conversion table.

Execute a multi action. ID format: :. Body requires parameterValues array (empty if none).

Get execution status of a multi action.

Get a calendar event by ID.

Update a calendar event (partial).

Copy/create a calendar event.

Create a content transport export job.

Get content transport job status.

Create a content transport import job.

Delete a content item.

Get content item details within a wave.

Get permissions for a content item.

Move a content item to a target location.

List users (SCIM v2).

Get a user by UUID.

Create a user (SCIM v2).

Full replace of a user (SCIM v2 PUT).

Partial update of a user (SCIM v2 PATCH).

Delete a user.

List user security groups via SCIM v2 (/api/v1/scim2/Groups). Returns groups used for role assignments and access control (e.g. T_SALES, T_HR). These are identity/authorization groups, not file storage folders.

Create a team/group (SCIM v2).

Partial update of a team/group (SCIM v2 PATCH).

Bulk SCIM operations (create/update/delete multiple users/groups).

Export audit activity logs with OData query params.

Get monitoring data for a model.

Get schedule creation template with defaults.

Create a publication schedule.

Update a publication schedule (partial).

Delete a publication schedule.

List translatable artifacts.

Get metadata for a translatable artifact.

Download XLIFF translation file for an artifact.

Download XLIFF files for multiple artifacts.

Execute a SQL-like query against SAC. Auto-selects OData vs Widget Query based on query type.