Signals

List project signals

Changed on

Returns a cursor-paginated page of signals in the project. Each item includes its scoreEvidence, lifecycle states, and time-window stats: firstSeenAt, lastSeenAt, occurrences, affectedSessionsPercent, trend, and tags.

get/v1/projects/{projectSlug}/signals

Request

  • Base URL
    https://api.latitude.so
  • Auth
    HTTP bearer

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier). The CLI can also read this from the LATITUDE_PROJECT_SLUG environment variable.

Query parameters

cursorstring

Opaque cursor returned in a previous response's nextCursor. Omit on the first page.

limitinteger

Page size. Defaults to 50; max 200.

querystring

Free-text semantic search across the signals' names and descriptions.

lifecycleGroup'active' | 'archived'

"active" for signals that are neither resolved nor ignored; "archived" for resolved or ignored signals. Omit to include both.

sortBy'lastSeen' | 'occurrences' | 'state'

Sort field. lastSeen orders by most recent occurrence; occurrences by total count in the time window; state by lifecycle priority.

sortDirection'asc' | 'desc'

Sort direction. Defaults to desc.

fromIsostring date-time

Lower bound (inclusive) of the time window. Defaults to ~6 days ago.

toIsostring date-time

Upper bound (inclusive) of the time window. Defaults to now.

Response

Page of signals

nextCursorstring nullable required

Opaque cursor for fetching the next page. null when there are no more pages. Pass it back in cursor to continue.

hasMoreboolean required

true when there is at least one more page after this one.

Changes

    • info

      added the required property // to the response with the status

    • warning

      added the new ignored enum value to the /// response property for the response status

    • warning

      added the new regressed enum value to the /// response property for the response status

    • warning

      added the new resolved enum value to the /// response property for the response status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status