Skip to main content
POST
/
v1
/
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"
}
'
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}
Starts a parent hierarchy resolution job for a resolved entity. Returns immediately with a job ID — poll GET /v1/resolve-parent/{job_id} until the status is completed. Use the kernel_id from a previous Resolve entity or Lookup 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)
{
  "jobId": "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)
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}

​
Request body

FieldTypeRequiredDescription
kernel_idstringYesThe kernel_id of a resolved entity
webhook_urlstringNoHTTPS URL to receive webhook callbacks when the job completes or fails

​
Polling for results

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

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

​
jobId
string
required

Unique identifier for the created job.

Example:

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

​
status
enum<string>

Initial status of the job.

Available options:
processing