---
title: "Promote a Function deployment"
method: POST
path: "/v1/functions/{function_id}/deployments/{deployment_id}/promote"
tags: ["Functions"]
---

# Promote a Function deployment

`POST /v1/functions/{function_id}/deployments/{deployment_id}/promote`

## Request

- Base URL: `https://api.dexto.ai`
- URL: `https://api.dexto.ai/v1/functions/{function_id}/deployments/{deployment_id}/promote`
- Auth: HTTP bearer

Make one of the Function's ready deployments production and publish its interfaces. Needs functions:write.

## Path parameters

- `function_id` string, required
- `deployment_id` string, required

## Response `200`

Successful response.

- object
  - `access` 'private' | 'public', required: Who can reach it: private by default; public only for intentional internet access.
  - `deployment` object, required
    - `id` string, uuid, required
    - `status` 'failed' | 'pending' | 'ready' | 'retired' | 'retiring', required
  - `function` object, required
    - `id` string, uuid, required
    - `slug` string, required
    - `title` string, required
  - `interfaces` object, required
    - `mcp` string, uri, nullable, required: Its MCP endpoint, when it publishes MCP.
    - `openapi` string, uri, nullable, required: Its OpenAPI document, when it publishes OpenAPI.
  - `mcp_connection` object, nullable, required: The person's remote MCP connection its MCP interface was registered as, for a person's OAuth token; null for a key, which registers none.
    - `id` string, required
    - `status` string, required
  - `object` 'function.promotion', required
  - `operations` string[], required
  - `url` string, uri, nullable, required

## Other responses

- `400`: Invalid JSON or request fields.
- `401`: Missing or invalid API key.
- `402`: The account has insufficient credits.
- `403`: The account cannot perform this operation.
- `404`: The requested resource was not found.
- `409`: The request conflicts with existing resource state.
- `429`: The account exceeded this operation's request rate.
- `500`: Unexpected Dexto failure.
- `502`: The upstream model provider failed.
- `503`: A required Dexto service is temporarily unavailable.

---

[API](https://skmtc.dev/dexto/apis/dexto-api.md) - [All operations](https://skmtc.dev/dexto/apis/dexto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dexto/apis/dexto-api/revisions/47eb880cffa5?raw)