List Dashboard Shares

//native

type Smartsheet = {

  token: string;

  baseUrl: string;

};

/**

 * List Dashboard Shares

 * Gets a list of all users and groups to whom the specified dashboard is shared, and their access level.

 */

export async function main(

  auth: Smartsheet,

  sightId: string,

  accessApiLevel: string | undefined,

  sharingInclude: "ITEM" | "WORKSPACE" | undefined,

  includeAll: string | undefined,

  page: string | undefined,

  pageSize: string | undefined,

) {

  const url = new URL(`${auth.baseUrl}/sights/${sightId}/shares`);

  for (const [k, v] of [

    ["accessApiLevel", accessApiLevel],

    ["sharingInclude", sharingInclude],

    ["includeAll", includeAll],

    ["page", page],

    ["pageSize", pageSize],

  ]) {

    if (v !== undefined && v !== "" && k !== undefined) {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}