---
title: "Starts an op"
method: POST
path: "/ops/starts"
tags: ["ops"]
---

# Starts an op

`POST /ops/starts`

## Request body

- StartOpReq
  - `args` StartOpReqArgs — arguments passed to the op to satisfy inputs
  - `op` StartOpReqOp
    - `ref` string, uri-reference, required — reference to an op
    - `pullCreds` PullCreds — credentials used during authentication with the source of the op
      - `username` string, required
      - `password` string, required

## Response `201`

HTTP/1.1 ["Created" response status code](https://tools.ietf.org/html/rfc7231#section-6.3.2)

## Other responses

- `400` — HTTP/1.1 ["Bad Request" response status code](https://tools.ietf.org/html/rfc7231#section-6.5.1)
- `500` — HTTP/1.1 ["Internal Server Error" response status code](https://tools.ietf.org/html/rfc7231#section-6.6.1)

## Changes

- **2020-11-05** `4f135ca89ea8` — 2 breaking, 2 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - the request's body type/format changed from ``/`` to `object`/``
  - added the new optional request property `args`
  - added the new optional request property `op`
- **2019-07-16** `6d0123d8047b` — 1 breaking, 2 warning, 1 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `args`
  - removed the request property `op`
  - added `subschema #1, subschema #2` to the request body `oneOf` list

[Change history](https://skmtc.dev/opctl/apis/opctl-rest-api/changes/ops/starts/post.md)

---

[API](https://skmtc.dev/opctl/apis/opctl-rest-api.md) · [All operations](https://skmtc.dev/opctl/apis/opctl-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opctl/opctl-rest-api/revisions/57a79c2e7e27/schema)