CEceledon-solutions
Cards

Search project cards

Changed on

Returns a bounded flat card page plus tag, assignee, linked-team, workflow-status, and accessible active/planned sprint filter options. Cards default to open only. Values within one repeated/comma-separated filter are ORed; distinct filter dimensions are ANDed. includeNoTeam extends the team facet with cards having no placement, and includeUnassigned extends the assignee facet with cards having no user links. Deadline and effort bounds are inclusive. Within either range dimension, its include-no-value flag ORs null-valued cards with bounded non-null matches; using only the flag matches only null-valued cards. Range dimensions AND with every other facet. Invalid instants, negative/non-integer effort values, reversed ranges, and cursors issued for different ranges return canonical 400 errors: INVALID_CARD_DEADLINE_FILTER, INVALID_CARD_DEADLINE_RANGE, INVALID_CARD_EFFORT_FILTER, INVALID_CARD_EFFORT_RANGE, or INVALID_CARD_CURSOR. Results use an explicit stable sort and opaque cursor.

get/api/v2/projects/{projectId}/cards

Request

  • Base URL
    https://davinci-app.com
  • Auth
    HTTP bearer

Query parameters

qstring

Case-insensitive substring search across card name, description, and resolution.

state'open' | 'closed' | 'all'

Project-global card lifecycle state.

tagIdsstring[]

Match cards carrying any selected project tag.

assigneeIdsstring[]

Match cards assigned to any selected project member.

includeUnassignedboolean

OR cards with no user links into the assignee facet. This is not a sentinel assignee ID.

teamIdsstring[]

Match cards placed on any selected linked team.

includeNoTeamboolean

OR cards with no team placement into the team facet. This is not a sentinel team ID.

statusIdsstring[]

Match cards whose selected-team placement uses any selected status.

sprintIdsstring[]

Match cards whose team placement uses any selected sprint.

deadlineFromstring date-time

Inclusive ISO 8601 instant lower bound for non-null card deadlines.

deadlineTostring date-time

Inclusive ISO 8601 instant upper bound for non-null card deadlines.

includeNoDeadlineboolean

OR cards with a null deadline into bounded deadline matches. With no deadline bounds, match only cards with no deadline.

effortMininteger

Inclusive lower bound for non-null card effort.

effortMaxinteger

Inclusive upper bound for non-null card effort.

includeNoEffortboolean

OR cards with null effort into bounded effort matches. With no effort bounds, match only cards with no effort.

sort'created_asc' | 'created_desc' | 'updated_asc' | 'updated_desc' | 'deadline_asc' | 'deadline_desc' | 'effort_asc' | 'effort_desc' | 'name_asc' | 'name_desc'

Stable card sort; card ID is the deterministic tie-breaker.

limitinteger

Maximum cards returned.

cursorstring

Opaque cursor returned as meta.nextCursor or meta.previousCursor.

Response

Flat project-card search page.

Changes