# Run project workflow

**POST /projects/{projectId}/workflows**

Dispatch workflow with given definition


## Servers
- Production environment: https://api.metafold3d.com (Production environment)
- Bleeding-edge (unstable) environment: https://dev-api.metafold3d.com (Bleeding-edge (unstable) environment)


## Authentication methods
- Oauth2


## Parameters

### Path parameters
- **projectId** (string)
  Project ID


### Body: application/json (object)

- **definition** (string)
  YAML-encoded definition
- **assets** (object)
  Input asset or parameter assignments.
  Assignments should be in the form `job.input`,
  with a `.` dot separating the job name and asset/parameter name.
- **parameters** (object)
  Input asset or parameter assignments.
  Assignments should be in the form `job.input`,
  with a `.` dot separating the job name and asset/parameter name.


## Responses
### 202
Accepted

#### Body: application/json (object)
- **id** (string)

- **jobs** (array[string])
  Job IDs
- **state** (string)
  Current workflow state
- **created** (string)
  ISO 8601 datetime
- **started** (string)
  ISO 8601 datetime
- **finished** (string)
  ISO 8601 datetime
- **definition** (string)
  Raw definition string
- **project_id** (string)
  Project ID
- **link** (string)
  Status query URL

### 400
Bad Request

#### Body: application/json (object)
- **code** (integer)
  HTTP response code
- **name** (string)
  Status text corresponding to the HTTP response code
- **description** (string)
  Detailed error message

### 401
Unauthorized

#### Body: application/json (object)
- **code** (integer)
  HTTP response code
- **name** (string)
  Status text corresponding to the HTTP response code
- **description** (string)
  Detailed error message


[Powered by Bump.sh](https://bump.sh)