SharePoint Access API

Authorization: Bearer pe_k1_abc123def456... 

HTTP/1.1 422 Unprocessable Entity 
{ 
  "error": "SHAREPOINT_NOT_ENABLED", 
  "message": "SharePoint access is not enabled for this access token. Enable it at https://my.porteden.com." 
} 

X-RateLimit-Limit: 60 
X-RateLimit-Remaining: 41 
X-RateLimit-Reset: 1714330080 
Retry-After: 7   # only on 429 

interface DriveFileDto { 
  id: string;                       // "sharepoint:drive:…:item:…" 
  name?: string; 
  mimeType?: string; 
  size?: number;                    // bytes 
  createdTime?: string;             // ISO 8601 
  modifiedTime?: string;            // ISO 8601 
  owners?: DriveUserDto[]; 
  sharedWith?: DriveUserDto[]; 
  description?: string; 
  webViewLink?: string; 
  downloadLink?: string; 
  parentFolderId?: string; 
  parentFolderName?: string; 
  labels?: Record<string, string>; 
  isFolder: boolean; 
  provider: string;                 // always "SHAREPOINT" on this surface 
} 
 
interface DriveUserDto { 
  email: string; 
  displayName?: string; 
  role?: string;                    // "owner" | "writer" | "reader" | "commenter" 
} 
 
interface DrivePermissionDto { 
  id: string; 
  type: string;                     // "user" | "group" | "domain" | "anyone" 
  role: string;                     // "owner" | "writer" | "reader" | "commenter" 
  emailAddress?: string; 
  domain?: string; 
  displayName?: string; 
} 
 
interface DriveFileListResponse { 
  files: DriveFileDto[]; 
  nextPageToken?: string; 
  hasMore: boolean; 
  accessInfo?: string; 
  authWarnings?: string[]; 
} 
 
interface DriveFileResponse { 
  file?: DriveFileDto; 
  accessInfo?: string; 
} 
 
interface DriveFileLinkResponse { 
  success: boolean; 
  webViewLink?: string; 
  downloadUrl?: string; 
  exportLinks?: Record<string, string>;   // always null/absent for SharePoint 
  fileName?: string; 
  mimeType?: string; 
  size?: number; 
  isGoogleWorkspaceFile: boolean;         // always false for SharePoint 
  errorMessage?: string; 
  errorCode?: string; 
} 
 
interface DrivePermissionsResponse { 
  permissions: DrivePermissionDto[]; 
  accessInfo?: string; 
} 
 
interface DriveOperationResult { 
  success: boolean; 
  fileId?: string;                  // populated for create/upload responses 
  errorMessage?: string; 
  errorCode?: string;               // "READ_ONLY" | "NO_PROVIDER" | "BLOCKED" | "OPERATION_NOT_ALLOWED" | … 
} 

interface CreateDriveFolderRequest { 
  name: string; 
  parentFolderId?: string; 
  description?: string; 
} 
 
interface RenameDriveFileRequest { 
  newName: string; 
} 
 
interface MoveDriveFileRequest { 
  destinationFolderId: string; 
} 
 
interface ShareDriveFileRequest { 
  type: "user" | "group" | "domain" | "anyone"; 
  role: "reader" | "writer" | "commenter"; 
  emailAddress?: string; 
  domain?: string; 
  sendNotification?: boolean;       // default true 
  message?: string; 
} 

interface SharePointSiteDto { 
  id: string;                       // "sharepoint:site:hostname,siteGuid,webGuid" 
  displayName?: string; 
  name?: string; 
  description?: string; 
  webUrl?: string; 
  createdDateTime?: string;         // ISO 8601 
  lastModifiedDateTime?: string; 
  isPersonalSite: boolean; 
} 
 
interface SharePointSiteListResponse { 
  sites: SharePointSiteDto[]; 
  nextPageToken?: string; 
  hasMore: boolean; 
  accessInfo?: string; 
} 
 
interface SharePointListDto { 
  id: string;                       // "sharepoint:site:…:list:…" 
  displayName?: string; 
  name?: string; 
  description?: string; 
  webUrl?: string; 
  template?: string;                // "genericList" | "documentLibrary" | "tasks" | "events" | … 
  hidden: boolean; 
  createdDateTime?: string; 
  lastModifiedDateTime?: string; 
  columns?: SharePointColumnDto[];  // populated on GET /lists/{listId}, omitted on listing 
} 
 
interface SharePointColumnDto { 
  name?: string;                    // API name — use in $filter / selectFields 
  displayName?: string;             // human label 
  columnType?: string;              // "text" | "number" | "choice" | "dateTime" | "personOrGroup" | "lookup" | … 
  hidden: boolean; 
  readOnly: boolean; 
  required: boolean; 
  indexed: boolean; 
} 
 
interface SharePointListListResponse { 
  lists: SharePointListDto[]; 
  nextPageToken?: string; 
  hasMore: boolean; 
  accessInfo?: string; 
} 
 
interface SharePointListItemDto { 
  id: string;                       // "sharepoint:site:…:list:…:item:…" 
  name?: string; 
  webUrl?: string; 
  contentType?: string; 
  createdDateTime?: string; 
  lastModifiedDateTime?: string; 
  fields?: Record<string, unknown>; // null when the token has field_values masked off 
  createdBy?: string; 
  lastModifiedBy?: string; 
} 
 
interface SharePointListItemListResponse { 
  items: SharePointListItemDto[]; 
  nextPageToken?: string; 
  hasMore: boolean; 
  accessInfo?: string; 
} 
 
interface CreateListItemRequest { 
  fields: Record<string, unknown>;  // keyed by column API name 
} 
 
interface UpdateListItemRequest { 
  fields: Record<string, unknown>;  // only included keys are updated 
} 
 
interface SensitivityLabelDto { 
  id: string;                       // bare GUID, no prefix 
  displayName?: string; 
  description?: string; 
  color?: string;                   // "Green" | "Yellow" | "Orange" | "Red" | … 
  sensitivity: number;              // priority/severity, higher = more sensitive 
  toolTip?: string; 
  isActive: boolean; 
  isAppliable: boolean; 
} 
 
interface SensitivityLabelListResponse { 
  labels: SensitivityLabelDto[]; 
  accessInfo?: string; 
} 
 
interface ItemSensitivityLabelResponse { 
  success: boolean; 
  labelId?: string; 
  labelDisplayName?: string; 
  assignmentMethod?: "standard" | "privileged" | "auto"; 
  assignedDateTime?: string; 
  errorMessage?: string; 
} 
 
interface SharePointSearchHitDto { 
  entityType: "driveItem" | "listItem" | "list" | "site"; 
  id: string;                       // already prefixed 
  title?: string; 
  summary?: string; 
  webUrl?: string; 
  lastModifiedDateTime?: string; 
} 
 
interface SharePointSearchResponse { 
  hits: SharePointSearchHitDto[]; 
  from: number; 
  total: number;                    // unfiltered Graph hit count 
  moreResultsAvailable: boolean; 
  accessInfo?: string; 
}