Insights

Today: the task queue. Tasks from fixed rules (never the model), most severe and soonest first, for me, my groups, or the editors#

GET /v1/account/actions

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Query parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/actions" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Work a task: snooze it, mark it done, dismiss it with a note, reopen it, or assign it to a team member. Nothing contacts the lead#

PATCH /v1/account/actions/{actionId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PATCH "$ANSWERSTACK_API_URL/v1/account/actions/{actionId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "snooze"
}'

Correct one label of an analysis. The correction is kept, counted for the agreement rate and re-applied after every re-run; a caller type or judged objective re-runs the code pass#

POST /v1/account/analyses/{analysisId}/feedback

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 201

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/analyses/{analysisId}/feedback" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "dimension": "caller_type"
}'

Analyse one conversation again, model pass included (admins; counts against the daily budget)#

POST /v1/account/analyses/{analysisId}/rerun

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 202

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/analyses/{analysisId}/rerun" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

The visit brief for a booking: who is coming, the timeline and interests, objections and how they were answered, open commitments, engagement, and talking points quoted from the playbook (logs call.view)#

GET /v1/account/bookings/{bookingId}/brief

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/bookings/{bookingId}/brief" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

A conversation’s analysis: objective results with opportunity, attempts, miss reason and owner; craft and compliance checks; and, with Conversation Intelligence, labels with their evidence (reasons and the summary need transcript access)#

GET /v1/account/calls/{callId}/analysis

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/calls/{callId}/analysis" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Commitments made to leads: callbacks, answers to confirm, information to send. Descriptions need transcript access#

GET /v1/account/commitments

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Query parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/commitments" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Close a commitment (done or dismissed), reopen it, give it an owner or a new due time#

PATCH /v1/account/commitments/{commitmentId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PATCH "$ANSWERSTACK_API_URL/v1/account/commitments/{commitmentId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "done"
}'

Ask Stack a question about the account setup or, with Insights Ask, its conversations. The answer streams back as server-sent events: context, tool…, text…, block…, done (with the stored message and thread), or error#

POST /v1/account/insights/ask

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 200

No content.

Errors: 400, 401, 402, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/insights/ask" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "question": "string"
}'

Rate one of your Stack answers as helpful or not, with an optional note: staff read these to make Stack better (ADR 0173)#

POST /v1/account/insights/ask/messages/{messageId}/feedback

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 204

No content.

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/insights/ask/messages/{messageId}/feedback" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "rating": "up"
}'

Count that you opened a link under one of your Stack answers (ADR 0173)#

POST /v1/account/insights/ask/messages/{messageId}/opened

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 204

No content.

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/insights/ask/messages/{messageId}/opened" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Your Ask threads, most recently used first; saved=true for your saved questions#

GET /v1/account/insights/ask/threads

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Query parameters

Response 200

Errors: 400, 401, 402, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/insights/ask/threads" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

One of your Ask threads with its questions and answers#

GET /v1/account/insights/ask/threads/{threadId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 200

Errors: 400, 401, 402, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/insights/ask/threads/{threadId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Delete one of your Ask threads and its answers#

DELETE /v1/account/insights/ask/threads/{threadId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 204

No content.

Errors: 400, 401, 402, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X DELETE "$ANSWERSTACK_API_URL/v1/account/insights/ask/threads/{threadId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Re-run a thread with edited context chips, without the model: the same tools, checks and blocks#

POST /v1/account/insights/ask/threads/{threadId}/rerun

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 402, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/insights/ask/threads/{threadId}/rerun" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "context": {
    "callId": "string",
    "callerType": "string",
    "channel": "phone",
    "comparePeriod": "previous",
    "competitor": "string",
    "flow": "objective",
    "ids": [],
    "level": "account",
    "measure": "rate",
    "metric": "target_attainment",
    "objective": "book_meeting",
    "period": {
      "kind": "last_days",
      "n": 30
    },
    "rank": "group",
    "source": "number",
    "topic": "string",
    "view": "scorecard"
  }
}'

Save a thread as a saved question (or unsave it), rename it, or put it in your weekly digest#

POST /v1/account/insights/ask/threads/{threadId}/save

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.