Skip to main content
POST
/
api
/
public
/
v1
/
slices
/
{key}
/
run
Run a slice
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)
{
  "data": {
    "runId": 12345,
    "sliceKey": "high_intent_deals",
    "sliceTitle": "High-Intent Deals",
    "status": "running"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.oneperfectslice.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Response

Run accepted (async execution started)

​
data
object
required