How the API Works

Dalil AI exposes two interfaces:

Base URL: https://app.usedalil.ai

Authentication: Every request requires Authorization: Bearer YOUR_API_KEY. Get your key from Settings → API Keys in your workspace.

Search pattern: Full-text search goes through GraphQL, which returns record IDs. You then fetch full records via REST:

Step 1: POST /graphql  →  get list of recordIds
Step 2: GET /rest/{entity}?filter=id[in]:[id1,id2]  →  get full records

Step 1: POST /graphql  →  get list of recordIds
Step 2: GET /rest/{entity}?filter=id[in]:[id1,id2]  →  get full records

Step 1: POST /graphql  →  get list of recordIds
Step 2: GET /rest/{entity}?filter=id[in]:[id1,id2]  →  get full records

Authentication

All Dalil AI API requests must be authenticated with a Bearer token. This token identifies your workspace and authorizes access to its data.

Getting Your API Key

1. Log in to your Dalil AI workspace at app.usedalil.ai

2. Navigate to Settings → API Keys

3. Generate a new API key

4. Copy and store it securely — it will not be shown again

Sending the Auth Header

Include these two headers in every request:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

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"

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

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

Tip: 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"

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

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

https://app.usedalil.ai

https://app.usedalil.ai

• REST endpoints: /rest/{resource}

• GraphQL endpoint: /graphql

Error Responses

When you receive a 401, check that:

• The Authorization header is present and spelled correctly

• The value starts with Bearer (with a space)

• The API key has not been revoked in workspace settings