Resolve parent

POST

resolve-parent

curl --request POST \
  --url https://api.kernel.ai/rest/v1/resolve-parent \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kernel_id": "6347422643"
}
'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}

{
  "error": "kernel_id is required"
}

{
  "message": "Forbidden"
}

{
  "error": "Rate limit exceeded. Retry after 60 seconds."
}

{
  "error": "Internal processing error."
}

Starts a parent hierarchy resolution job for a resolved entity. Returns immediately with an id — poll GET /v1/resolve-parent/{job_id} until the status is completed. Use the kernel_id from a previous Resolve entity call.

Examples

Resolve the parent hierarchy for an entity

curl

curl -X POST https://api.kernel.ai/rest/v1/resolve-parent \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kernel_id": "6347422643"}'

Response (202)

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}

With webhook callback

curl

curl -X POST https://api.kernel.ai/rest/v1/resolve-parent \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kernel_id": "6347422643",
    "webhook_url": "https://example.com/webhooks/kernel"
  }'

Response (202)

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}

Request body

Field	Type	Required	Description
`kernel_id`	`string`	Yes	The `kernel_id` of a resolved entity
`webhook_url`	`string`	No	HTTPS URL to receive webhook callbacks when the job completes or fails

Polling for results

After receiving an id, poll Get resolve parent result with exponential backoff (start at 2 seconds, max 30 seconds).

Get resolve parent result — Poll for job status and results

Authorizations

x-api-key

string

header

required

Include your API key in the x-api-key header.

Body

application/json

The entity to resolve parent hierarchy for.

kernel_id

string

required

The kernel_id of a resolved entity.

Example:

"6347422643"

webhook_url

string<uri>

HTTPS URL to receive webhook callbacks when the job completes or fails. Kernel will POST the job result to this URL with an X-Kernel-Signature header for verification.

Pattern: ^https://

Example:

"https://example.com/webhooks/kernel"

Response

Job created

string

required

Unique identifier for the created job.

Example:

"550e8400-e29b-41d4-a716-446655440000"

status

enum<string>

required

Initial status of the job.

Available options:

processing

Get resolve parent resultReturns the status and result of a parent hierarchy resolution job. When `status` is `completed`, the `record` object contains the parent hierarchy data.

curl --request POST \
  --url https://api.kernel.ai/rest/v1/resolve-parent \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kernel_id": "6347422643"
}
'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}

{
  "error": "kernel_id is required"
}

{
  "message": "Forbidden"
}

{
  "error": "Rate limit exceeded. Retry after 60 seconds."
}

{
  "error": "Internal processing error."
}

Getting started

API reference

API keys & Webhooks

Resolve parent

Examples

Resolve the parent hierarchy for an entity

With webhook callback

Request body

Polling for results

Authorizations

Body

Response

​Examples

​Resolve the parent hierarchy for an entity

​With webhook callback

​Request body

​Polling for results

​Related endpoints

Authorizations

Body

Response

Examples

Resolve the parent hierarchy for an entity

With webhook callback

Request body

Polling for results

Related endpoints