---
title: "Create an analysis job"
method: POST
path: "/analyses"
---

# Create an analysis job

`POST /analyses`

## Request

- Base URL: `https://api.instalent.io/api/v1`
- URL: `https://api.instalent.io/api/v1/analyses`
- Auth: HTTP bearer and API key in header `X-Customer-Key`

Queues the job and returns 202. Poll GET /analyses/{id}, stream GET /analyses/{id}/events, or wait for the analysis.completed webhook, then page GET /analyses/{id}/results.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `profileIds` string[], required
  - `criteria` string[], required

## Response `200`

Replayed: this Idempotency-Key already created a job, so the original is returned.

- object
  - `id` string, required
  - `kind` 'search' | 'enrichment' | 'analysis', required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
  - `input` object, required
  - `progress` object, nullable, required
    - `phase` string
    - `current` number
    - `total` number
  - `summary` object, nullable, required
  - `error` object, nullable, required
    - `code` string, required
    - `message` string, required
    - `retryable` boolean
  - `createdAt` string, required
  - `startedAt` string, nullable, required
  - `finishedAt` string, nullable, required
  - `links` object
    - `self` string
    - `results` string
    - `events` string
    - `cancel` string

## Other responses

- `202`: OK
- `4XX`: Error

---

[API](https://skmtc.dev/instalent/apis/instalent-integrator-api.md) · [All operations](https://skmtc.dev/instalent/apis/instalent-integrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instalent/apis/instalent-integrator-api/revisions/eda181144149?raw)