Skip to content

Incorrect Authorization header value in Call Detail Records API documentation #6

Description

@waynetaylor

The Call Detail Records API documentation contains an error in the curl example that could cause confusion and failed API calls.

Location

Page: https://developer.8x8.com/analytics/reference/call-detail-records
File: docs/analytics/reference/call-detail-records.api.mdx

The Issue

The curl example shows:

curl -L 'https://api.8x8.com/analytics/work/v2/call-records' \
  -H 'Accept: application/json' \
  -H '8x8-apikey: <8x8-apikey>' \
  -H 'Authorization: Bearer <8x8-apikey>'

The Authorization header incorrectly references <8x8-apikey>. This should be <access_token> - the bearer token returned from the /v1/oauth/token endpoint.

Expected

curl -L 'https://api.8x8.com/analytics/work/v2/call-records' \
  -H 'Accept: application/json' \
  -H '8x8-apikey: <8x8-apikey>' \
  -H 'Authorization: Bearer <access_token>'

Additional Context

Other documentation pages e.g.,https://developer.8x8.com/analytics/docs/work-analytics-company-summary/ correctly show the two-step flow:

  1. POST to /oauth/token with 8x8-apikey header + username/password to obtain access_token
  2. Use that access_token in the Authorization: Bearer header for subsequent requests

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions