unauthenticated

Authentication is required

Status: 401 Unauthorized

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

When it is sent

No credential; a malformed, unknown or revoked key; an invalid or expired session; a session on POST /v1/events. Send Authorization: Bearer with a valid API key, or with a current session token where the operation takes one. POST /v1/events takes an API key only.

Example

{
  "type": "https://api.allisai.ai/errors/unauthenticated",
  "title": "Authentication is required",
  "status": 401,
  "detail": "A human-readable explanation of this occurrence. Its wording varies; branch on code, never on detail.",
  "code": "unauthenticated",
  "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)
• Validate a calculation (validateCalculation)
• Publish a calculation (publishCalculation)
• Reopen a calculation (reopenCalculation)
• 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)
• Share a report (shareReport)
• Revoke a report's link (revokeReport)
• Read the workspace's month (getDashboard)
• List renewal readiness (listRenewals)
• List API keys (listApiKeys)
• Create an API key (createApiKey)
• Read an API key (getApiKey)
• Revoke an API key (revokeApiKey)