---
title: "Suggest input→column mappings for an agent"
method: GET
path: "/tables/{table_id}/columns/agent-input-mappings/{saved_agent_id}/"
tags: ["table-columns"]
---

# Suggest input→column mappings for an agent

`GET /tables/{table_id}/columns/agent-input-mappings/{saved_agent_id}/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/tables/{table_id}/columns/agent-input-mappings/{saved_agent_id}/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Suggest a table column for each of the agent's inputs by name similarity. This is the 'Suggest input mappings with AI' affordance.

## Path parameters

- `table_id` string, uuid, required
- `saved_agent_id` string, uuid, required

## Response `200`

Successful Response

- AgentInputMappingSuggestionsResponseSchema: Suggested input→column mappings for deploying an agent onto a table.
  - `suggestions` AgentInputMappingSuggestionSchema[], required
    - `column_id` string, uuid, nullable, required
    - `column_is_empty` boolean: True when the suggested column holds no data in this table: runs would skip every row until it is filled or remapped.
    - `input_id` string, uuid, required: The declared input this suggestion binds: the deploy request's key.
    - `input_name` string, required: The input's display name, the label the mapping row shows.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Table or agent not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/dc5ac3c84444?raw)