Routines

Returns routines in Research Agent sessions you can access. Without sessionId, the list includes routines reached through session ownership, a direct share, or a project grant; public-link access alone is excluded. With sessionId, the same filters, ordering, cursor, and response shape apply, and an unknown or inaccessible session returns 404.

By default the endpoint returns every unarchived routine. Use filter for active, paused, or archived routines; q searches names and instructions. The default order is newest first by createdAt. Sorting by removedAt requires filter=archived.

get/routines

Request

  • Base URL
    https://elicit.com/api/v2
  • URL
    https://elicit.com/api/v2/routines
  • Auth
    HTTP bearer

Query parameters

sessionIdstring uuid

Restrict results to one accessible Research Agent session.

filter'active' | 'paused' | 'archived'

Restrict results by lifecycle state. Omit to return all unarchived routines.

qstring

Case-insensitive search over routine names and instructions.

limitinteger

Page size.

cursorstring

Opaque nextCursor from the previous page.

sortBy'createdAt' | 'removedAt'

Sort field. removedAt requires filter=archived.

sortDirection'asc' | 'desc'

Response

One page of accessible routines.

nextCursorstring nullable required

Cursor for the next page, or null at the end.

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      endpoint added