Promote company

Promote an existing resolved Company through an explicit user action.

POST/api/companies/{company_id}/promote

HTTP referenceScope authenticated user session (developer API keys blocked)Updated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This route requires a user session. It is not available with developer API keys. The response contains the serialized Company, promotion transition receipt, and optional research result.

Path parameters

company_idrequired
string

Name	Type	Description
company_idrequired	string	-

Body parameters

research · optional
object
Optional research relationship context: table_id, row_id, source_fit_column_id.

Name	Type	Description
research	object	Optional research relationship context: table_id, row_id, source_fit_column_id.

Errors

Status	Meaning
401	Authentication required.
403	Developer API keys are blocked for this session-only route.
404	Company not found.
400	Invalid promotion context.

Example

bash

curl -X POST "https://app.autotouch.ai/api/companies/67c4b113b4dd8f2d4999f0f1/promote" -H "Authorization: Bearer $USER_SESSION_TOKEN" -H "Content-Type: application/json" -d '{"research":{"table_id":"67c4b113b4dd8f2d4999f0f2","row_id":"row_001","source_fit_column_id":"company_fit"}}'

Request body

json

{"research":{"table_id":"67c4b113b4dd8f2d4999f0f2","row_id":"row_001","source_fit_column_id":"company_fit"}}

Response example

json

{"company":{"id":"67c4b113b4dd8f2d4999f0f1","name":"Acme","promotion_status":"promoted"},"promotion":{"matched":1,"modified":1,"already_promoted":false,"transitioned":true,"company_fit_recompute_task_id":"0123456789abcdef0123456789abcdef","company_enrichment":null},"research":null}