---
title: "Activate translation add-on"
method: POST
path: "/ai/v1/addons"
tags: ["AI"]
---

# Activate translation add-on

`POST /ai/v1/addons`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/ai/v1/addons`
- Auth: API key in header `x-admin-key`

Activate a translation add-on for a project. Admin only.

## Request body

- object
  - `project_id` string, required: Run402 project ID. Public IDs are not UUIDs.
  - `addon_type` 'translation', required: Add-on type (currently only 'translation')
  - `included_words` integer, required: Positive safe-integer word count included in the add-on package

## Response `201`

Add-on activated

- object
  - `project_id` string: Run402 project ID. Public IDs are not UUIDs.
  - `addon_type` string
  - `included_words` integer
  - `included_tokens` integer
  - `status` 'active'

## Other responses

- `400`: Invalid input (missing project_id, invalid addon_type, or invalid included_words)
- `401`: Missing or invalid authentication. Run402-originated JSON bodies use the canonical ErrorEnvelope.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)