Relativity

Relativity Import Job Module API

The Import Job Module API from Relativity — 11 operation(s) for import job module.

GitHub OpenAPI

Operations 11

POST /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/ Import services V1 import job controller create async #
POST /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/cancel/ Import services V1 import job controller cancel async #
POST /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/begin/ Import services V1 import job controller begin async #
POST /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/end/ Import services V1 import job controller end async #
POST /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/pause/ Import services V1 import job controller pause async #
POST /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/resume/ Import services V1 import job controller resume async #
GET /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/progress/ Import services V1 import job controller get progress async #
GET /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/details/ Import services V1 import job controller get details async #
GET /import-service/v1/workspaces/{workspaceID}/import-jobs/jobs/ Import services V1 import job controller get jobs async #
GET /import-service/v1/workspaces/{workspaceID}/import-jobs/location Import services V1 import job controller get default location for workspace… #
GET /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/location Import services V1 import job controller get default location for job async #

Documentation

📖
Documentation
https://platform.relativity.com/RelativityOne/Content/REST_API/REST_API.htm
📖
RateLimits
https://artifacts.apis.io/relativity/rate-limits/relativity-rate-limits.yml
📖
Documentation
https://platform.relativity.com/RelativityOne/Content/Relativity_Platform/Platform_APIs.htm
📖
GettingStarted
https://platform.relativity.com/RelativityOne/Content/Getting_Started/Basic_REST_API_concepts.htm
📖
Documentation
https://help.relativity.com/RelativityOne/Content/Management_Console/Cost_Explorer.htm

Specifications

⚙
OpenAPI
https://artifacts.apis.io/relativity/openapi/relativity-import-job-module-api-openapi.yml

Other Resources

🔗
Plans
https://artifacts.apis.io/relativity/plans/relativity-plans-pricing.yml
🔗
FinOps
https://artifacts.apis.io/relativity/finops/relativity-finops.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/relativity:relativity-import-job-module-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

relativity-import-job-module-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Relativity.Import.Services Import Job Module API
  description: Relativity.Import.Services
  version: '1.0'
servers:
- url: /Relativity.REST/api
  description: The URL prefix for all Kepler services
tags:
- name: Import Job Module
paths:
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/:
    post:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller create async
      description: Create import job.
      operationId: Import.Services.V1.ImportJobController.CreateAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/createJobBodyRequest'
        required: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/cancel/:
    post:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller cancel async
      description: Cancel import job.
      operationId: Import.Services.V1.ImportJobController.CancelAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/begin/:
    post:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller begin async
      description: Begin import job.
      operationId: Import.Services.V1.ImportJobController.BeginAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/end/:
    post:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller end async
      description: End import job.
      operationId: Import.Services.V1.ImportJobController.EndAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/pause/:
    post:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller pause async
      description: Pause import job.
      operationId: Import.Services.V1.ImportJobController.PauseAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/resume/:
    post:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller resume async
      description: Resume previously paused import job.
      operationId: Import.Services.V1.ImportJobController.ResumeAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/progress/:
    get:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller get progress async
      description: Get import job progress.
      operationId: Import.Services.V1.ImportJobController.GetProgressAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResponse.ImportProgress'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/details/:
    get:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller get details async
      description: Get import job details.
      operationId: Import.Services.V1.ImportJobController.GetDetailsAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResponse.ImportDetails'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/jobs/:
    get:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller get jobs async
      description: Get import jobs which exist in workspace.
      operationId: Import.Services.V1.ImportJobController.GetJobsAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/length'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResponse.ImportJobs'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/location:
    get:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller get default location for workspace…
      description: Gets the default location for the import files upload.
      operationId: Import.Services.V1.ImportJobController.GetDefaultLocationForWorkspaceAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResponse.String'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
  /import-service/v1/workspaces/{workspaceID}/import-jobs/{importJobID}/location:
    get:
      tags:
      - Import Job Module
      summary: Import services V1 import job controller get default location for job async
      description: Gets the default location for the import files upload.
      operationId: Import.Services.V1.ImportJobController.GetDefaultLocationForJobAsync
      parameters:
      - $ref: '#/components/parameters/X-CSRF-Header'
      - $ref: '#/components/parameters/workspaceID'
      - $ref: '#/components/parameters/importJobID'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResponse.String'
        '400':
          description: Bad Request. Validation exception.
      x-summary-source: derived
components:
  parameters:
    X-CSRF-Header:
      name: X-CSRF-Header
      in: header
      description: 'Required CSRF header for any KeplerService. *Note: Actual string value does not matter*. '
      required: true
      schema:
        type: string
        format: System.String
        default: .
    start:
      name: start
      in: query
      description: Index from which import jobs will be read.
      required: true
      schema:
        type: integer
      example: '0'
    importJobID:
      name: importJobID
      in: path
      description: Import job identification GUID.
      required: true
      schema:
        type: string
        format: uuid
      example: 00000000-0000-0000-0000-000000000000
    length:
      name: length
      in: query
      description: Number of returned import jobs in workspace.
      required: true
      schema:
        type: integer
      example: 10
    workspaceID:
      name: workspaceID
      in: path
      description: Workspace identification number.
      required: true
      schema:
        type: integer
      example: 10000
  schemas:
    ValueResponse.ImportJobs:
      description: ValueResponse of ImportJobs type
      allOf:
      - type: object
        properties:
          Value:
            type: object
            properties:
              Jobs:
                type: array
                items:
                  type: string
                  format: uuid
                uniqueItems: true
                description: Jobs Guid ids.
                example:
                - 1D2F6FF7-D3BA-49D4-BAF0-808533EE5233
                - 00000000-0000-0000-0000-000000000000
              TotalCount:
                type: integer
                example: 2
      - $ref: '#/components/schemas/Response'
    ValueResponse.ImportProgress:
      description: ValueResponse of ImportProgress type
      allOf:
      - type: object
        properties:
          Value:
            type: object
            properties:
              RecordsInDataSources:
                type: integer
                example: 11
              ImportedRecords:
                type: integer
                example: 10
              ErrorRecords:
                type: integer
                example: 1
      - $ref: '#/components/schemas/Response'
    createJobBodyRequest:
      type: object
      properties:
        applicationName:
          type: string
          description: Application name.
          example: importini
        correlationID:
          type: string
          description: External correlation ID.
          example: c0r31ati0n_ID
    ImportState:
      type: string
      example: New
      enum:
      - Unknown
      - New
      - Configured
      - ValidationErrors
      - InProgress
      - Paused
      - Canceled
      - Failed
      - Completed
    Response:
      type: object
      properties:
        IsSuccess:
          type: boolean
          example: true
        ErrorMessage:
          type: string
          example: ''
        ErrorCode:
          type: string
          example: ''
        ImportJobID:
          description: Import job identification GUID number.
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
    ValueResponse.String:
      description: ValueResponse of string type
      allOf:
      - type: object
        properties:
          Value:
            type: string
            example: //emttest/DefaultFileShare/EDDS124421/loadfile_d2609a39-f0ab-492e-a98e-a3171671cb00.dat
      - $ref: '#/components/schemas/Response'
    ValueResponse.ImportDetails:
      description: ValueResponse of ImportDetails type
      allOf:
      - type: object
        properties:
          Value:
            type: object
            properties:
              IsFinished:
                type: boolean
                example: true
              State:
                $ref: '#/components/schemas/ImportState'
              ApplicationName:
                type: string
                example: Example Application
              CreatedBy:
                type: integer
                example: 10
              CreatedOn:
                type: string
                format: date-time
                example: '2021-11-30T09:17:19.81'
              LastModifiedBy:
                type: integer
                example: 9
              LastModifiedOn:
                type: string
                format: date-time
                example: '2021-11-30T09:17:19.81'
      - $ref: '#/components/schemas/Response'
x-provenance:
  method: harvested
  publisher: Relativity
  source: https://platform.relativity.com/RelativityOne/Content/OASFiles/import-services-api.v1_0.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)