---
title: "Turn On Model"
method: POST
path: "/v4/organizations/{organizationId}/aiServices/models/{modelId}/activationState"
tags: ["Models (AI Data Plane)"]
---

# Turn On Model

`POST /v4/organizations/{organizationId}/aiServices/models/{modelId}/activationState`

## Request

- Base URL: `https://cloudapi.cloud.couchbase.com`
- URL: `https://cloudapi.cloud.couchbase.com/v4/organizations/{organizationId}/aiServices/models/{modelId}/activationState`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/docs/v4/organizations/:organizationId/aiServices/models/:modelId/activationState/post.ts> (a function with typed inputs; its response is checked against the schema)

Resumes the model or turns the model to On state.

The connection URL remains unchanged when the model is turned on or off.

In order to access this endpoint, the provided API key must have at least one of the roles referenced below:
- Organization Owner

To learn more, see [Organization, Project, and Database Access Overview](https://docs.couchbase.com/cloud/organizations/organization-projects-overview.html).

## Response `202`

Successfully switched the model to on state.

## Other responses

- `403`: The client does not have the necessary permissions to access this resource.
- `404`: The requested resource was not found.
- `409`: Returned when there is a conflict with the current state of a resource.
- `412`: Returned when there is a mismatch with the Etag version.
- `422`: Request validation error.
- `429`: Returned when the client exceeds the rate limit for the given APIKey.
- `500`: An unexpected error occurred in the server while processing this request.

## Changes

- **2026-08-06** `e67df5d1f74e`: 2 info
  - api tag `Models (AI Data Plane)` added
  - api tag `Models (AI Services)` removed

[Operation history](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/changes/v4/organizations/:organizationId/aiServices/models/:modelId/activationState/post.md)

---

[API](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api.md) - [All operations](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/revisions/a5e88bcf71cb?raw)