Skip to content

README: the API key placeholder uses a prefix real keys do not have #107

Closed

Description

@cnpierrepapi

Summary

The README tells you to set your key like this, in two places:

export CALLE_API_KEY="calle_live_key"

Lines 199 and 261.

Real keys do not look like that. The authentication guide says production keys carry the iams_live_ prefix, and the dashboard hands out keys in that shape.

It is small, but it lands at an unhelpful moment. Someone copies that line, pastes their real key over it, and the only reference point they have for what a key should look like now disagrees with the key in their hand. If the next request fails for an unrelated reason, the prefix is a plausible thing to start doubting.

The docs already use iams_live_example as their placeholder, which is unmistakably a placeholder and the right shape.

Where

README.md, lines 199 and 261.

Suggested fix

Match the docs:

export CALLE_API_KEY="iams_live_example"

Worth a grep for calle_live across the repo while you are in there, in case it survives anywhere else.

Activity

  1. Ray-56 commented on Sep 5, 2026

    @Ray-56
    Collaborator

    Priority: P3 — documentation correctness. Confirmed: the two README.md examples use calle_live_key, while the current CALL-E Developer Docs use the non-secret placeholder iams_live_example. rg finds no other calle_live occurrence in this repository.

    Recommended next action: replace both README placeholders with iams_live_example, then follow docs/documentation-maintenance.md and verify the API-key examples against the canonical Developer Docs. Keep the value obviously synthetic and never add a real dashboard-issued key to tests, examples, commits, or CI logs.

    Release decision: No release needed for a root-README-only correction; no package or changeset is required. Run the normal documentation/version checks before merging.

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