---
title: "Affinda integration for LuumenAI"
url: "https://www.luumen.ai/integrations/affinda/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Affinda integration for LuumenAI

Read parsed documents, collections, and annotations — change them with approval

## What LuumenAI can do with Affinda

LuumenAI connects to Affinda with an API token and exposes 105 tools (47 read-only · 42 write · 16 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 105 tools (47 read-only · 42 write · 16 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Affinda with LuumenAI

Affinda parses resumes, job descriptions, and other documents into structured data. Connect it and Luumen can read your collections, annotations, tags, and validation results while you work in the terminal. Corrections come next: retag a batch, fix extracted fields, add a collection. Each change is previewed and, by default, held for your approval before it runs.

## Example tools

Read-only (47 in total):

- `AFFINDA_CREATE_JOB_DESCRIPTION_SEARCH` — Search through parsed job descriptions using custom criteria or resume matching.
- `AFFINDA_CREATE_RESUME_SEARCH` — Search through parsed resumes using three methods: match to a job description, match to a resume, or custom criteria.
- `AFFINDA_GET_ALL_API_USERS` — Retrieve a list of all API users.
- `AFFINDA_GET_ALL_DOCUMENT_SPLITTERS` — Get a list of all document splitters.
- `AFFINDA_GET_ALL_INVITATIONS` — Retrieve all invitations you created or sent to you.
- `AFFINDA_GET_ALL_ORGANIZATION_MEMBERSHIPS` — Retrieve all organization memberships across the account.
- `AFFINDA_GET_ALL_TAGS` — List all tags.
- `AFFINDA_GET_ALL_VALIDATION_RESULTS` — List validation results for documents.

Write and destructive (58 in total, approval required by default):

- `AFFINDA_ADD_TAG_TO_DOCUMENTS` — Add a tag to multiple documents in a single operation.
- `AFFINDA_BATCH_UPDATE_ANNOTATIONS` — Batch update multiple document annotations in a single API call.
- `AFFINDA_CREATE_API_USER` — Create a new API user within an organization.
- `AFFINDA_CREATE_BATCH_ANNOTATIONS` — Batch create multiple document annotations in a single API call.
- `AFFINDA_CREATE_COLLECTION` — Create a new collection.
- `AFFINDA_CREATE_DATA_FIELD_FOR_COLLECTION` — Create a data field for a collection along with a new data point.
- `AFFINDA_CREATE_DATA_SOURCE` — Create a custom mapping data source.
- `AFFINDA_CREATE_DATA_SOURCE_VALUE` — Add a new value to a mapping data source.

## Frequently asked questions

### How does LuumenAI connect to Affinda?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Affinda on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 16 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Affinda — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/affinda/