> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Code-Scans auflisten (Devin API)
> Devin-Code-Scans in einer Organisation auflisten und den Scanstatus pollen – mit Filtern nach Zeit und Repository über die v3-Organisations-API
## Berechtigungen
Erfordert einen [Service-Benutzer](/de/api-reference/v3/service-users/members-service-users) oder ein [persönliches Zugriffstoken](/de/api-reference/personal-access-tokens) mit der Berechtigung `ViewCodeScans` auf Organisationsebene.
## Verhalten
Gibt die Code-Scans der Organisation zurück, beginnend mit dem neuesten. Verwenden Sie diesen Endpunkt, um den `status` eines mit [Code-Scan starten](/de/api-reference/v3/code-scans/organizations-code-scans-start) gestarteten Scans zu pollen: `waiting` → `pending` → `running` → `completed` (oder `failed` / `cancelled`). `awaiting_user_input` gilt nur für interaktive Scans, die über die Web-App gestartet wurden; über die API gestartete Scans erreichen diesen Status nicht. Um Scans für alle Organisationen eines Enterprise aufzulisten, verwenden Sie [Code-Scans auflisten (Enterprise)](/de/api-reference/v3/code-scans/enterprise-code-scans-list).
### Filter
* `time_after` / `time_before`: Unix-Zeitstempel in Sekunden (UTC), die den Erstellungszeitpunkt des Scans eingrenzen.
* `repo_name`: nur Scans, die dieses Repo gescannt haben. Entspricht Multi-Repo-Scans, die dieses Repo enthalten.
Die Ergebnisse werden mithilfe eines undurchsichtigen Cursors (`after` / `first`) paginiert.
## OpenAPI
````yaml de/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/scans
openapi: 3.1.0
info:
description: Devin v3 API mit Service-User-Authentifizierung und RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/code-scans/scans:
get:
tags:
- code-scans
summary: Code-Scans auflisten
description: >-
Code-Scans für die Organisation auflisten.
Scans werden neueste zuerst zurückgegeben. Optional nach ``repo_name``
und Erstellungszeit (``time_after`` / ``time_before``) filtern; die
Ergebnisse sind mit einem opaken Cursor (``after`` / ``first``)
paginiert.
operationId: handle_list_code_scans_v3_organizations__org_id__code_scans_scans_get
parameters:
- description: 'Organisations-ID (Präfix: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
- in: query
name: time_before
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time Before
- in: query
name: time_after
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time After
- in: query
name: after
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- in: query
name: first
required: false
schema:
default: 100
maximum: 200
minimum: 1
title: First
type: integer
- description: >-
Auf Scans filtern, die dieses Repository gescannt haben. Erfasst
auch Multi-Repo-Scans, selbst wenn das Repository nicht das primäre
Repo des Scans ist. Daher können zurückgegebene Einträge einen
anderen ``repo_name`` angeben.
in: query
name: repo_name
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
Auf Scans filtern, die dieses Repository gescannt haben. Erfasst
auch Multi-Repo-Scans, selbst wenn das Repository nicht das
primäre Repo des Scans ist. Daher können zurückgegebene Einträge
einen anderen ``repo_name`` angeben.
title: Repo Name
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_CodeScanResponse_'
description: Erfolgreiche Antwort
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht autorisiert
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Verboten
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht gefunden
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Konflikt
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht verarbeitbarer Inhalt
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Zu viele Anfragen
components:
schemas:
PaginatedResponse_CodeScanResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursor zum Abrufen der nächsten Seite oder None, wenn dies die
letzte Seite ist.
title: End Cursor
has_next_page:
default: false
description: Gibt an, ob nach dieser Seite weitere Einträge verfügbar sind.
title: Has Next Page
type: boolean
items:
items:
$ref: '#/components/schemas/CodeScanResponse'
title: Items
type: array
total:
anyOf:
- type: integer
- type: 'null'
description: >-
Optionale Gesamtanzahl (kann aus Performance-Gründen weggelassen
werden).
title: Total
required:
- items
title: PaginatedResponse[CodeScanResponse]
type: object
ProblemDetail:
description: >-
RFC 9457 application/problem+json-Fehlertext für die v3-API.
detail wird aus dem Legacy-Body {"detail": ...} aus Gründen der
Abwärtskompatibilität beibehalten; die
anderen Member sind additiv. errors enthält Validierungsfehler auf
Feldebene
(nur 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Eine menschenlesbare Erklärung, die speziell für diesen Fall gilt.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Validierungsfehler auf Feldebene (nur bei 422-Antworten).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Eine URI-Referenz (der Anfragepfad) für diesen Fall.
title: Instance
status:
description: Der HTTP-Statuscode.
title: Status
type: integer
title:
description: Eine kurze, menschenlesbare Zusammenfassung des Problemtyps.
title: Title
type: string
type:
default: about:blank
description: Eine URI-Referenz, die den Problemtyp identifiziert.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
CodeScanResponse:
description: Ein einzelner Code-Scan.
properties:
created_at:
description: Zeitpunkt, zu dem der Scan erstellt wurde (Unix-Sekunden).
title: Created At
type: integer
host:
anyOf:
- type: string
- type: 'null'
description: Git-Host des Repositorys, falls bekannt.
title: Host
org_id:
description: Organisation, zu der der Scan gehört.
title: Org Id
type: string
profile:
anyOf:
- $ref: '#/components/schemas/CodeScanProfileResponse'
- type: 'null'
description: Profil, unter dem der Scan ausgeführt wurde, falls vorhanden.
repo_name:
description: >-
Primäres Repository des Scans. Multi-Repo-Scans umfassen zusätzliche
Repositorys, die hier nicht aufgeführt sind.
title: Repo Name
type: string
scan_id:
description: Eindeutige Kennung des Scans.
title: Scan Id
type: string
scan_type:
description: Typ des Scans, bei der Erstellung festgelegt.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
status:
description: >-
Scan-Status: waiting, pending, running, awaiting_user_input,
completed, failed oder cancelled.
enum:
- waiting
- pending
- running
- awaiting_user_input
- completed
- failed
- cancelled
title: Status
type: string
required:
- scan_id
- org_id
- repo_name
- host
- status
- profile
- scan_type
- created_at
title: CodeScanResponse
type: object
CodeScanProfileResponse:
description: Zusammenfassung des Profils, unter dem ein Scan ausgeführt wurde.
properties:
name:
description: Name des Profils.
title: Name
type: string
profile_id:
description: Eindeutige Kennung des Profils.
title: Profile Id
type: string
required:
- profile_id
- name
title: CodeScanProfileResponse
type: object
securitySchemes:
bearerAuth:
description: 'Servicebenutzer-Anmeldedaten (Präfix: cog_)'
scheme: bearer
type: http
````