> For the complete documentation index, see [llms.txt](https://docs.nected.ai/nected-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nected.ai/nected-docs/management-api/deprecated-apis.md).

# Deprecated APIs

These endpoints are retained for backward compatibility only and are **not recommended for new integrations**. Use the Dev V1 APIs for all new development.

### What changed

The original Dev API used the path prefix `/dev/{entity-type}`. All of these endpoints have been superseded by the `/dev/v1/{entity-type}` equivalents, which offer richer request/response schemas, inline examples, and consistent behavior across all entity types.

| Deprecated                                     | Replacement                                       |
| ---------------------------------------------- | ------------------------------------------------- |
| `GET /dev/{entity-type}`                       | `GET /dev/v1/{entity-type}`                       |
| `GET /dev/{entity-type}/{entity-id}`           | `GET /dev/v1/{entity-type}/{entity-id}`           |
| `POST /dev/{entity-type}/{entity-id}/schedule` | `POST /dev/v1/{entity-type}/{entity-id}/schedule` |

### Endpoints

#### List rules or workflows

```
GET /dev/{entity-type}
```

Returns a paginated list of rules or workflows. Set `entity-type` to `rule` or `workflow`.

| Parameter       | In     | Required | Description                                      |
| --------------- | ------ | -------- | ------------------------------------------------ |
| `entity-type`   | path   | Yes      | `rule` or `workflow`                             |
| `Nected-Branch` | header | No       | Branch name                                      |
| `pageNo`        | query  | No       | Page number (default `1`)                        |
| `pageSize`      | query  | No       | Items per page (default `10`)                    |
| `name`          | query  | No       | Filter by name                                   |
| `type`          | query  | No       | Filter by type (e.g. `decisionTable`, `ruleSet`) |

#### Get rule or workflow by ID

```
GET /dev/{entity-type}/{entity-id}
```

Retrieves a single rule or workflow by its entity ID. Pass `version` to fetch a specific published version.

| Parameter       | In     | Required | Description                            |
| --------------- | ------ | -------- | -------------------------------------- |
| `entity-type`   | path   | Yes      | `rule` or `workflow`                   |
| `entity-id`     | path   | Yes      | Entity ID                              |
| `Nected-Branch` | header | No       | Branch name                            |
| `version`       | query  | No       | Specific published version (e.g. `v1`) |

#### Create or update schedule

```
POST /dev/{entity-type}/{entity-id}/schedule
```

Creates or updates a schedule for a rule. **Only rules support scheduling — not workflows.**

See [Create or Update Schedule](/nected-docs/management-api/rules/create-or-update-schedule-rule.md) for the full request body reference.

### Authentication

| Header           | Required | Description            |
| ---------------- | -------- | ---------------------- |
| `Nected-API-Key` | Yes      | Your Nected API key    |
| `Nected-Branch`  | No       | Branch name (optional) |

### Migration

If you are using the `/dev/` endpoints, migrate to `/dev/v1/` — the path change is the only breaking difference for list and get operations. For schedule, the request body is identical. The v1 endpoints are documented in full under **Rule API** and **Workflow API**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nected.ai/nected-docs/management-api/deprecated-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
