entity-lookup
Look up user profiles by identity field and value. Use when the user wants to find or look up a specific user profile by email, user ID, or other identity field.
How do I install this agent skill?
npx skills add https://github.com/lytics/agent-skills --skill entity-lookupIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The entity-lookup skill facilitates the retrieval and management of user profiles within the Lytics platform. It adheres to security best practices by utilizing environment variables for authentication and implementing a confirmation gate for destructive actions like data deletion. All communication is conducted with official vendor API endpoints.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Entity Lookup
Purpose
Look up individual user profiles by identity field. Returns the full profile including all fields, segment memberships, and metadata.
Environment
Requires authenticated API access. See ../references/auth.md for credential resolution.
API Endpoints
V2 Identity Lookup
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/identity/${TABLE}/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Example: GET /v2/identity/user/email/user@example.com
Data API Entity Lookup
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Entity Lookup by Value Only
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Searches across all identity fields.
Entity Segment Memberships
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/segments/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Identity Lookup (POST)
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/identity/lookup" \
-H "Authorization: ${LYTICS_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"field": "email", "value": "user@example.com", "table": "user"}'
Delete Entity
# Hard delete
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Soft delete
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/softdelete/${TABLE}/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Common Identity Fields
email-- Email address_uid-- Lytics user IDuser_id-- External user ID- Check
GET /v2/schema/{table}/idconfigfor account-specific identity fields
Behavior
For Lookups (read)
Execute immediately. Display the profile in a structured format:
- Identity: All identity fields and values
- Key attributes: High-value profile fields (name, location, engagement scores)
- Segment memberships: Which segments this user belongs to
- Recent activity: Latest event timestamps
For Deletes (write)
Use the confirmation-gate pattern. Warn that:
- Hard deletes are irreversible
- Soft deletes can be undone but affect data processing
Error Handling
- Profile not found (404): Suggest trying different identity fields or checking spelling
- URL encoding: URL-encode the value if it contains special characters (e.g.,
@in emails) - Multiple matches: If multiple profiles match, present all and ask user to select
Dependencies
- Uses:
../references/auth.md,../references/api-client.md,../references/confirmation-gate.md(for deletes only)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/lytics/agent-skills/entity-lookup">View entity-lookup on skillZs</a>