Skip to main content
PATCH
/
scorecards
/
{id}
Update Scorecard
curl --request PATCH \
  --url https://api.attention.tech/v2/scorecards/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Sales Discovery Scorecard (v2)",
  "enabled": false
}
'
{
  "data": {
    "id": "sc-uuid-123",
    "title": "Sales Discovery Scorecard",
    "organizationId": "org-uuid-456",
    "allTeams": true,
    "enabled": true,
    "interactionType": "conversation",
    "expertMode": false,
    "isDefaultTemplate": false,
    "createdAt": "2026-04-16T10:15:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.attention.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

Scorecard UUID

Body

Fields to update. All fields are optional; at least one must be provided.

Partial update payload for a scorecard. All fields are optional; at least one must be present.

​
title
string

Replacement title (1-128 characters, trimmed).

​
teamUUID
string

Reassign the scorecard to a specific team. Mutually exclusive with allTeams=true.

​
allTeams
boolean | null

Reassign the scorecard to every team. Mutually exclusive with teamId.

​
enabled
boolean | null

Toggle the scorecard active state.

​
interactionType
enum<string>

Type of interaction the scorecard evaluates.

Available options:
conversation,
chat,
email
Example:

"conversation"

​
detailedInstructions
string

Replacement detailed instructions (0-2000 characters).

​
scorecardPrompt
string

Replacement expert-mode prompt (0-8000 characters).

​
expertMode
boolean | null

Toggle expert mode.

​
criteria
object

Label-based criteria that gate when a scorecard is applied to an interaction.

Example:
{
  "operator": "AND",
  "conditions": [
    {
      "field": "label-uuid-123",
      "value": "option-uuid-456"
    }
  ]
}

Response

Scorecard successfully updated

Single-resource envelope wrapping a Scorecard.

​
data
object
required

A scorecard template used to evaluate a conversation, chat, or email.

Example:
{
  "id": "sc-uuid-123",
  "title": "Sales Discovery Scorecard",
  "organizationId": "org-uuid-456",
  "teamId": "team-uuid-789",
  "allTeams": false,
  "enabled": true,
  "interactionType": "conversation",
  "detailedInstructions": "Focus on discovery quality and next-step commitments.",
  "scorecardPrompt": "",
  "expertMode": false,
  "isDefaultTemplate": false,
  "criteria": { "operator": "AND", "conditions": [] },
  "createdAt": "2026-04-16T10:15:00Z"
}