# Publish a module

`POST https://api.cademi.com.br/api/v3/products/{product_id}/modules/{module_id}/publications`

Operation ID: `modules.publications.create` · API v3

Starts an asynchronous operation that publishes the module and everything nested in it.

Copies of the module in replicated accounts are published as well. Replicated modules can also be published through this operation.

The `Idempotency-Key` header is required. Track progress through the returned operation.

Required permissions: `modules.publish`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `product_id` | path | string | yes |  |
| `module_id` | path | string | yes |  |

## Responses

### 202

The publication was accepted for asynchronous processing. Returns the operation that tracks its progress.

Body: `data`: Operation.

Fields of Operation:

| Field | Type | Required | Description |
|---|---|---|---|
| `attempt` | object or null | yes |  |
| `cancellation_requested` | boolean | yes |  |
| `created_at` | string (date-time) | yes |  |
| `error` | object or null | yes |  |
| `expires_at` | string (date-time) | yes |  |
| `finished_at` | string or null (date-time) | yes |  |
| `id` | string | yes | Public ID, with the op_ prefix. |
| `items_url` | string | yes |  |
| `object` | string, one of `operation` | yes |  |
| `progress` | object | yes |  |
| `result_url` | string or null | yes |  |
| `started_at` | string or null (date-time) | yes |  |
| `status` | string, one of `queued`, `running`, `succeeded`, `partially_succeeded`, `failed`, `canceled` | yes |  |
| `type` | string | yes | Type of the operation, from a fixed set of values. |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The module was not found in the specified product or is not accessible with the current credentials.

Body: Error.

### 422

The request does not include the required Idempotency-Key header.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json