---
title: "POST /datasets/{datasetId}/dataviewsv2/{dataviewId}/external-access-details"
method: POST
path: "/datasets/{datasetId}/dataviewsv2/{dataviewId}/external-access-details"
---

# POST /datasets/{datasetId}/dataviewsv2/{dataviewId}/external-access-details

`POST /datasets/{datasetId}/dataviewsv2/{dataviewId}/external-access-details`

Returns the credentials to access the external Dataview from an S3 location. To call this API:

*   You must retrieve the programmatic credentials.
    
*   You must be a member of a FinSpace user group, where the dataset that you want to access has `Read Dataset Data` permissions.

## Path parameters

- `dataviewId` string, required — DataView ID
- `datasetId` string, required — ID for a given Dataset

## Response `200`

Success

- GetExternalDataViewAccessDetailsResponse
  - `credentials` object — The credentials required to access the external Dataview from the S3 location.
    - `accessKeyId` string — The unique identifier for the security credentials.
    - `secretAccessKey` string, password — The secret access key that can be used to sign requests.
    - `sessionToken` string, password — The token that users must pass to use the credentials.
    - `expiration` integer — The Epoch time when the current credentials expire.
  - `s3Location` object — The location where the external Dataview is stored.
    - `bucket` string, required — The name of the S3 bucket.
    - `key` string, required — The path of the folder, within the S3 bucket that contains the Dataset.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/finspace-data.md) · [All operations](https://skmtc.net/aws/apis/finspace-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/finspace-data/versions/d7561d153837/schema)