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

# Get Agent Picks Actions and re-test results

> Read loss Actions with creation evidence, baseline cell install rates and Wilson 95% ranges, latest paid re-test status, credits and measured Outcomes results. Follow next_offset until null. Incomplete coverage is explicit. Rates come from completed test rollups and stored measurements. Requires Agent Picks.



## OpenAPI

````yaml /openapi.json get /projects/{projectId}/agent-picks/actions
openapi: 3.1.0
info:
  title: DevTune API
  version: 2.0.0
  description: >-
    API for programmatic access to your AI visibility data, webhook
    subscriptions, and automation workflows. Use this API to integrate DevTune
    data into CI/CD pipelines, BI tools, AI agents, and operational systems.
servers:
  - url: https://devtune.ai/api/v2
    description: Production
security:
  - bearerAuth: []
paths:
  /projects/{projectId}/agent-picks/actions:
    get:
      summary: Get Agent Picks Actions and re-test results
      description: >-
        Read loss Actions with creation evidence, baseline cell install rates
        and Wilson 95% ranges, latest paid re-test status, credits and measured
        Outcomes results. Follow next_offset until null. Incomplete coverage is
        explicit. Rates come from completed test rollups and stored
        measurements. Requires Agent Picks.
      operationId: getAgentPicksActions
      parameters:
        - name: actionId
          in: query
          schema:
            type: string
            format: uuid
          description: Read one Action and its re-test result.
        - name: projectId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: offset
          in: query
          schema:
            type: integer
            minimum: 0
            default: 0
      responses:
        '200':
          description: Agent Picks Actions and results
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/AgentPicksActionsData'
                  meta:
                    $ref: '#/components/schemas/Meta'
                required:
                  - data
                  - meta
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '429':
          $ref: '#/components/responses/RateLimitExceededError'
components:
  schemas:
    AgentPicksActionsData:
      type: object
      required:
        - actions
        - next_offset
        - incomplete
      properties:
        incomplete:
          type: boolean
          description: >-
            Some stored Action rows could not be read. Valid rows remain
            available.
        next_offset:
          type:
            - integer
            - 'null'
        actions:
          type: array
          items:
            type: object
            required:
              - action
              - retest
              - result
            properties:
              action:
                type: object
                required:
                  - id
                  - title
                  - description
                  - state
                  - portfolio_rank
                  - evidence
                properties:
                  id:
                    type: string
                    format: uuid
                  title:
                    type: string
                  description:
                    type: string
                  state:
                    type:
                      - string
                      - 'null'
                  portfolio_rank:
                    type:
                      - integer
                      - 'null'
                  evidence:
                    type: object
                    description: >-
                      Pinned baseline test_id, loss_key, tool_key, install
                      measurement, run_ids, failed_fetches and locked_urls. A
                      cell Action has cell; a reason Action has reason and
                      cells, aggregate counts and run evidence, without a
                      first-cell claim.
                    required:
                      - test_id
                      - loss_key
                      - tool_key
                      - baseline
                      - run_ids
                      - failed_fetches
                      - locked_urls
                    anyOf:
                      - required:
                          - cell
                        properties:
                          kind:
                            enum:
                              - cell
                      - required:
                          - kind
                          - reason
                          - cells
                        properties:
                          kind:
                            const: reason
                    properties:
                      test_id:
                        type: string
                        format: uuid
                      loss_key:
                        type: string
                      kind:
                        type: string
                        enum:
                          - cell
                          - reason
                      reason:
                        type: object
                        properties:
                          kind:
                            type: string
                            enum:
                              - fetch
                              - classifier
                          url:
                            type: string
                          status_code:
                            type: integer
                          key:
                            type: string
                      cells:
                        type: array
                        items:
                          type: object
                          required:
                            - test_id
                            - loss_key
                            - cell
                            - baseline
                          properties:
                            test_id:
                              type: string
                              format: uuid
                            loss_key:
                              type: string
                            cell:
                              type: object
                              additionalProperties: true
                            baseline:
                              $ref: >-
                                #/components/schemas/AgentPicksInstallMeasurement
                      tool_key:
                        type: string
                      cell:
                        type: object
                        properties:
                          environment_id:
                            type: string
                            format: uuid
                          environment_name:
                            type: string
                          intent:
                            type: string
                            enum:
                              - add
                              - recommend
                              - hosted
                          agent:
                            type: string
                          model:
                            type: string
                      baseline:
                        $ref: '#/components/schemas/AgentPicksInstallMeasurement'
                      runs:
                        type: array
                        items:
                          type: object
                          properties:
                            run_id:
                              type: string
                              format: uuid
                            outcome:
                              type: string
                            tool_key:
                              type:
                                - string
                                - 'null'
                            confidence:
                              type:
                                - number
                                - 'null'
                            classifier_version:
                              type: string
                            evidence:
                              type: object
                              additionalProperties: true
                      run_evidence_available:
                        type: boolean
                      run_ids:
                        type: array
                        items:
                          type: string
                          format: uuid
                      failed_fetches:
                        type: array
                        items:
                          type: object
                          properties:
                            run_id:
                              type: string
                              format: uuid
                            url:
                              type: string
                            status_code:
                              type: integer
                      locked_urls:
                        type: array
                        items:
                          type: string
              retest:
                type:
                  - object
                  - 'null'
                properties:
                  id:
                    type: string
                    format: uuid
                  status:
                    type: string
                  baseline_test_id:
                    type: string
                    format: uuid
                  action_id:
                    type: string
                    format: uuid
                  batch:
                    type: integer
                  reserved_micros:
                    type: integer
                  settled_micros:
                    type:
                      - integer
                      - 'null'
                  refunded_micros:
                    type: integer
              result:
                type:
                  - object
                  - 'null'
                properties:
                  result:
                    type: string
                    enum:
                      - improved
                      - mixed
                      - no_clear_change
                      - declined
                      - still_measuring
                      - unmeasured
                  test_id:
                    type: string
                    format: uuid
                  baseline_test_id:
                    type: string
                    format: uuid
                  baseline:
                    $ref: '#/components/schemas/AgentPicksInstallMeasurement'
                  after:
                    anyOf:
                      - $ref: '#/components/schemas/AgentPicksInstallMeasurement'
                      - type: 'null'
                  coverage_complete:
                    type: boolean
                  stop_reason:
                    type:
                      - string
                      - 'null'
                  measured_at:
                    type:
                      - string
                      - 'null'
                    format: date-time
    Meta:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        projectId:
          type: string
          format: uuid
    AgentPicksInstallMeasurement:
      type: object
      required:
        - picks
        - runs
        - planned
        - rate
        - rate_low
        - rate_high
        - completed_at
      properties:
        picks:
          type: integer
        runs:
          type: integer
        planned:
          type: integer
        rate:
          type: number
        rate_low:
          type: number
        rate_high:
          type: number
        completed_at:
          type: string
          format: date-time
        failed:
          type: integer
        not_run:
          type: integer
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        reason:
          type: string
          description: >-
            Why the request was refused, for an error with more than one cause,
            such as a refused content-draft start.
        status:
          type: integer
      required:
        - error
        - message
        - status
  responses:
    BadRequestError:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnauthorizedError:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ForbiddenError:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFoundError:
      description: Not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimitExceededError:
      description: Rate limit exceeded
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  headers:
    X-RateLimit-Limit:
      description: Maximum requests per window
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: Requests remaining in current window
      schema:
        type: integer
    X-RateLimit-Reset:
      description: Unix timestamp when the window resets
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key with dtk_live_ prefix. Obtain it from API Keys in the account
        sidebar. New keys start with all supported scopes selected for the
        chosen project, and you can narrow them to specific read/write scopes as
        needed.

````

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