Add a signal definition version
curl --request POST \
--url https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"body": {
"name": "Exhibits at a trade fair",
"description": "The company exhibits at a trade fair in its industry.",
"humanExplanation": "An exhibitor is investing in finding new customers this year.",
"observableCondition": "The company is on the fair’s published exhibitor list.",
"examples": [
"Listed as an exhibitor at the fair this year"
],
"counterexamples": [
"Only a visitor badge was mentioned"
],
"evidenceRequirements": {
"permittedSourceKinds": [
"controlled_directory"
],
"requireLocatedSupport": true,
"requireEntityAttribution": true,
"claimSupport": {
"requiredAssertion": "affirmed",
"permittedModalities": [
"factual"
]
},
"temporal": {
"semantics": "condition_observed",
"minimumPrecision": "year",
"windowDays": 365,
"allowPlannedFuture": true
},
"coverage": {
"negativeEvidence": "requires_certified_complete_scope"
}
},
"detector": {
"kind": "directory_listing",
"config": {
"sourceRole": "exhibitor_list",
"editionLabel": "2026"
}
},
"subjectType": "company",
"temporalRule": {
"semantics": "condition_observed",
"windowDays": 365,
"minimumPrecision": "year",
"allowPlannedFuture": true
}
},
"expectedRevision": 4
}
'import requests
url = "https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions"
payload = {
"body": {
"name": "Exhibits at a trade fair",
"description": "The company exhibits at a trade fair in its industry.",
"humanExplanation": "An exhibitor is investing in finding new customers this year.",
"observableCondition": "The company is on the fair’s published exhibitor list.",
"examples": ["Listed as an exhibitor at the fair this year"],
"counterexamples": ["Only a visitor badge was mentioned"],
"evidenceRequirements": {
"permittedSourceKinds": ["controlled_directory"],
"requireLocatedSupport": True,
"requireEntityAttribution": True,
"claimSupport": {
"requiredAssertion": "affirmed",
"permittedModalities": ["factual"]
},
"temporal": {
"semantics": "condition_observed",
"minimumPrecision": "year",
"windowDays": 365,
"allowPlannedFuture": True
},
"coverage": { "negativeEvidence": "requires_certified_complete_scope" }
},
"detector": {
"kind": "directory_listing",
"config": {
"sourceRole": "exhibitor_list",
"editionLabel": "2026"
}
},
"subjectType": "company",
"temporalRule": {
"semantics": "condition_observed",
"windowDays": 365,
"minimumPrecision": "year",
"allowPlannedFuture": True
}
},
"expectedRevision": 4
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
body: JSON.stringify({
name: 'Exhibits at a trade fair',
description: 'The company exhibits at a trade fair in its industry.',
humanExplanation: 'An exhibitor is investing in finding new customers this year.',
observableCondition: 'The company is on the fair’s published exhibitor list.',
examples: ['Listed as an exhibitor at the fair this year'],
counterexamples: ['Only a visitor badge was mentioned'],
evidenceRequirements: {
permittedSourceKinds: ['controlled_directory'],
requireLocatedSupport: true,
requireEntityAttribution: true,
claimSupport: {requiredAssertion: 'affirmed', permittedModalities: ['factual']},
temporal: {
semantics: 'condition_observed',
minimumPrecision: 'year',
windowDays: 365,
allowPlannedFuture: true
},
coverage: {negativeEvidence: 'requires_certified_complete_scope'}
},
detector: {
kind: 'directory_listing',
config: {sourceRole: 'exhibitor_list', editionLabel: '2026'}
},
subjectType: 'company',
temporalRule: {
semantics: 'condition_observed',
windowDays: 365,
minimumPrecision: 'year',
allowPlannedFuture: true
}
}),
expectedRevision: 4
})
};
fetch('https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'body' => [
'name' => 'Exhibits at a trade fair',
'description' => 'The company exhibits at a trade fair in its industry.',
'humanExplanation' => 'An exhibitor is investing in finding new customers this year.',
'observableCondition' => 'The company is on the fair’s published exhibitor list.',
'examples' => [
'Listed as an exhibitor at the fair this year'
],
'counterexamples' => [
'Only a visitor badge was mentioned'
],
'evidenceRequirements' => [
'permittedSourceKinds' => [
'controlled_directory'
],
'requireLocatedSupport' => true,
'requireEntityAttribution' => true,
'claimSupport' => [
'requiredAssertion' => 'affirmed',
'permittedModalities' => [
'factual'
]
],
'temporal' => [
'semantics' => 'condition_observed',
'minimumPrecision' => 'year',
'windowDays' => 365,
'allowPlannedFuture' => true
],
'coverage' => [
'negativeEvidence' => 'requires_certified_complete_scope'
]
],
'detector' => [
'kind' => 'directory_listing',
'config' => [
'sourceRole' => 'exhibitor_list',
'editionLabel' => '2026'
]
],
'subjectType' => 'company',
'temporalRule' => [
'semantics' => 'condition_observed',
'windowDays' => 365,
'minimumPrecision' => 'year',
'allowPlannedFuture' => true
]
],
'expectedRevision' => 4
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions"
payload := strings.NewReader("{\n \"body\": {\n \"name\": \"Exhibits at a trade fair\",\n \"description\": \"The company exhibits at a trade fair in its industry.\",\n \"humanExplanation\": \"An exhibitor is investing in finding new customers this year.\",\n \"observableCondition\": \"The company is on the fair’s published exhibitor list.\",\n \"examples\": [\n \"Listed as an exhibitor at the fair this year\"\n ],\n \"counterexamples\": [\n \"Only a visitor badge was mentioned\"\n ],\n \"evidenceRequirements\": {\n \"permittedSourceKinds\": [\n \"controlled_directory\"\n ],\n \"requireLocatedSupport\": true,\n \"requireEntityAttribution\": true,\n \"claimSupport\": {\n \"requiredAssertion\": \"affirmed\",\n \"permittedModalities\": [\n \"factual\"\n ]\n },\n \"temporal\": {\n \"semantics\": \"condition_observed\",\n \"minimumPrecision\": \"year\",\n \"windowDays\": 365,\n \"allowPlannedFuture\": true\n },\n \"coverage\": {\n \"negativeEvidence\": \"requires_certified_complete_scope\"\n }\n },\n \"detector\": {\n \"kind\": \"directory_listing\",\n \"config\": {\n \"sourceRole\": \"exhibitor_list\",\n \"editionLabel\": \"2026\"\n }\n },\n \"subjectType\": \"company\",\n \"temporalRule\": {\n \"semantics\": \"condition_observed\",\n \"windowDays\": 365,\n \"minimumPrecision\": \"year\",\n \"allowPlannedFuture\": true\n }\n },\n \"expectedRevision\": 4\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"body\": {\n \"name\": \"Exhibits at a trade fair\",\n \"description\": \"The company exhibits at a trade fair in its industry.\",\n \"humanExplanation\": \"An exhibitor is investing in finding new customers this year.\",\n \"observableCondition\": \"The company is on the fair’s published exhibitor list.\",\n \"examples\": [\n \"Listed as an exhibitor at the fair this year\"\n ],\n \"counterexamples\": [\n \"Only a visitor badge was mentioned\"\n ],\n \"evidenceRequirements\": {\n \"permittedSourceKinds\": [\n \"controlled_directory\"\n ],\n \"requireLocatedSupport\": true,\n \"requireEntityAttribution\": true,\n \"claimSupport\": {\n \"requiredAssertion\": \"affirmed\",\n \"permittedModalities\": [\n \"factual\"\n ]\n },\n \"temporal\": {\n \"semantics\": \"condition_observed\",\n \"minimumPrecision\": \"year\",\n \"windowDays\": 365,\n \"allowPlannedFuture\": true\n },\n \"coverage\": {\n \"negativeEvidence\": \"requires_certified_complete_scope\"\n }\n },\n \"detector\": {\n \"kind\": \"directory_listing\",\n \"config\": {\n \"sourceRole\": \"exhibitor_list\",\n \"editionLabel\": \"2026\"\n }\n },\n \"subjectType\": \"company\",\n \"temporalRule\": {\n \"semantics\": \"condition_observed\",\n \"windowDays\": 365,\n \"minimumPrecision\": \"year\",\n \"allowPlannedFuture\": true\n }\n },\n \"expectedRevision\": 4\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"body\": {\n \"name\": \"Exhibits at a trade fair\",\n \"description\": \"The company exhibits at a trade fair in its industry.\",\n \"humanExplanation\": \"An exhibitor is investing in finding new customers this year.\",\n \"observableCondition\": \"The company is on the fair’s published exhibitor list.\",\n \"examples\": [\n \"Listed as an exhibitor at the fair this year\"\n ],\n \"counterexamples\": [\n \"Only a visitor badge was mentioned\"\n ],\n \"evidenceRequirements\": {\n \"permittedSourceKinds\": [\n \"controlled_directory\"\n ],\n \"requireLocatedSupport\": true,\n \"requireEntityAttribution\": true,\n \"claimSupport\": {\n \"requiredAssertion\": \"affirmed\",\n \"permittedModalities\": [\n \"factual\"\n ]\n },\n \"temporal\": {\n \"semantics\": \"condition_observed\",\n \"minimumPrecision\": \"year\",\n \"windowDays\": 365,\n \"allowPlannedFuture\": true\n },\n \"coverage\": {\n \"negativeEvidence\": \"requires_certified_complete_scope\"\n }\n },\n \"detector\": {\n \"kind\": \"directory_listing\",\n \"config\": {\n \"sourceRole\": \"exhibitor_list\",\n \"editionLabel\": \"2026\"\n }\n },\n \"subjectType\": \"company\",\n \"temporalRule\": {\n \"semantics\": \"condition_observed\",\n \"windowDays\": 365,\n \"minimumPrecision\": \"year\",\n \"allowPlannedFuture\": true\n }\n },\n \"expectedRevision\": 4\n}"
response = http.request(request)
puts response.read_body{
"id": "0199a1b2-0000-7000-8000-00000000f211",
"signalDefinitionId": "0199a1b2-0000-7000-8000-00000000f201",
"versionNumber": 2,
"body": {
"name": "Exhibits at a trade fair",
"description": "The company exhibits at a trade fair in its industry.",
"humanExplanation": "An exhibitor is investing in finding new customers this year.",
"observableCondition": "The company is on the fair’s published exhibitor list.",
"examples": [
"Listed as an exhibitor at the fair this year"
],
"counterexamples": [
"Only a visitor badge was mentioned"
],
"evidenceRequirements": {
"permittedSourceKinds": [
"controlled_directory"
],
"requireLocatedSupport": true,
"requireEntityAttribution": true,
"claimSupport": {
"requiredAssertion": "affirmed",
"permittedModalities": [
"factual"
]
},
"temporal": {
"semantics": "condition_observed",
"minimumPrecision": "year",
"windowDays": 365,
"allowPlannedFuture": true
},
"coverage": {
"negativeEvidence": "requires_certified_complete_scope"
}
},
"detector": {
"kind": "directory_listing",
"config": {
"sourceRole": "exhibitor_list",
"editionLabel": "2026"
}
},
"subjectType": "company",
"temporalRule": {
"semantics": "condition_observed",
"windowDays": 365,
"minimumPrecision": "year",
"allowPlannedFuture": true
}
},
"detectorKind": "directory_listing",
"schemaVersion": 1,
"detectorContractVersion": 1,
"contentFingerprint": "sha256:4e1a9c07",
"publicationStatus": "draft",
"firstPublishedAt": null,
"publishedAt": null,
"retiredAt": null,
"createdBy": "0199a1b2-0000-7000-8000-00000000c001",
"createdAt": "2026-09-10T08:00:00.000Z",
"revision": 5
}{
"error": {
"code": "malformed_json",
"message": "Bad Request",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unauthenticated",
"message": "Unauthorized",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "insufficient_scope",
"message": "Forbidden",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "not_found",
"message": "Not Found",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "conflict",
"message": "Conflict",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "payload_too_large",
"message": "Payload Too Large",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unsupported_media_type",
"message": "Unsupported Media Type",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "validation_error",
"message": "Unprocessable Entity",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "service_unavailable",
"message": "Service Unavailable",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "not_found",
"message": "Not found",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}signalDefinitions
Add a signal definition version
Appends an immutable draft version and answers it with the definition’s new revision. It is not published. Name the revision you were shown: a stale one is 409 stale_version and writes nothing. The change commits only after this answer is checked; a retry with the same Idempotency-Key replays it.
POST
/
v1
/
signal-definitions
/
{signalDefinitionId}
/
versions
Add a signal definition version
curl --request POST \
--url https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"body": {
"name": "Exhibits at a trade fair",
"description": "The company exhibits at a trade fair in its industry.",
"humanExplanation": "An exhibitor is investing in finding new customers this year.",
"observableCondition": "The company is on the fair’s published exhibitor list.",
"examples": [
"Listed as an exhibitor at the fair this year"
],
"counterexamples": [
"Only a visitor badge was mentioned"
],
"evidenceRequirements": {
"permittedSourceKinds": [
"controlled_directory"
],
"requireLocatedSupport": true,
"requireEntityAttribution": true,
"claimSupport": {
"requiredAssertion": "affirmed",
"permittedModalities": [
"factual"
]
},
"temporal": {
"semantics": "condition_observed",
"minimumPrecision": "year",
"windowDays": 365,
"allowPlannedFuture": true
},
"coverage": {
"negativeEvidence": "requires_certified_complete_scope"
}
},
"detector": {
"kind": "directory_listing",
"config": {
"sourceRole": "exhibitor_list",
"editionLabel": "2026"
}
},
"subjectType": "company",
"temporalRule": {
"semantics": "condition_observed",
"windowDays": 365,
"minimumPrecision": "year",
"allowPlannedFuture": true
}
},
"expectedRevision": 4
}
'import requests
url = "https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions"
payload = {
"body": {
"name": "Exhibits at a trade fair",
"description": "The company exhibits at a trade fair in its industry.",
"humanExplanation": "An exhibitor is investing in finding new customers this year.",
"observableCondition": "The company is on the fair’s published exhibitor list.",
"examples": ["Listed as an exhibitor at the fair this year"],
"counterexamples": ["Only a visitor badge was mentioned"],
"evidenceRequirements": {
"permittedSourceKinds": ["controlled_directory"],
"requireLocatedSupport": True,
"requireEntityAttribution": True,
"claimSupport": {
"requiredAssertion": "affirmed",
"permittedModalities": ["factual"]
},
"temporal": {
"semantics": "condition_observed",
"minimumPrecision": "year",
"windowDays": 365,
"allowPlannedFuture": True
},
"coverage": { "negativeEvidence": "requires_certified_complete_scope" }
},
"detector": {
"kind": "directory_listing",
"config": {
"sourceRole": "exhibitor_list",
"editionLabel": "2026"
}
},
"subjectType": "company",
"temporalRule": {
"semantics": "condition_observed",
"windowDays": 365,
"minimumPrecision": "year",
"allowPlannedFuture": True
}
},
"expectedRevision": 4
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
body: JSON.stringify({
name: 'Exhibits at a trade fair',
description: 'The company exhibits at a trade fair in its industry.',
humanExplanation: 'An exhibitor is investing in finding new customers this year.',
observableCondition: 'The company is on the fair’s published exhibitor list.',
examples: ['Listed as an exhibitor at the fair this year'],
counterexamples: ['Only a visitor badge was mentioned'],
evidenceRequirements: {
permittedSourceKinds: ['controlled_directory'],
requireLocatedSupport: true,
requireEntityAttribution: true,
claimSupport: {requiredAssertion: 'affirmed', permittedModalities: ['factual']},
temporal: {
semantics: 'condition_observed',
minimumPrecision: 'year',
windowDays: 365,
allowPlannedFuture: true
},
coverage: {negativeEvidence: 'requires_certified_complete_scope'}
},
detector: {
kind: 'directory_listing',
config: {sourceRole: 'exhibitor_list', editionLabel: '2026'}
},
subjectType: 'company',
temporalRule: {
semantics: 'condition_observed',
windowDays: 365,
minimumPrecision: 'year',
allowPlannedFuture: true
}
}),
expectedRevision: 4
})
};
fetch('https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'body' => [
'name' => 'Exhibits at a trade fair',
'description' => 'The company exhibits at a trade fair in its industry.',
'humanExplanation' => 'An exhibitor is investing in finding new customers this year.',
'observableCondition' => 'The company is on the fair’s published exhibitor list.',
'examples' => [
'Listed as an exhibitor at the fair this year'
],
'counterexamples' => [
'Only a visitor badge was mentioned'
],
'evidenceRequirements' => [
'permittedSourceKinds' => [
'controlled_directory'
],
'requireLocatedSupport' => true,
'requireEntityAttribution' => true,
'claimSupport' => [
'requiredAssertion' => 'affirmed',
'permittedModalities' => [
'factual'
]
],
'temporal' => [
'semantics' => 'condition_observed',
'minimumPrecision' => 'year',
'windowDays' => 365,
'allowPlannedFuture' => true
],
'coverage' => [
'negativeEvidence' => 'requires_certified_complete_scope'
]
],
'detector' => [
'kind' => 'directory_listing',
'config' => [
'sourceRole' => 'exhibitor_list',
'editionLabel' => '2026'
]
],
'subjectType' => 'company',
'temporalRule' => [
'semantics' => 'condition_observed',
'windowDays' => 365,
'minimumPrecision' => 'year',
'allowPlannedFuture' => true
]
],
'expectedRevision' => 4
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions"
payload := strings.NewReader("{\n \"body\": {\n \"name\": \"Exhibits at a trade fair\",\n \"description\": \"The company exhibits at a trade fair in its industry.\",\n \"humanExplanation\": \"An exhibitor is investing in finding new customers this year.\",\n \"observableCondition\": \"The company is on the fair’s published exhibitor list.\",\n \"examples\": [\n \"Listed as an exhibitor at the fair this year\"\n ],\n \"counterexamples\": [\n \"Only a visitor badge was mentioned\"\n ],\n \"evidenceRequirements\": {\n \"permittedSourceKinds\": [\n \"controlled_directory\"\n ],\n \"requireLocatedSupport\": true,\n \"requireEntityAttribution\": true,\n \"claimSupport\": {\n \"requiredAssertion\": \"affirmed\",\n \"permittedModalities\": [\n \"factual\"\n ]\n },\n \"temporal\": {\n \"semantics\": \"condition_observed\",\n \"minimumPrecision\": \"year\",\n \"windowDays\": 365,\n \"allowPlannedFuture\": true\n },\n \"coverage\": {\n \"negativeEvidence\": \"requires_certified_complete_scope\"\n }\n },\n \"detector\": {\n \"kind\": \"directory_listing\",\n \"config\": {\n \"sourceRole\": \"exhibitor_list\",\n \"editionLabel\": \"2026\"\n }\n },\n \"subjectType\": \"company\",\n \"temporalRule\": {\n \"semantics\": \"condition_observed\",\n \"windowDays\": 365,\n \"minimumPrecision\": \"year\",\n \"allowPlannedFuture\": true\n }\n },\n \"expectedRevision\": 4\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"body\": {\n \"name\": \"Exhibits at a trade fair\",\n \"description\": \"The company exhibits at a trade fair in its industry.\",\n \"humanExplanation\": \"An exhibitor is investing in finding new customers this year.\",\n \"observableCondition\": \"The company is on the fair’s published exhibitor list.\",\n \"examples\": [\n \"Listed as an exhibitor at the fair this year\"\n ],\n \"counterexamples\": [\n \"Only a visitor badge was mentioned\"\n ],\n \"evidenceRequirements\": {\n \"permittedSourceKinds\": [\n \"controlled_directory\"\n ],\n \"requireLocatedSupport\": true,\n \"requireEntityAttribution\": true,\n \"claimSupport\": {\n \"requiredAssertion\": \"affirmed\",\n \"permittedModalities\": [\n \"factual\"\n ]\n },\n \"temporal\": {\n \"semantics\": \"condition_observed\",\n \"minimumPrecision\": \"year\",\n \"windowDays\": 365,\n \"allowPlannedFuture\": true\n },\n \"coverage\": {\n \"negativeEvidence\": \"requires_certified_complete_scope\"\n }\n },\n \"detector\": {\n \"kind\": \"directory_listing\",\n \"config\": {\n \"sourceRole\": \"exhibitor_list\",\n \"editionLabel\": \"2026\"\n }\n },\n \"subjectType\": \"company\",\n \"temporalRule\": {\n \"semantics\": \"condition_observed\",\n \"windowDays\": 365,\n \"minimumPrecision\": \"year\",\n \"allowPlannedFuture\": true\n }\n },\n \"expectedRevision\": 4\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enrik.ai/v1/signal-definitions/{signalDefinitionId}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"body\": {\n \"name\": \"Exhibits at a trade fair\",\n \"description\": \"The company exhibits at a trade fair in its industry.\",\n \"humanExplanation\": \"An exhibitor is investing in finding new customers this year.\",\n \"observableCondition\": \"The company is on the fair’s published exhibitor list.\",\n \"examples\": [\n \"Listed as an exhibitor at the fair this year\"\n ],\n \"counterexamples\": [\n \"Only a visitor badge was mentioned\"\n ],\n \"evidenceRequirements\": {\n \"permittedSourceKinds\": [\n \"controlled_directory\"\n ],\n \"requireLocatedSupport\": true,\n \"requireEntityAttribution\": true,\n \"claimSupport\": {\n \"requiredAssertion\": \"affirmed\",\n \"permittedModalities\": [\n \"factual\"\n ]\n },\n \"temporal\": {\n \"semantics\": \"condition_observed\",\n \"minimumPrecision\": \"year\",\n \"windowDays\": 365,\n \"allowPlannedFuture\": true\n },\n \"coverage\": {\n \"negativeEvidence\": \"requires_certified_complete_scope\"\n }\n },\n \"detector\": {\n \"kind\": \"directory_listing\",\n \"config\": {\n \"sourceRole\": \"exhibitor_list\",\n \"editionLabel\": \"2026\"\n }\n },\n \"subjectType\": \"company\",\n \"temporalRule\": {\n \"semantics\": \"condition_observed\",\n \"windowDays\": 365,\n \"minimumPrecision\": \"year\",\n \"allowPlannedFuture\": true\n }\n },\n \"expectedRevision\": 4\n}"
response = http.request(request)
puts response.read_body{
"id": "0199a1b2-0000-7000-8000-00000000f211",
"signalDefinitionId": "0199a1b2-0000-7000-8000-00000000f201",
"versionNumber": 2,
"body": {
"name": "Exhibits at a trade fair",
"description": "The company exhibits at a trade fair in its industry.",
"humanExplanation": "An exhibitor is investing in finding new customers this year.",
"observableCondition": "The company is on the fair’s published exhibitor list.",
"examples": [
"Listed as an exhibitor at the fair this year"
],
"counterexamples": [
"Only a visitor badge was mentioned"
],
"evidenceRequirements": {
"permittedSourceKinds": [
"controlled_directory"
],
"requireLocatedSupport": true,
"requireEntityAttribution": true,
"claimSupport": {
"requiredAssertion": "affirmed",
"permittedModalities": [
"factual"
]
},
"temporal": {
"semantics": "condition_observed",
"minimumPrecision": "year",
"windowDays": 365,
"allowPlannedFuture": true
},
"coverage": {
"negativeEvidence": "requires_certified_complete_scope"
}
},
"detector": {
"kind": "directory_listing",
"config": {
"sourceRole": "exhibitor_list",
"editionLabel": "2026"
}
},
"subjectType": "company",
"temporalRule": {
"semantics": "condition_observed",
"windowDays": 365,
"minimumPrecision": "year",
"allowPlannedFuture": true
}
},
"detectorKind": "directory_listing",
"schemaVersion": 1,
"detectorContractVersion": 1,
"contentFingerprint": "sha256:4e1a9c07",
"publicationStatus": "draft",
"firstPublishedAt": null,
"publishedAt": null,
"retiredAt": null,
"createdBy": "0199a1b2-0000-7000-8000-00000000c001",
"createdAt": "2026-09-10T08:00:00.000Z",
"revision": 5
}{
"error": {
"code": "malformed_json",
"message": "Bad Request",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unauthenticated",
"message": "Unauthorized",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "insufficient_scope",
"message": "Forbidden",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "not_found",
"message": "Not Found",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "conflict",
"message": "Conflict",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "payload_too_large",
"message": "Payload Too Large",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unsupported_media_type",
"message": "Unsupported Media Type",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "validation_error",
"message": "Unprocessable Entity",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "service_unavailable",
"message": "Service Unavailable",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "not_found",
"message": "Not found",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}Authorizations
An Enrik API key, sent as Authorization: Bearer <key>. A key reaches public operations only, and only those whose scopes it holds. A few parameters need a scope beyond their operation’s, which the parameter names. The scopes:
setup:read: Read the workspace setup and its company profile.setup:run: Change the setup: confirm the company profile, authorize sponsored drafting and background company research, choose what to set up and complete setup.workspace:read: Read the workspace’s own profile: its health summary and setup state.crm:read: Read companies with their signals, contacts and the saved views over them.crm:write: Create, update and restore companies and contacts, and create, update and delete saved views.crm:delete: Delete companies and contacts.twin:read: Read the Company Twin: structured company knowledge and its signals.discovery:read: Read ICP profiles, ICP assessments, discovery briefs, discovery jobs, candidates and the signal library.discovery:write: Create and change ICP profiles, discovery briefs and signal-definition drafts, and review discovery candidates.discovery:run: Create, start and cancel discovery jobs, and edit a draft one. Uses provider budget.enrichment:read: Read the enrichment configuration and its results, including a record’s enrichment, formula and custom-API cells.enrichment:run: Launch and cancel enrichment. Spends enrichment credits.automation:read: Read workflows and agents with their run history, including a record’s agent cells.automation:run: Run existing workflows and agents.exports:read: Read export jobs and the fields an export can carry.exports:run: Create, preview, start, cancel and archive CSV exports of companies, contacts and candidates, and download the file. Also needscrm:read. Delivering an export to a webhook destination stays in the app.integrations:read: Read connections, field mappings, CRM sync jobs and webhook destinations.webhooks:read: Read webhook subscriptions, the event types they can name and their delivery log.webhooks:write: Subscribe a receiver URL to webhook events; edit, test, pause, resume and archive a subscription and rotate its signing secret; redeliver an event. Only workspace owners and admins can grant it.reporting:read: Read analytics and dashboards.assistant:read: Read the Assistant: its threads, messages and pending approvals.assistant:run: Converse with the Assistant. Uses the workspace’s AI quota.assistant:write: Approve or reject the changes the Assistant proposes.
Headers
A key you choose for this request, such as a UUID. Retrying with the same key returns the first result instead of doing the work twice.
Required string length:
1 - 200Path Parameters
The signal definition’s id.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$Body
application/json
Response
A newly appended signal definition version and the definition’s new revision.
A newly appended signal definition version and the definition’s new revision.
The version’s id.
The signal definition the version belongs to.
The version’s number, from 1, in the order they were made.
Required range:
-9007199254740991 <= x <= 9007199254740991What the version says. A version never changes.
Show child attributes
Show child attributes
The kind of detector the version uses.
Available options:
directory_listing, page_extract_llm, stored_context_llm The version of the definition format.
Required range:
-9007199254740991 <= x <= 9007199254740991The version of the detector contract it was made for.
Required range:
-9007199254740991 <= x <= 9007199254740991A fingerprint of the body, equal for equal bodies.
draft, published, or retired (never published again).
Available options:
draft, published, retired When the version was first published; null if never.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$When the version was last published; null if never.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$When the version was retired; null if not.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$The user who made the version; null when no user did.
When the version was made.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$The definition’s revision after this append; send it with the next command.
Required range:
-9007199254740991 <= x <= 9007199254740991Was this page helpful?