> ## Documentation Index > Fetch the complete documentation index at: https://www.docusnap.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Von einem Cursor fortsetzen > Setzt eine Abfrage mit dem `nextCursor` einer Seite oder mit dem Cursor eines unvollständigen Expands fort. Der Cursor trägt die ursprüngliche Abfrage; sonst wird nichts gesendet. Ein Cursor gilt eine Stunde lang, für den Benutzer und die Subscription, für die er ausgestellt wurde. Die Elemente sind immer vollständige Assets mit `expands`, auch wenn die erste Seite mit `select` angefordert wurde. Eine fortgesetzte Seite enthält nur die Expands mit der Kardinalität „eins“; Expands, die je Asset mehrere Zeilen liefern, werden nicht auf die folgenden Seiten übertragen. Bei einem Expand-Cursor sind die Elemente die Zeilen dieses Expands. Braucht das Recht `api_read` (*Lesen*). ## OpenAPI ````yaml /api-reference/openapi.de.yaml post /cursor/continue openapi: 3.0.3 info: title: Docusnap365 REST-API version: v1 description: > Die öffentliche REST-API von Docusnap365 zum Lesen, Abfragen und Schreiben von Assets. **Ablauf einer Anfrage.** Jede Anfrage durchläuft diese Prüfungen in dieser Reihenfolge: den API-Schlüssel (401, wenn er fehlt oder ungültig ist), die Rechte des Schlüssels (403, wenn ihm das Recht für die Operation fehlt), das Anfrage-Kontingent (429, oder 503, wenn das Kontingent nicht geprüft werden kann), danach die Operation selbst. Die Rechte vergeben Sie beim Anlegen des API-Schlüssels unter *Verwaltung › Integrationen › API-Schlüssel*: *Lesen* (`api_read`) oder *Lesen und Schreiben* (`api_write`). **Anfrage-Kontingent.** Jeder Aufruf einer Operation zählt als eine Anfrage. Das Kontingent teilt sich die Subscription mit dem MCP-Server. Sobald eine Anfrage gezählt ist, begleiten die `X-RateLimit-*`-Kopfzeilen die Antwort, auch eine Fehlerantwort; eine Subscription ohne Obergrenze bekommt keine. **Fehler.** Fehler sind `application/problem+json` (RFC 9457) mit den Feldern `type`, `title`, `status`, `detail`, `instance`, `errorCode`, `traceId` und `errors`. `detail` darf nicht ausgewertet werden. Ausnahmen: Die Antwort 401 hat weder Körper noch Content-Type, auch wenn der API-Schlüssel fehlt. Und auf dem Schreibweg wird ein Fehler des Ingest-Dienstes unverändert zurückgegeben und trägt stattdessen `errorMessage`. servers: - url: https://api.docusnap365.com/api/v1 security: - ApiKeyAuth: [] tags: - name: Assets description: Einzelne Assets lesen und schreiben. - name: Query description: Assets mit Filter, Sortierung, Expands und seitenweiser Ausgabe abfragen. paths: /cursor/continue: post: tags: - Query summary: Von einem Cursor fortsetzen description: > Setzt eine Abfrage mit dem `nextCursor` einer Seite oder mit dem Cursor eines unvollständigen Expands fort. Der Cursor trägt die ursprüngliche Abfrage; sonst wird nichts gesendet. Ein Cursor gilt eine Stunde lang, für den Benutzer und die Subscription, für die er ausgestellt wurde. Die Elemente sind immer vollständige Assets mit `expands`, auch wenn die erste Seite mit `select` angefordert wurde. Eine fortgesetzte Seite enthält nur die Expands mit der Kardinalität „eins“; Expands, die je Asset mehrere Zeilen liefern, werden nicht auf die folgenden Seiten übertragen. Bei einem Expand-Cursor sind die Elemente die Zeilen dieses Expands. Braucht das Recht `api_read` (*Lesen*). operationId: continueFromCursor requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ApiCursorRequest' responses: '200': description: Die nächste Seite. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Extra-Remaining: $ref: '#/components/headers/X-RateLimit-Extra-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ApiQueryResponse' '400': description: >- Der Körper lässt sich nicht lesen, oder der Cursor ist ungültig oder abgelaufen. x-error-codes: - VALIDATION_FAILED - INVALID_CURSOR - CURSOR_EXPIRED content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/ForbiddenCursor' '404': description: >- Der Cursor ist ein Expand-Cursor, und sein übergeordnetes Asset ist für den Benutzer nicht mehr sichtbar. x-error-codes: - NOT_FOUND content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: ApiCursorRequest: title: Cursor-Anfrage type: object required: - cursor properties: cursor: type: string description: Der Cursor aus `nextCursor` oder aus `incompleteExpands`. ApiQueryResponse: title: Abfrageantwort type: object required: - items properties: items: type: array items: anyOf: - $ref: '#/components/schemas/AssetDto' - $ref: '#/components/schemas/ExpandRow' description: Die Assets, bei einem Expand-Cursor die Zeilen des Expands. nextCursor: type: string nullable: true description: >- Vorhanden, wenn es weitere Elemente gibt. Gilt eine Stunde lang, für denselben Benutzer und dieselbe Subscription. hasMore: type: boolean description: Wahr, wenn es weitere Elemente gibt. incompleteExpands: type: object nullable: true additionalProperties: $ref: '#/components/schemas/ApiIncompleteExpand' description: >- Expands mit mehr Zeilen als ihr `limit`, mit dem Schlüssel `name:parentId`. ProblemDetails: title: Problembeschreibung type: object description: >- Ein Fehler nach RFC 9457. `errors` ist nie leer; bei einem Fehler ist `errors[0].code` gleich `errorCode`. properties: type: type: string description: >- Ein URN, abgeleitet aus `errorCode`, zum Beispiel `urn:ds365:error:not-found`. Er lässt sich nicht auflösen. title: type: string description: Ein fester englischer Text je Code. status: type: integer description: Der HTTP-Statuscode. detail: type: string description: >- Ein technischer englischer Satz. Der Text kann sich ändern und soll nicht ausgewertet werden. instance: type: string description: Der Anfragepfad. errorCode: type: string description: >- Der Fehlercode. Die Codes einer Operation stehen in `x-error-codes` ihrer Antwort. traceId: type: string description: Die Trace-Id der Anfrage. Dem Support nennen. errors: type: array items: $ref: '#/components/schemas/ProblemErrorItem' AssetDto: title: Asset type: object additionalProperties: true description: > Ein Asset. Mit `select` auf `POST /assets/query` enthält ein Element nur die gewählten Eigenschaften und die nach oben gezogenen Expands unter ihrem Namen (`object_data` als Objekt, die übrigen als Liste). properties: id: type: string format: uuid entityId: type: string format: uuid nullable: true schemaId: type: string format: uuid description: Der Typ des Assets. parentId: type: string format: uuid nullable: true name: type: string objectType: type: string type: type: string iconId: type: string sourceType: type: string organizationId: type: string format: uuid nullable: true locationId: type: string format: uuid nullable: true platformId: type: string format: uuid nullable: true domainId: type: string format: uuid nullable: true version: type: integer format: int32 status: type: string isManually: type: boolean createdAt: type: string format: date-time nullable: true createdBy: type: string format: uuid nullable: true createdByDisplayName: type: string modifiedAt: type: string format: date-time nullable: true modifiedBy: type: string format: uuid nullable: true modifiedByDisplayName: type: string deletedAt: type: string format: date-time nullable: true deletedBy: type: string format: uuid nullable: true deletedByDisplayName: type: string expands: type: object nullable: true additionalProperties: type: array items: $ref: '#/components/schemas/ExpandRow' description: >- Die Expands nach Namen. Nur in der vollständigen Form, nicht, wenn `select` sie nach oben gezogen hat. ExpandRow: title: Expand-Zeile type: object additionalProperties: true description: >- Eine Zeile eines Expands. Spalten ohne Wert fehlen. JSON-Spalten (`data`) werden als JSON geliefert. ApiIncompleteExpand: title: Unvollständiger Expand type: object required: - parentId - cursor properties: parentId: type: string format: uuid description: Das Asset, dessen Expand unvollständig ist. cursor: type: string description: >- Der Cursor, mit dem der Expand über `POST /assets/expand` fortgesetzt wird. loadedCount: type: integer format: int32 description: Die Zahl der schon gelieferten Zeilen. ProblemErrorItem: title: Fehlerelement type: object required: - code properties: code: type: string description: Der besondere Code dieses Elements. path: type: string description: >- Das Feld oder der Parameter, den der Fehler betrifft. Fehlt, wenn er die ganze Anfrage betrifft. data: type: object additionalProperties: true description: >- Weitere Werte, zum Beispiel `entityType` und `id` eines fehlenden Assets oder `missingScopes`. Fehlt, wenn leer. headers: X-RateLimit-Limit: description: >- Enthaltene Anfragen je Kontingentperiode. Wird für eine Subscription ohne Obergrenze nicht gesendet. schema: type: integer X-RateLimit-Remaining: description: >- Noch verfügbare enthaltene und zusätzliche Anfragen der laufenden Periode. schema: type: integer X-RateLimit-Extra-Remaining: description: >- Noch verfügbare zusätzliche Anfragen. Sie werden mit der Periode nicht zurückgesetzt. schema: type: integer X-RateLimit-Reset: description: Beginn der nächsten Kontingentperiode als Unix-Zeit in Sekunden. schema: type: integer format: int64 Retry-After: description: >- Beginn der nächsten Kontingentperiode als HTTP-Datum. Derselbe Zeitpunkt wie `X-RateLimit-Reset`. schema: type: string responses: Unauthorized: description: Der API-Schlüssel fehlt oder ist ungültig. x-error-codes: - UNAUTHORIZED ForbiddenCursor: description: >- Dem Schlüssel fehlt das Recht `api_read` (*Lesen*), der Cursor wurde für einen anderen Benutzer oder eine andere Subscription ausgestellt, oder die Berechtigungsschicht der Datenbank hat den Zugriff verweigert. x-error-codes: - FORBIDDEN - CURSOR_USER_MISMATCH - CURSOR_DATA_SOURCE_MISMATCH - PERMISSION_DENIED - MODULE_NOT_IN_EDITION - TENANT_FROZEN content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' TooManyRequests: description: >- Das Anfrage-Kontingent der Subscription ist aufgebraucht, enthaltene und zusätzliche Anfragen gleichermaßen. Wiederholen nach dem Zeitpunkt in `Retry-After`. Auch eine abgelehnte Anfrage wird gezählt. x-error-codes: - REST_REQUEST_QUOTA_EXCEEDED headers: Retry-After: $ref: '#/components/headers/Retry-After' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Extra-Remaining: $ref: '#/components/headers/X-RateLimit-Extra-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' examples: Das Kontingent ist aufgebraucht: value: type: urn:ds365:error:rest-request-quota-exceeded title: Request quota exceeded status: 429 detail: >- The request quota of 10000 requests per period is exhausted until 2026-12-01T00:00:00.0000000+00:00. instance: /api/v1/assets errorCode: REST_REQUEST_QUOTA_EXCEEDED traceId: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01 errors: - code: REST_REQUEST_QUOTA_EXCEEDED data: requestsLimit: 10000 requestsUsed: 10000 quotaResetAt: '2026-12-01T00:00:00+00:00' InternalError: description: >- Ein unerwarteter Fehler. `detail` ist ein fester Satz; bei einer Meldung die `traceId` angeben. x-error-codes: - INTERNAL_ERROR content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' ServiceUnavailable: description: >- Das Kontingent konnte nicht geprüft werden und die Anfrage wurde deshalb nicht bedient, oder die Datenbank ist vorübergehend ausgefallen. Ein erneuter Versuch kann gelingen. x-error-codes: - SERVICE_UNAVAILABLE content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel der Subscription. Jede Operation nennt in `x-pat-scopes` das Recht, das sie braucht: `api_read` (in der Oberfläche *Lesen*) oder `api_write` (*Lesen und Schreiben*). Der Schlüssel wird unter *Verwaltung › Integrationen › API-Schlüssel* angelegt. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.