Signal Templates

List all signal templates for your organization

Deprecated
GET
/v1/companies/signals/templates

Retrieve a paginated list of signal templates for your organization. Returns the latest active version of each template.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Query Parameters

limit?integer

Maximum number of templates to return

Range1 <= value <= 100
Default20
offset?integer

Number of templates to skip for pagination

Range0 <= value
Default0
includeDeleted?boolean

Include deleted templates in the response

Defaultfalse

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/companies/signals/templates"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",      "version": 0,      "organizationId": "string",      "name": "string",      "description": "string",      "question": "string",      "answerType": "open_text",      "outputSchema": {},      "weight": "important",      "qualificationCriteria": {},      "createdByUserId": "string",      "createdAt": "2019-08-24T14:15:22Z",      "deletedAt": "2019-08-24T14:15:22Z",      "source": "api"    }  ],  "total": 0,  "limit": 0,  "offset": 0,  "hasMore": true}

Create a signal template

Deprecated
POST
/v1/companies/signals/templates

Create a reusable signal template that can be referenced when creating signals. Templates allow you to define standard research questions that can be applied to multiple companies.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

User-friendly name for the template

Length1 <= length <= 200
description?string

Optional description of what this template does

Lengthlength <= 1000
question*string

The research question to ask about companies

Length1 <= length <= 2000
answerType?string

The expected format of the answer

Default"open_text"

Value in

  • "open_text"
  • "number"
  • "boolean"
  • "list"
  • "percentage"
  • "currency"
  • "url"
  • "contacts"
  • "contacts_generation"
  • "contact_posts"
  • "contact_engagements"
  • "json_schema"
outputSchema?

JSON Schema defining the expected output structure. Required when answerType is "json_schema". See CreateSignalRequest.outputSchema for full documentation.

weight?string

The importance/weight of the signal

Value in

  • "important"
  • "nice_to_have"
  • "not_important"
qualificationCriteria?

Qualification criteria mapping answer values based on answerType. Structure varies by answerType:

  • For percentage/number/currency: { ranges: [{ rangeStart, rangeEnd, answerQualification }] }
  • For boolean: { yes: "qualification", no: "qualification" }
  • For list: { choices: { key: { answerQualification, label } } }

Valid answerQualification values: disqualified, poor, neutral, good, excellent

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/companies/signals/templates" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "question": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",  "version": 0,  "organizationId": "string",  "name": "string",  "description": "string",  "question": "string",  "answerType": "open_text",  "outputSchema": {},  "weight": "important",  "qualificationCriteria": {},  "createdByUserId": "string",  "createdAt": "2019-08-24T14:15:22Z",  "deletedAt": "2019-08-24T14:15:22Z",  "source": "api"}

Get a signal template by ID

Deprecated
GET
/v1/companies/signals/templates/{templateId}

Retrieve a specific signal template by ID

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

templateId*string

The unique identifier of the template

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/companies/signals/templates/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",  "version": 0,  "organizationId": "string",  "name": "string",  "description": "string",  "question": "string",  "answerType": "open_text",  "outputSchema": {},  "weight": "important",  "qualificationCriteria": {},  "createdByUserId": "string",  "createdAt": "2019-08-24T14:15:22Z",  "deletedAt": "2019-08-24T14:15:22Z",  "source": "api"}

Update a signal template

Deprecated
PATCH
/v1/companies/signals/templates/{templateId}

Update a signal template using PATCH semantics (partial update). This creates a new version of the template and soft-deletes the previous version. Only provided fields will be updated; omitted fields will retain their values from the previous version.

The template ID remains the same across all versions. The version number will be incremented.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

templateId*string

The unique identifier of the template to update

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for updating a signal template using PATCH semantics. All fields are optional - only provide the fields you want to update. Omitted fields will retain their values from the previous template version.

name?string

User-friendly name for the template

Length1 <= length <= 200
description?string

Optional description of what this template does

Lengthlength <= 1000
question?string

The research question to ask about companies

Length1 <= length <= 2000
answerType?string

The expected format of the answer

Value in

  • "open_text"
  • "number"
  • "boolean"
  • "list"
  • "percentage"
  • "currency"
  • "url"
  • "contacts"
  • "contact_posts"
  • "contact_engagements"
  • "json_schema"
outputSchema?

JSON Schema defining the expected output structure. Required when answerType is "json_schema".

weight?string

The importance/weight of the signal

Value in

  • "important"
  • "nice_to_have"
  • "not_important"
qualificationCriteria?

Qualification criteria mapping answer values based on answerType

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/companies/signals/templates/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",  "version": 0,  "organizationId": "string",  "name": "string",  "description": "string",  "question": "string",  "answerType": "open_text",  "outputSchema": {},  "weight": "important",  "qualificationCriteria": {},  "createdByUserId": "string",  "createdAt": "2019-08-24T14:15:22Z",  "deletedAt": "2019-08-24T14:15:22Z",  "source": "api"}

Delete a signal template

Deprecated
DELETE
/v1/companies/signals/templates/{templateId}

Soft-delete a signal template. The template will be marked as deleted but preserved for historical tracking.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

templateId*string

The unique identifier of the template to delete

Formatuuid

Response Body

application/json

application/json

curl -X DELETE "https://example.com/v1/companies/signals/templates/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty

On this page

List all signal templates for your organizationCreate a signal templateGet a signal template by IDUpdate a signal templateDelete a signal template