# Use operators and operator API services

Query available operators, create and maintain custom operators, and publish, enable, disable, or invoke operators as API services. This page does not handle workflow jobs; to run workflows, see [Run, resume, and retry workflow jobs](https://omnifabric.cloudsigma.com/docs/developer/api/ai-studio/data-processing/workflow-jobs-recovery.html.md).

## Prerequisites

Prepare credentials that can access the target workspace. For service endpoints, authentication, and general request formats, see [Make your first AI Studio API call](https://omnifabric.cloudsigma.com/docs/developer/quickstart/index.html.md).

Before maintaining a custom operator or operator API service, obtain the target ID from the corresponding list or details.

## Call sequence

1. List operators and get details to confirm available operators and their current information.
2. To create custom processing logic, create a custom operator, query its code and details, then test it after adjustments.
3. After confirming that a custom operator is usable, publish an operator API service and inspect its configuration.
4. Enable a service before invoking it. Disable it to stop service temporarily, then enable it again to resume use.
5. Before deleting a custom operator that is no longer needed, confirm the impact.

## API operations

### Browse operators

| Task | Use it when |
| --- | --- |
| [Query operators](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-catalog/list-operators.html.md) | Find available operators. |
| [Query operator details](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-catalog/get-operator.html.md) | You selected an operator and need its information. |

### Manage custom operators

| Task | Use it when |
| --- | --- |
| [Query custom operators](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/list-custom-operators.html.md) | Find a custom operator or obtain a target ID. |
| [Create a custom operator](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/create-custom-operator.html.md) | Add custom processing logic. |
| [Query custom-operator details](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/get-custom-operator.html.md) | Confirm current information for one custom operator. |
| [Query custom-operator code](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/get-custom-operator-code.html.md) | View custom-operator code. |
| [Update a custom operator](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/update-custom-operator.html.md) | Adjust an existing custom operator. |
| [Test a custom operator](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/test-custom-operator.html.md) | Validate a custom operator before publishing or use. |
| [Enable a custom operator](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/enable-custom-operator.html.md) | Enable a disabled custom operator. |
| [Disable a custom operator](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/disable-custom-operator.html.md) | Stop using a custom operator temporarily. |
| [Delete a custom operator](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/delete-custom-operator.html.md) | You confirmed that the custom operator is no longer needed. |

### Publish and invoke API services

| Task | Use it when |
| --- | --- |
| [Publish an operator API service](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-api-services/publish-operator-api-service.html.md) | Provide an operator as an API service. |
| [View operator API service configuration](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-api-services/get-operator-api-service.html.md) | Confirm service configuration after publishing. |
| [Enable an operator API service](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-api-services/enable-operator-api-service.html.md) | Enable a disabled service. |
| [Disable an operator API service](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-api-services/disable-operator-api-service.html.md) | Stop a service temporarily. |
| [Invoke an operator API service](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-api-services/invoke-operator-api-service.html.md) | The service is published and available. |

## Confirm the result

After creating, updating, enabling, or disabling a custom operator, use [Get custom-operator details](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/custom-operators/get-custom-operator.html.md) to confirm current information. After publishing, enabling, or disabling a service, use [Get operator API service configuration](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/data-processing/operator-api-services/get-operator-api-service.html.md) to confirm service configuration.

## Limitations and notes

- Publishing, enabling, and invoking are separate operations. Confirm service configuration and availability before invocation.
- Before deleting or disabling a custom operator or disabling an API service, confirm that dependent calls are not affected.

## Next steps

- [Run, resume, and retry workflow jobs](https://omnifabric.cloudsigma.com/docs/developer/api/ai-studio/data-processing/workflow-jobs-recovery.html.md)