Skip to main content
    Ivy Biosciences logo
    Ivy Biosciences.bloom* docs
    login.bloom*
    Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Sessions/GET /v1/sessions

    GET /v1/sessions

    List sessions — Returns your sessions, most recently active first.

    Open in Claude(opens in a new tab)Open in ChatGPT(opens in a new tab)1 min read
    Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

    Returns your sessions, most recently active first. Page with limit and cursor: when hasMore is true, pass the returned nextCursor to get the next page.

    Request

    Query parameters

    limitinteger
    cursorstring (date-time)

    Pagination cursor — pass the nextCursor from the previous page (ISO date-time of last item's lastActiveAt)

    organizationIdstring

    Responses

    200 OK

    Session list

    Response shape:

    sessionsobject[]
    hasMoreboolean
    nextCursorstring (date-time)

    Pass as cursor in the next request to fetch the following page

    401 Unauthorized

    Authentication required

    Response shape: object

    curl -X GET 'https://ivybiosciences.com/api/v1/sessions' \
  -H "Authorization: Bearer $IVY_API_KEY"

    Was this page helpful?

    GET /v1/sessions/{sessionId}/assets

    List session assets — Returns all artifacts produced by tool calls in this session — files, datasets, figures, and other outputs stored in S3.

    GET /v1/sessions/{sessionId}

    Get a session — Returns one of your sessions, including its full persisted state. Sessions owned by another user return 404.

    Loading...