Skip to content

Docs: examples for using Credentials with $curl - #533

Merged
aeberhart merged 2 commits into
masterfrom
docs/curl-credentials
Nov 13, 2026
Merged

aeberhart merged 2 commits into
masterfrom
docs/curl-credentials

Conversation

@aeberhart

Copy link
Copy Markdown
Contributor

Closes #531

The docs explained that $curl resolves a Credentials function via the Authorization header, but jsonata.json only had an example with a hard-coded basic auth header.

Changes:

  • jsonata.json: three new $curl examples
    • basic auth via a Credentials function ({'Authorization': 'dashjoin'})
    • API key / bearer token (apiKey=true, header named by username)
    • secret in the request body via dj-insert-credentials (previously undocumented)
  • developer-reference.md: worked examples in the Credentials section, incl. the role requirement
  • jsonata-reference.md: inline example and dj-insert-credentials in the $curl row
  • Regenerated appendix-jsonata.md and llms.txt via LLMs.java

The docs describe the behaviour after dashjoin/dashjoin-aas fix/curl-apikey-header, which stops $curl from sending the credential ID in Authorization when an API key goes into a different header (e.g. X-API-Key).

🤖 Generated with Claude Code

aeberhart and others added 2 commits November 13, 2026 17:08
Add jsonata.json examples for basic auth, API key and
dj-insert-credentials, and document them in the developer and
JSONata references. #531

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Picks up the new $curl credential examples from jsonata.json. #531

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@aeberhart
aeberhart merged commit 6b1f08b into master Nov 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Credential documentation must be improved

1 participant