> ## Documentation Index
> Fetch the complete documentation index at: https://docs.citino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List the work items

> The fixes queued for the project, highest estimated impact first. counts is the whole queue, not the page.



## OpenAPI

````yaml /api-reference/openapi.json get /projects/{projectId}/work-items
openapi: 3.1.0
info:
  title: Citino API
  version: v1
  description: >-
    Read how AI engines answer your market's questions, and keep your prompts,
    competitors, segments and engines in step from code. Every number carries
    its band and sample size.
servers:
  - url: https://api.citino.ai/v1
security:
  - bearerAuth: []
tags:
  - name: Brand and competitors
  - name: Definitions
  - name: Engines
  - name: Projects
  - name: Alerts
  - name: Attribution
  - name: Claims
  - name: Crawlability
  - name: Crawler activity
  - name: Metrics
  - name: Experiments
  - name: Prompts
  - name: Objections
  - name: Monthly reports
  - name: Reports
  - name: Runs
  - name: Searches
  - name: Sources
  - name: Work items
  - name: Settings
paths:
  /projects/{projectId}/work-items:
    get:
      tags:
        - Work items
      summary: List the work items
      description: >-
        The fixes queued for the project, highest estimated impact first. counts
        is the whole queue, not the page.
      operationId: getProjectsByProjectIdWorkItems
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
        - name: cursor
          in: query
          required: false
          description: The previous page's next_cursor.
          schema:
            description: The previous page's next_cursor.
            type: string
            minLength: 1
            maxLength: 512
        - name: limit
          in: query
          required: false
          description: Rows per page.
          schema:
            description: Rows per page.
            type: integer
            minimum: 1
            maximum: 100
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - open
              - in_progress
              - awaiting_approval
              - published
              - measuring
              - measured
              - dismissed
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        kind:
                          type: string
                        prompt_id:
                          type:
                            - string
                            - 'null'
                        prompt_text:
                          type:
                            - string
                            - 'null'
                        segment_id:
                          type:
                            - string
                            - 'null'
                        title:
                          type: string
                        rationale:
                          type: string
                        impact_points:
                          description: Null when not estimated, never 0.
                          type:
                            - number
                            - 'null'
                        effort:
                          type:
                            - string
                            - 'null'
                        status:
                          type: string
                          enum:
                            - open
                            - in_progress
                            - awaiting_approval
                            - published
                            - measuring
                            - measured
                            - dismissed
                        published_on:
                          anyOf:
                            - type: string
                              pattern: ^\d{4}-\d{2}-\d{2}$
                            - type: 'null'
                        published_url:
                          type:
                            - string
                            - 'null'
                        dismissed_reason:
                          type:
                            - string
                            - 'null'
                        created_at:
                          type: string
                        sources:
                          type: array
                          items:
                            type: object
                            properties:
                              domain:
                                type: string
                              type:
                                type: string
                              action:
                                type:
                                  - string
                                  - 'null'
                              actionable:
                                type: boolean
                            required:
                              - domain
                              - type
                              - action
                              - actionable
                            additionalProperties: false
                      required:
                        - id
                        - kind
                        - prompt_id
                        - prompt_text
                        - segment_id
                        - title
                        - rationale
                        - impact_points
                        - effort
                        - status
                        - published_on
                        - published_url
                        - dismissed_reason
                        - created_at
                        - sources
                      additionalProperties: false
                  next_cursor:
                    type:
                      - string
                      - 'null'
                  has_more:
                    type: boolean
                  counts:
                    type: object
                    properties:
                      open:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      in_progress:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      awaiting_approval:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      published:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      measuring:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      measured:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      dismissed:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                    required:
                      - open
                      - in_progress
                      - awaiting_approval
                      - published
                      - measuring
                      - measured
                      - dismissed
                    additionalProperties: false
                required:
                  - items
                  - next_cursor
                  - has_more
                  - counts
                additionalProperties: false
              example:
                items: []
                next_cursor: null
                has_more: false
                counts:
                  open: 0
                  in_progress: 0
                  awaiting_approval: 0
                  published: 0
                  measuring: 0
                  measured: 0
                  dismissed: 0
        '400':
          description: The request is invalid; `error.field` names the parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: 'No live API key in an `Authorization: Bearer` header.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The key lacks the scope named in the message, or cannot write.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such resource in this key's projects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Over the key's or the workspace's rate limit; see `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Busy or timed out; retry after `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-codeSamples:
        - lang: bash
          label: curl
          source: |-
            curl "https://api.citino.ai/v1/projects/{projectId}/work-items" \
              -H "Authorization: Bearer $CITINO_API_KEY"
        - lang: python
          label: Python
          source: |-
            import os
            import requests

            res = requests.get(
                "https://api.citino.ai/v1/projects/{projectId}/work-items",
                headers={"Authorization": f"Bearer {os.environ['CITINO_API_KEY']}"},
            )
            print(res.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const res = await
            fetch("https://api.citino.ai/v1/projects/{projectId}/work-items", {
              headers: {
                Authorization: `Bearer ${process.env.CITINO_API_KEY}`,
              },
            });

            console.log(await res.json());
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: >-
                validation, unauthorized, forbidden, not_found, conflict,
                plan_limit, rate_limited, busy, query_timeout
            message:
              type: string
            field:
              type: string
            detail:
              type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API key from Workspace settings → API keys, sent as `Authorization:
        Bearer <key>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.