> ## Documentation Index > Fetch the complete documentation index at: https://kaneo.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Preview a sync rule change > Returns matching tasks, new exports, paused links and a token bound to the current integration and impact. Outgoing labels are workspace label IDs; incoming labels are exact repository label names. ## OpenAPI ````yaml /openapi.json post /integration-sync/project/{projectId}/{provider}/preview openapi: 3.1.0 info: title: Kaneo API version: 1.0.0 description: Kaneo Project Management API - Manage projects, tasks, labels, and more servers: - url: https://cloud.kaneo.app/api description: Kaneo API Server security: - bearerAuth: [] paths: /integration-sync/project/{projectId}/{provider}/preview: post: tags: - Integration sync summary: Preview a sync rule change description: >- Returns matching tasks, new exports, paused links and a token bound to the current integration and impact. Outgoing labels are workspace label IDs; incoming labels are exact repository label names. operationId: previewIntegrationSyncRules parameters: - schema: type: string minLength: 1 required: true name: projectId in: path - schema: type: string enum: - github - gitea - gitlab required: true name: provider in: path requestBody: required: true content: application/json: schema: type: object properties: rules: type: object properties: outgoing: oneOf: - type: object properties: mode: type: string enum: - all required: - mode - type: object properties: mode: type: string enum: - labels match: type: string enum: - any - all labels: type: array items: type: string minLength: 1 maxLength: 128 minItems: 1 maxItems: 50 required: - mode - match - labels description: >- Kaneo workspace label IDs controlling task sync. Missing labels pause sync. incoming: oneOf: - type: object properties: mode: type: string enum: - all required: - mode - type: object properties: mode: type: string enum: - labels match: type: string enum: - any - all labels: type: array items: type: string minLength: 1 maxLength: 128 minItems: 1 maxItems: 50 required: - mode - match - labels description: >- Exact repository label names controlling which issues can be imported. required: - outgoing - incoming required: - rules responses: '200': description: Proposed rule impact content: application/json: schema: $ref: '#/components/schemas/IntegrationSyncPreview' '400': description: Invalid rule or workspace label content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid credentials content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: No access to the project, or missing required permission content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Project, integration, or linked task not found content: application/json: schema: $ref: '#/components/schemas/ApiError' '409': description: Configuration, impact or comparison changed; review again content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': $ref: '#/components/responses/ApiKeyRateLimited' components: schemas: IntegrationSyncPreview: type: object properties: isActive: type: boolean rules: type: object properties: outgoing: oneOf: - type: object properties: mode: type: string enum: - all required: - mode - type: object properties: mode: type: string enum: - labels match: type: string enum: - any - all labels: type: array items: type: string minLength: 1 maxLength: 128 minItems: 1 maxItems: 50 required: - mode - match - labels description: >- Kaneo workspace label IDs controlling task sync. Missing labels pause sync. incoming: oneOf: - type: object properties: mode: type: string enum: - all required: - mode - type: object properties: mode: type: string enum: - labels match: type: string enum: - any - all labels: type: array items: type: string minLength: 1 maxLength: 128 minItems: 1 maxItems: 50 required: - mode - match - labels description: >- Exact repository label names controlling which issues can be imported. required: - outgoing - incoming labels: type: array items: type: object properties: id: type: string name: type: string color: type: string required: - id - name - color missingLabels: type: array items: type: string total: type: number matching: type: number willCreate: type: number willPause: type: number needsReview: type: number paused: type: number matchingTasks: type: array items: type: object properties: id: type: string number: type: - number - 'null' title: type: string required: - id - number - title pausedNextCursor: type: - string - 'null' pausedTasks: type: array items: type: object properties: id: type: string number: type: - number - 'null' title: type: string linkId: type: string url: type: string eligible: type: boolean required: - id - number - title - linkId - url - eligible previewToken: type: string required: - isActive - rules - labels - missingLabels - total - matching - willCreate - willPause - needsReview - paused - matchingTasks - pausedNextCursor - pausedTasks - previewToken ApiError: type: object properties: message: type: string description: Human-readable description of the error. example: Task not found code: type: string description: >- Stable UPPER_SNAKE_CASE code. Derived from the status unless a more specific code applies, such as VALIDATION_ERROR or MISSING_PERMISSION. example: NOT_FOUND issues: type: array items: type: object properties: path: type: string description: >- Dotted path to the invalid input, prefixed with the request part (body, query, params, header). example: body.title message: type: string example: Required required: - path - message description: Every validation issue, for VALIDATION_ERROR. missingPermissions: type: array items: type: string description: >- Permissions the caller lacks for this route, as resource:action, for MISSING_PERMISSION and API_KEY_SCOPE. example: - task:update required: - message - code responses: ApiKeyRateLimited: description: >- The API key exceeded its rate limit or usage quota. Wait the number of seconds in Retry-After before retrying. The X-RateLimit headers are sent only when the rate limit was hit. headers: Retry-After: description: >- Seconds to wait before retrying. Omitted when an exhausted usage quota never refills. schema: type: integer X-RateLimit-Limit: description: Requests the API key may make per window. schema: type: integer X-RateLimit-Remaining: description: Requests left in the current window. schema: type: integer X-RateLimit-Reset: description: Unix time in seconds when the current window resets. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: bearerAuth: type: http scheme: bearer description: API key or session token (Bearer) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.