Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.signalark.app/llms.txt

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

Signal Ark’s AI learns from the feedback you submit. When a signal is miscategorized, assigned the wrong ICP score, or is particularly valuable, use POST /v1/signals/feedback to register that judgment. Feedback is used to continuously improve classification accuracy and scoring relevance for your specific workspace. Endpoint: POST https://www.signalark.app/_api/v1/signals/feedback Authentication: Authorization: Bearer sak_your_api_key_here

​
When to submit feedback

Submit feedback when:
  • A signal was promoted but is clearly not relevant to your ICP.
  • A signal was filtered out but represents a genuine buying intent.
  • The AI-generated “Why Now” summary or outreach angles are inaccurate or unhelpful.
  • A signal source is consistently producing noise or high-quality results.
Feedback is scoped to your workspace. Submitting feedback does not affect other Signal Ark customers’ models. The more feedback you submit, the more precisely Signal Ark’s scoring adapts to your specific ICP and sales motion.

​
Request body

​
signal_id
string
required
The unique identifier of the signal you are submitting feedback on. Find this in the Signal Ark UI on any signal detail view, or from the signal.id field in webhook payloads.
​
rating
string
required
Your assessment of the signal’s relevance. Must be one of:
  • relevant — The signal correctly identified a high-intent buying situation.
  • not_relevant — The signal should not have been surfaced for your ICP.
  • highly_relevant — The signal was exceptionally valuable and led to a meaningful sales outcome.
​
reason
string
A brief explanation of your rating. While optional, specific reasons (for example, “company is a competitor, not a prospect” or “this contact is already a customer”) help the AI improve faster. Aim for one or two sentences.
​
feedback_type
string
The dimension of the signal you are rating. Defaults to overall if omitted. Accepted values:
  • overall — General relevance of the signal.
  • icp_score — Accuracy of the ICP score assigned to the account.
  • why_now — Quality and accuracy of the AI-generated “Why Now” summary.
  • source_quality — Reliability or signal-to-noise ratio of the signal source.

​
Example request

curl -X POST https://www.signalark.app/_api/v1/signals/feedback \
  -H "Authorization: Bearer sak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "signal_id": "sig_01HZ9XYZ123",
    "rating": "not_relevant",
    "reason": "This company is a direct competitor, not a prospect. We should not be tracking their funding rounds.",
    "feedback_type": "overall"
  }'

​
Response

​
success
boolean
true when the feedback was received and queued for processing.
​
feedbackId
string
A unique identifier for this feedback submission.
​
message
string
A human-readable confirmation message.

​
Example response

{
  "success": true,
  "feedbackId": "fb_01HZ9KLMNO",
  "message": "Feedback received. Thank you — this will be used to improve signal scoring for your workspace."
}

​
Feedback error responses

StatusCauseResolution
400 Bad Requestsignal_id is missing or rating is not a recognized value.Check the request body against the field definitions above.
404 Not FoundThe signal_id does not exist in your workspace.Confirm the signal ID from the Signal Ark UI or a webhook payload.
401 UnauthorizedAPI key is missing or malformed.See Authentication.