List project secrets. Supports filtering by creation time.

get/v1/secrets

Request

  • Base URL
    https://api.browserbase.com
  • Auth
    API key in header X-BB-API-Key

Query parameters

startAtstring date-time

Only return secrets created on or after this timestamp (inclusive). RFC 3339, e.g. 2026-01-19T00:00:00Z.

endAtstring date-time

Only return secrets created on or before this timestamp (inclusive). RFC 3339, e.g. 2026-01-20T00:00:00Z.

limitinteger

Maximum number of results to return.

cursorstring

Pagination cursor. Pass the nextCursor from the previous response to fetch the next page. Omit to start from the first page.

Response

The page of matching secrets.

limitinteger required

The maximum number of results returned in this page.

nextCursorstring nullable required

Cursor for the next page. Pass it back as cursor on the next request to continue paging. null when there are no more results.

Changes