Run a slice

Starts an asynchronous AI analysis run for the given slice. Returns 202 Accepted with a runId you can use to poll for results via GET /slice-runs/.

Pass an Idempotency-Key header to safely retry — same key with same arguments returns the original run, same key with different arguments returns 409.

Related: Get run details · Get run evidence · List runs

POST /api/public/v1/slices/{key}/run

Run a slice

Python

import requests

url = "https://app.oneperfectslice.ai/api/public/v1/slices/{key}/run"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

202

Example

{
  "data": {
    "runId": 12345,
    "sliceKey": "high_intent_deals",
    "sliceTitle": "High-Intent Deals",
    "status": "running"
  }
}

Runs are asynchronous. After starting a run, poll Get run details using the returned runId. Check suggestedPollAfterSeconds for the recommended wait time between polls.

Authorizations

Authorization · string · header · default: sk_your_api_key · required

API key with sk_ prefix. Create one in Org Settings → API Keys.

Headers

Idempotency-Key · string

Client-provided idempotency key (Stripe convention). Same key + same args returns original runId. Same key + different args returns 409.

Maximum string length: 255

Path Parameters

key · string · required

Unique slice key

Body

application/json

Filters and options for starting a slice run. All fields are optional — omit filters to analyze all recent calls.

dateFrom · string<date-time>

Start datetime (ISO-8601)

Example:

"2026-03-26T00:00:00Z"

dateTo · string<date-time>

End datetime (ISO-8601)

Example:

"2026-04-26T00:00:00Z"

callTypes · string[]

Filter by call types

Maximum array length: 100

sourceIds · string[]

Filter by source file IDs

Maximum array length: 100

userPrompt · string

Optional user prompt to customize analysis

callOwnerEmails · string[]

Filter by call owner emails

Maximum array length: 100

companyDomains · string[]

Filter by company domains

Maximum array length: 100

crmDealIds · integer<int64>[]

Filter by CRM deal IDs

Maximum array length: 100

crmCompanyIds · integer<int64>[]

Filter by CRM company IDs

Maximum array length: 100

crmDealStages · string[]

Filter by CRM deal stages

Maximum array length: 100

Example:

["Qualification", "Proposal"]

crmAmountMin · number

Minimum CRM deal amount

crmAmountMax · number

Maximum CRM deal amount

crmCustomFieldFilters · object[]

Custom CRM field filters

Show child attributes

Response

202

application/json

Run accepted (async execution started)

data · object · required

Show child attributes