Add or Update Call Title

POST

https://platform-api.convirza.com/v3/scorecards/call-title

Scorecards

Last modified:2026-07-24 13:10:44

Assigns or updates a title for a specific call.

Required Fields

call_title — Title to assign to the call (max 120 characters)

call_id — The unique ID of the call

Access Control

Requires scorecard component access (component_id = 927)

User must have access to the org unit that owns the call

Behavior

If a title already exists for the call, it will be updated

If no title exists, a new one will be created

Title is stored in the call_fields table

Example Request

{
  "call_title": "Important Sales Call",
  "call_id": 12345
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Call title added/updated successfully

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/scorecards/call-title' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "call_title": "Important Sales Call",
    "call_id": 12345
}'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "success": true
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

Create Scorecard

Duplicate Scorecard