insufficient_scope

The API key lacks the required scope

Status: 403 Forbidden

type: https://api.allisai.ai/errors/insufficient_scope

When it is sent

A key without the scope the operation needs. WWW-Authenticate names the scope. Use a key that holds it. Scopes are independent, so write does not grant read.

Example

{
  "type": "https://api.allisai.ai/errors/insufficient_scope",
  "title": "The API key lacks the required scope",
  "status": 403,
  "detail": "A human-readable explanation of this occurrence. Its wording varies; branch on code, never on detail.",
  "code": "insufficient_scope",
  "request_id": "3a9f6c1e2b7d4e5f8a0b1c2d3e4f5a6b"
}

Operations that return it

• Ingest a batch of events (ingestEvents)
• Preview a CSV import (previewImport)
• Import a CSV file (commitImport)
• List clients (listClients)
• Create a client (createClient)
• Read a client (getClient)
• Delete a client (deleteClient)
• Update a client (updateClient)
• Replace a client's assigned agents (setClientAgents)
• Read a client's active value model (getClientValueModel)
• Create a client's value model (createValueModel)
• Delete a client's active value model (deleteValueModel)
• Update a client's active value model (updateValueModel)
• Replace a value model's line items (setValueModelLineItems)
• List a client's outcome types (listClientOutcomeTypes)
• Compute a client's value (getClientValue)
• Compute a client's cost (getClientCost)
• Compute a client's ROI (getClientRoi)
• List the events behind a client's totals (listClientEvents)
• List a client's calculations (listClientCalculations)
• Freeze a client's ROI for a period (createCalculation)
• Flag anomalies in a client's period (getClientAnomalies)
• List agents (listAgents)
• Create an agent (createAgent)
• Read an agent (getAgent)
• Delete an agent (deleteAgent)
• Update an agent (updateAgent)
• List value models (listValueModels)
• Read a value model (getValueModel)
• List the workspace's outcome types (listOutcomeTypes)
• List value templates (listValueTemplates)
• List cost line items (listCostLineItems)
• Create a cost line item (createCostLineItem)
• Read a cost line item (getCostLineItem)
• Delete a cost line item (deleteCostLineItem)
• Update a cost line item (updateCostLineItem)
• Read the price table (getPriceTable)
• Replace the price table (setPriceTable)
• Read a calculation (getCalculation)
• Delete a draft calculation (deleteCalculation)
• List a calculation's reports (listCalculationReports)
• Compose a report on a calculation (createReport)
• Read a report (getReport)
• Delete an unshared report (deleteReport)
• Edit a report (updateReport)
• Read the workspace's month (getDashboard)
• List renewal readiness (listRenewals)