## Cancel Split Job

`client.Split.Cancel(ctx, splitJobID, body) (*SplitCancelResponse, error)`

**post** `/api/v1/split/jobs/{split_job_id}/cancel`

Cancel a running split job.

Requests cancellation; the job transitions to CANCELLED asynchronously once processing stops. Returns the job, which may still be in its current non-terminal state. Jobs already in a terminal state (COMPLETED, FAILED, CANCELLED) cannot be cancelled.

### Parameters

- `splitJobID string`

- `body SplitCancelParams`

  - `OrganizationID param.Field[string]`

  - `ProjectID param.Field[string]`

### Returns

- `type SplitCancelResponse struct{…}`

  A split job.

  - `ID string`

    Unique identifier for the split job.

  - `Categories []SplitCategory`

    Categories used for splitting.

    - `Name string`

      Name of the category.

    - `Description string`

      Optional description of what content belongs in this category.

  - `DocumentInputType SplitCancelResponseDocumentInputType`

    Whether the input was a file or parse job

    - `const SplitCancelResponseDocumentInputTypeFileID SplitCancelResponseDocumentInputType = "file_id"`

    - `const SplitCancelResponseDocumentInputTypeParseJobID SplitCancelResponseDocumentInputType = "parse_job_id"`

    - `const SplitCancelResponseDocumentInputTypeURL SplitCancelResponseDocumentInputType = "url"`

  - `FileInput string`

    File ID or parse job ID

  - `ProjectID string`

    Project this job belongs to.

  - `Status string`

    Current job status. Valid values are: pending, processing, completed, failed, cancelled.

  - `UserID string`

    User who created this job.

  - `ConfigurationID string`

    Split configuration ID used for this job.

  - `CreatedAt Time`

    Creation datetime

  - `ErrorMessage string`

    Error message if the job failed.

  - `Result SplitResultResponse`

    Result of a completed split job.

    - `Segments []SplitSegmentResponse`

      List of document segments.

      - `Category string`

        Category name this split belongs to.

      - `ConfidenceCategory string`

        Categorical confidence level. Valid values are: high, medium, low.

      - `Pages []int64`

        1-indexed page numbers in this split.

  - `SplittingStrategy SplitCancelResponseSplittingStrategy`

    Strategy used for splitting.

    - `AllowUncategorized string`

      Controls handling of pages that don't match any category. 'include': pages can be grouped as 'uncategorized' and included in results. 'forbid': all pages must be assigned to a defined category. 'omit': pages can be classified as 'uncategorized' but are excluded from results.

      - `const SplitCancelResponseSplittingStrategyAllowUncategorizedForbid SplitCancelResponseSplittingStrategyAllowUncategorized = "forbid"`

      - `const SplitCancelResponseSplittingStrategyAllowUncategorizedInclude SplitCancelResponseSplittingStrategyAllowUncategorized = "include"`

      - `const SplitCancelResponseSplittingStrategyAllowUncategorizedOmit SplitCancelResponseSplittingStrategyAllowUncategorized = "omit"`

    - `CustomInstructions string`

      Free-form guidance for where segment boundaries are placed.

    - `MinPagesPerSplit int64`

      Minimum pages per segment. Shorter segments are merged into an adjacent segment; 1 disables merging.

  - `TransactionID string`

    Idempotency key scoped to the project, if one was provided.

  - `UpdatedAt Time`

    Update datetime

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/run-llama/llama-parse-go"
  "github.com/run-llama/llama-parse-go/option"
)

func main() {
  client := llamacloud.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.Split.Cancel(
    context.TODO(),
    "split_job_id",
    llamacloud.SplitCancelParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.ID)
}
```

#### Response

```json
{
  "id": "id",
  "categories": [
    {
      "name": "x",
      "description": "x"
    }
  ],
  "document_input_type": "file_id",
  "file_input": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "project_id": "project_id",
  "status": "status",
  "user_id": "user_id",
  "configuration_id": "configuration_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "error_message": "error_message",
  "result": {
    "segments": [
      {
        "category": "category",
        "confidence_category": "confidence_category",
        "pages": [
          0
        ]
      }
    ]
  },
  "splitting_strategy": {
    "allow_uncategorized": "forbid",
    "custom_instructions": "Start a new segment at every signature page.",
    "min_pages_per_split": 1
  },
  "transaction_id": "transaction_id",
  "updated_at": "2019-12-27T18:11:19.117Z"
}
```