Skip to main content
By default, agents use mapping.travel’s hosted Anthropic credentials. If you’d rather have the LLM usage billed directly to your account — for compliance, cost control, or to use a model not on our hosted allow-list — switch to BYO Anthropic key.

​
What changes

BehaviourHostedBYO Anthropic
Who is billedmapping.travel (counted against your Pro Max subscription)You, by Anthropic, directly
Daily spend capStill enforced (cents)Still enforced (cents, estimated from token counts)
Model selectionclaude-opus-4-7, claude-haiku-4-5-20251001Any claude-* your account has access to
Prompt cachingEnabledEnabled (Anthropic-native)

​
Steps

1

Create the key in the Anthropic Console

console.anthropic.com → API Keys → Create Key. Name it “mapping-travel-agents”. Copy the value (sk-ant-...).
2

Store it in mapping.travel

Agents → [your agent] → Settings → LLM Provider. Switch to BYO Anthropic. Paste the key. Click Save — we validate it with a low-cost messages.create ping before storing.
3

Pick a model

Any Anthropic model your account has access to. We recommend claude-opus-4-7 for the default planning path; switch to claude-haiku-4-5-20251001 for the fast path on routine cycles.
4

(Optional) Set a cap matching your Anthropic budget alert

The mapping.travel daily spend cap is still enforced (estimated from token counts), so you have two layers of protection.

​
Equivalent API call

curl -X PATCH https://api.mapping.travel/api/v1/agents/{id} \
  -H 'Authorization: Bearer mt_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "llmProvider": "BYO_ANTHROPIC",
    "llmModel": "claude-opus-4-7",
    "byoApiKey": "sk-ant-..."
  }'
The API stores the key in the secret vault, returns byoKeySecretId, and never echoes the plaintext key back.

​
Security

  • The key lives in the same vault as other workspace secrets (data-source credentials, Stripe webhook signing secrets).
  • It is only visible to OWNER and ADMIN users; redacted (sk-ant-****1234) everywhere else, including the audit log.
  • Rotating the key: paste the new value over the old one — we re-validate before swapping.

​
Reverting to hosted

Switch the provider back to Hosted Anthropic in Settings. The BYO key is deleted from the vault; the audit log records AGENT_UPDATED with the provider change.