---
title: "POST /#X-Amz-Target=AmazonAthena.ListNotebookMetadata"
method: POST
path: "/#X-Amz-Target=AmazonAthena.ListNotebookMetadata"
---

# POST /#X-Amz-Target=AmazonAthena.ListNotebookMetadata

`POST /#X-Amz-Target=AmazonAthena.ListNotebookMetadata`

Displays the notebook files for the specified workgroup in paginated format.

## Headers

- `X-Amz-Target` 'AmazonAthena.ListNotebookMetadata', required

## Request body

- ListNotebookMetadataInput
  - `Filters` object — Search filter string.
    - `Name` string — The name of the notebook to search for.
  - `NextToken` string — A token generated by the Athena service that specifies where to continue pagination if a previous request was truncated.
  - `MaxResults` integer — Specifies the maximum number of results to return.
  - `WorkGroup` string, required — The name of the Spark enabled workgroup to retrieve notebook metadata for.

## Response `200`

Success

- ListNotebookMetadataOutput
  - `NextToken` string — A token generated by the Athena service that specifies where to continue pagination if a previous request was truncated. To obtain the next set of pages, pass in the <code>NextToken</code> from the response object of the previous page call.
  - `NotebookMetadataList` NotebookMetadata[] — The list of notebook metadata for the specified workgroup.
    - `NotebookId` string — The notebook ID.
    - `Name` string — The name of the notebook.
    - `WorkGroup` string — The name of the Spark enabled workgroup to which the notebook belongs.
    - `CreationTime` string, date-time — The time when the notebook was created.
    - `Type` 'IPYNB' — The type of notebook. Currently, the only valid type is <code>IPYNB</code>.
    - `LastModifiedTime` string, date-time — The time when the notebook was last modified.

## Other responses

- `480` — InternalServerException
- `481` — InvalidRequestException
- `482` — TooManyRequestsException

---

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