Authentication

All Dalil API requests must include a Bearer token identifying your workspace. Without it you will receive a 401 Unauthorized response.

Get Your API Key

Log in at app.usedalil.ai
Go to Settings → API Keys
Click Generate new key
Copy and store it securely. It will not be shown again.

Using the Auth Header

Include these headers on every request:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Example

curl -X GET "https://app.usedalil.ai/rest/people?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

💡 For GET requests with complex filter parameters, use curl -G with --data-urlencode to avoid URL encoding issues:

curl -G "https://app.usedalil.ai/rest/people" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "filter=emails.primaryEmail[eq]:john@example.com"

Base URL

https://app.usedalil.ai

Interface	Path prefix
REST API	`/rest/{resource}`
GraphQL	`/graphql`

Error Responses

Status	Meaning	Common Cause
`401`	Unauthorized	Missing or invalid API key
`403`	Forbidden	Key does not have permission for this resource
`404`	Not Found	Record ID does not exist
`429`	Too Many Requests	Rate limit exceeded back off and retry
`500`	Internal Server Error	Unexpected server-side failure

When you receive a 401, verify that the Authorization header is present, starts with Bearer (note the space), and the key has not been revoked in workspace settings.