Files
windmill/backend/windmill-api/openapi-deref.yaml
T
Guillaume Bouvignies e8ed4783b2 feat: Workspace encryption key can be manually updated (#3223)
* feat: Workspace encryption key can be manually updated

* sqlx prepare
2024-02-15 17:02:45 +01:00

11732 lines
320 KiB
YAML

openapi: 3.0.3
info:
version: 1.269.0
title: Windmill API
contact:
name: Windmill Team
email: contact@windmill.dev
url: https://windmill.dev
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
x-logo:
url: https://windmill.dev/img/windmill.svg
externalDocs:
description: documentation portal
url: https://windmill.dev
servers:
- url: /api
security:
- bearerAuth: []
- cookieAuth: []
paths:
/version:
get:
summary: get backend version
operationId: backendVersion
tags:
- settings
responses:
'200':
description: git version of backend
content:
text/plain:
schema:
type: string
/uptodate:
get:
summary: is backend up to date
operationId: backendUptodate
tags:
- settings
responses:
'200':
description: is backend up to date
content:
text/plain:
schema:
type: string
/ee_license:
get:
summary: get license id
operationId: getLicenseId
tags:
- settings
responses:
'200':
description: get license id (empty if not ee)
content:
text/plain:
schema:
type: string
/openapi.yaml:
get:
summary: get openapi yaml spec
operationId: getOpenApiYaml
tags:
- settings
responses:
'200':
description: openapi yaml file content
content:
text/plain:
schema:
type: string
/w/{workspace}/audit/get/{id}:
get:
summary: get audit log (requires admin privilege)
operationId: getAuditLog
tags:
- audit
parameters:
- name: workspace
in: path
required: true
schema: &ref_0
type: string
- name: id
in: path
required: true
schema: &ref_24
type: integer
responses:
'200':
description: an audit log
content:
application/json:
schema:
type: object
properties: &ref_1
id:
type: integer
timestamp:
type: string
format: date-time
username:
type: string
operation:
type: string
enum:
- jobs.run
- jobs.run.script
- jobs.run.preview
- jobs.run.flow
- jobs.run.flow_preview
- jobs.run.script_hub
- jobs.run.dependencies
- jobs.run.identity
- jobs.run.noop
- jobs.flow_dependencies
- jobs
- jobs.cancel
- jobs.force_cancel
- jobs.disapproval
- jobs.delete
- account.delete
- openai.request
- resources.create
- resources.update
- resources.delete
- resource_types.create
- resource_types.update
- resource_types.delete
- schedule.create
- schedule.setenabled
- schedule.edit
- schedule.delete
- scripts.create
- scripts.update
- scripts.archive
- scripts.delete
- users.create
- users.delete
- users.update
- users.login
- users.logout
- users.accept_invite
- users.decline_invite
- users.token.create
- users.token.delete
- users.add_to_workspace
- users.add_global
- users.setpassword
- users.impersonate
- users.leave_workspace
- oauth.login
- oauth.signup
- variables.create
- variables.delete
- variables.update
- flows.create
- flows.update
- flows.delete
- flows.archive
- apps.create
- apps.update
- apps.delete
- folder.create
- folder.update
- folder.delete
- folder.add_owner
- folder.remove_owner
- group.create
- group.delete
- group.edit
- group.adduser
- group.removeuser
- igroup.create
- igroup.delete
- igroup.adduser
- igroup.removeuser
- variables.decrypt_secret
- workspaces.edit_command_script
- workspaces.edit_deploy_to
- workspaces.edit_auto_invite_domain
- workspaces.edit_webhook
- workspaces.edit_copilot_config
- workspaces.edit_error_handler
- workspaces.create
- workspaces.update
- workspaces.archive
- workspaces.unarchive
- workspaces.delete
action_kind:
type: string
enum:
- Created
- Updated
- Delete
- Execute
resource:
type: string
parameters:
type: object
required: &ref_2
- id
- timestamp
- username
- operation
- action_kind
/w/{workspace}/audit/list:
get:
summary: list audit logs (requires admin privilege)
operationId: listAuditLogs
tags:
- audit
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: &ref_3
type: integer
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: &ref_4
type: integer
- name: before
description: filter on created before (exclusive) timestamp
in: query
schema: &ref_102
type: string
format: date-time
- name: after
description: filter on created after (exclusive) timestamp
in: query
schema: &ref_101
type: string
format: date-time
- name: username
description: filter on exact username of user
in: query
schema: &ref_103
type: string
- name: operation
description: filter on exact or prefix name of operation
in: query
schema: &ref_104
type: string
- name: resource
description: filter on exact or prefix name of resource
in: query
schema: &ref_105
type: string
- name: action_kind
description: filter on type of operation
in: query
schema: &ref_106
type: string
enum:
- Create
- Update
- Delete
- Execute
responses:
'200':
description: a list of audit logs
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_1
required: *ref_2
/auth/login:
post:
security: []
summary: login with password
operationId: login
tags:
- user
requestBody:
description: credentials
required: true
content:
application/json:
schema:
type: object
properties: &ref_119
email:
type: string
password:
type: string
required: &ref_120
- email
- password
responses:
'200':
description: >
Successfully authenticated. The session ID is returned in a cookie
named `token` and as plaintext response. Preferred method of
authorization is through the bearer token. The cookie is only for
browser convenience.
headers:
Set-Cookie:
schema:
type: string
example: token=abcde12345; Path=/; HttpOnly
content:
text/plain:
schema:
type: string
/auth/logout:
post:
security: []
summary: logout
operationId: logout
tags:
- user
responses:
'200':
description: clear cookies and clear token (if applicable)
headers:
Set-Cookie:
schema:
type: string
content:
text/plain:
schema:
type: string
/w/{workspace}/users/add:
post:
summary: create user (require admin privilege)
operationId: createUser
tags:
- user
- admin
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: new user
required: true
content:
application/json:
schema:
type: object
properties: &ref_121
email:
type: string
username:
type: string
is_admin:
type: boolean
required: &ref_122
- email
- username
- is_admin
responses:
'201':
description: user created
content:
text/plain:
schema:
type: string
/w/{workspace}/users/update/{username}:
post:
summary: update user (require admin privilege)
operationId: updateUser
tags:
- user
- admin
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: username
in: path
required: true
schema:
type: string
requestBody:
description: new user
required: true
content:
application/json:
schema:
type: object
properties: &ref_123
is_admin:
type: boolean
operator:
type: boolean
disabled:
type: boolean
responses:
'200':
description: edited user
content:
text/plain:
schema:
type: string
/w/{workspace}/users/is_owner/{path}:
get:
summary: is owner of path
operationId: isOwnerOfPath
tags:
- user
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: &ref_17
type: string
responses:
'200':
description: is owner
content:
application/json:
schema:
type: boolean
/users/setpassword:
post:
summary: set password
operationId: setPassword
tags:
- user
requestBody:
description: set password
required: true
content:
application/json:
schema:
type: object
properties:
password:
type: string
required:
- password
responses:
'200':
description: password set
content:
text/plain:
schema:
type: string
/users/create:
post:
summary: create user
operationId: createUserGlobally
tags:
- user
requestBody:
description: user info
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
password:
type: string
super_admin:
type: boolean
name:
type: string
company:
type: string
required:
- email
- password
- super_admin
responses:
'201':
description: user created
content:
text/plain:
schema:
type: string
/users/update/{email}:
post:
summary: global update user (require super admin)
operationId: globalUserUpdate
tags:
- user
parameters:
- name: email
in: path
required: true
schema:
type: string
requestBody:
description: new user info
required: true
content:
application/json:
schema:
type: object
properties:
is_super_admin:
type: boolean
responses:
'200':
description: user updated
content:
text/plain:
schema:
type: string
/users/delete/{email}:
delete:
summary: global delete user (require super admin)
operationId: globalUserDelete
tags:
- user
parameters:
- name: email
in: path
required: true
schema:
type: string
responses:
'200':
description: user deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/users/delete/{username}:
delete:
summary: delete user (require admin privilege)
operationId: deleteUser
tags:
- user
- admin
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: username
in: path
required: true
schema:
type: string
responses:
'200':
description: delete user
content:
text/plain:
schema:
type: string
/workspaces/list:
get:
summary: list all workspaces visible to me
operationId: listWorkspaces
tags:
- workspace
responses:
'200':
description: all workspaces
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_5
id:
type: string
name:
type: string
owner:
type: string
domain:
type: string
required: &ref_6
- id
- name
- owner
/workspaces/allowed_domain_auto_invite:
get:
summary: is domain allowed for auto invi
operationId: isDomainAllowed
tags:
- workspace
responses:
'200':
description: domain allowed or not
content:
application/json:
schema:
type: boolean
/workspaces/users:
get:
summary: list all workspaces visible to me with user info
operationId: listUserWorkspaces
tags:
- workspace
responses:
'200':
description: workspace with associated username
content:
application/json:
schema:
type: object
properties: &ref_151
email:
type: string
workspaces:
type: array
items:
type: object
properties:
id:
type: string
name:
type: string
username:
type: string
required:
- id
- name
- username
required: &ref_152
- email
- workspaces
/workspaces/list_as_superadmin:
get:
summary: list all workspaces as super admin (require to be super admin)
operationId: listWorkspacesAsSuperAdmin
tags:
- workspace
parameters:
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: workspaces
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_5
required: *ref_6
/workspaces/create:
post:
summary: create workspace
operationId: createWorkspace
tags:
- workspace
requestBody:
description: new token
required: true
content:
application/json:
schema:
type: object
properties: &ref_153
id:
type: string
name:
type: string
username:
type: string
required: &ref_154
- id
- name
- username
responses:
'201':
description: token created
content:
text/plain:
schema:
type: string
/workspaces/exists:
post:
summary: exists workspace
operationId: existsWorkspace
tags:
- workspace
requestBody:
description: id of workspace
required: true
content:
application/json:
schema:
type: object
properties:
id:
type: string
required:
- id
responses:
'200':
description: status
content:
text/plain:
schema:
type: boolean
/workspaces/exists_username:
post:
summary: exists username
operationId: existsUsername
tags:
- workspace
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
id:
type: string
username:
type: string
required:
- id
- username
responses:
'200':
description: status
content:
text/plain:
schema:
type: boolean
/settings/global/{key}:
get:
summary: get global settings
operationId: getGlobal
tags:
- setting
parameters:
- name: key
in: path
required: true
schema: &ref_7
type: string
responses:
'200':
description: status
content:
application/json:
schema: {}
post:
summary: post global settings
operationId: setGlobal
tags:
- setting
parameters:
- name: key
in: path
required: true
schema: *ref_7
requestBody:
description: value set
required: true
content:
application/json:
schema:
type: object
properties:
value: {}
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/settings/local:
get:
summary: get local settings
operationId: getLocal
tags:
- setting
responses:
'200':
description: status
content:
application/json:
schema: {}
/settings/test_smtp:
post:
summary: test smtp
operationId: testSmtp
tags:
- setting
requestBody:
description: test smtp payload
required: true
content:
application/json:
schema:
type: object
properties:
to:
type: string
smtp:
type: object
properties:
host:
type: string
username:
type: string
password:
type: string
port:
type: integer
from:
type: string
tls_implicit:
type: boolean
required:
- host
- username
- password
- port
- from
- tls_implicit
required:
- to
- smtp
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/settings/test_license_key:
post:
summary: test license key
operationId: testLicenseKey
tags:
- setting
requestBody:
description: test license key
required: true
content:
application/json:
schema:
type: object
properties:
license_key:
type: string
required:
- license_key
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/settings/send_stats:
post:
summary: send stats
operationId: sendStats
tags:
- setting
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/users/email:
get:
summary: get current user email (if logged in)
operationId: getCurrentEmail
tags:
- user
responses:
'200':
description: user email
content:
text/plain:
schema:
type: string
/users/refresh_token:
get:
summary: refresh the current token
operationId: refreshUserToken
tags:
- user
responses:
'200':
description: free usage
content:
text/plain:
schema:
type: string
/users/tutorial_progress:
get:
summary: get tutorial progress
operationId: getTutorialProgress
tags:
- user
responses:
'200':
description: tutorial progress
content:
application/json:
schema:
type: object
properties:
progress:
type: integer
post:
summary: update tutorial progress
operationId: updateTutorialProgress
tags:
- user
requestBody:
description: progress update
required: true
content:
application/json:
schema:
type: object
properties:
progress:
type: integer
responses:
'200':
description: tutorial progress
content:
text/plain:
schema:
type: string
/users/leave_instance:
post:
summary: leave instance
operationId: leaveInstance
tags:
- user
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/users/usage:
get:
summary: get current usage outside of premium workspaces
operationId: getUsage
tags:
- user
responses:
'200':
description: free usage
content:
text/plain:
schema:
type: number
/users/all_runnables:
get:
summary: get all runnables in every workspace
operationId: getRunnable
tags:
- user
responses:
'200':
description: free all runnables
content:
application/json:
schema:
type: object
properties:
workspace:
type: string
endpoint_async:
type: string
endpoint_sync:
type: string
endpoint_openai_sync:
type: string
summary:
type: string
description:
type: string
kind:
type: string
required:
- workspace
- endpoint_async
- endpoint_sync
- endpoint_openai_sync
- summary
- kind
/users/whoami:
get:
summary: get current global whoami (if logged in)
operationId: globalWhoami
tags:
- user
responses:
'200':
description: user email
content:
application/json:
schema:
type: object
properties: &ref_10
email:
type: string
login_type:
type: string
enum:
- password
- github
super_admin:
type: boolean
verified:
type: boolean
name:
type: string
company:
type: string
required: &ref_11
- email
- login_type
- super_admin
- verified
/users/list_invites:
get:
summary: list all workspace invites
operationId: listWorkspaceInvites
tags:
- user
responses:
'200':
description: list all workspace invites
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_12
workspace_id:
type: string
email:
type: string
is_admin:
type: boolean
operator:
type: boolean
required: &ref_13
- workspace_id
- email
- is_admin
- operator
/w/{workspace}/users/whoami:
get:
summary: whoami
operationId: whoami
tags:
- user
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: user
content:
application/json:
schema:
type: object
properties: &ref_8
email:
type: string
username:
type: string
is_admin:
type: boolean
is_super_admin:
type: boolean
created_at:
type: string
format: date-time
operator:
type: boolean
disabled:
type: boolean
groups:
type: array
items:
type: string
folders:
type: array
items:
type: string
folders_owners:
type: array
items:
type: string
usage:
type: object
properties: &ref_118
executions:
type: number
required: &ref_9
- email
- username
- is_admin
- is_super_admin
- created_at
- operator
- disabled
- folders
- folders_owners
/users/accept_invite:
post:
summary: accept invite to workspace
operationId: acceptInvite
tags:
- user
requestBody:
description: accept invite
required: true
content:
application/json:
schema:
type: object
properties:
workspace_id:
type: string
username:
type: string
required:
- workspace_id
- username
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/users/decline_invite:
post:
summary: decline invite to workspace
operationId: declineInvite
tags:
- user
requestBody:
description: decline invite
required: true
content:
application/json:
schema:
type: object
properties:
workspace_id:
type: string
required:
- workspace_id
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/invite_user:
post:
summary: invite user to workspace
operationId: inviteUser
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceInvite
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
is_admin:
type: boolean
operator:
type: boolean
required:
- email
- is_admin
- operator
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/add_user:
post:
summary: add user to workspace
operationId: addUser
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceInvite
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
is_admin:
type: boolean
username:
type: string
operator:
type: boolean
required:
- email
- is_admin
- operator
- username
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/delete_invite:
post:
summary: delete user invite
operationId: delete invite
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceInvite
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
is_admin:
type: boolean
operator:
type: boolean
required:
- email
- is_admin
- operator
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/archive:
post:
summary: archive workspace
operationId: archiveWorkspace
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/workspaces/unarchive/{workspace}:
post:
summary: unarchive workspace
operationId: unarchiveWorkspace
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/workspaces/delete/{workspace}:
delete:
summary: delete workspace (require super admin)
operationId: deleteWorkspace
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/leave:
post:
summary: leave workspace
operationId: leaveWorkspace
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/users/whois/{username}:
get:
summary: whois
operationId: whois
tags:
- user
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: username
in: path
required: true
schema:
type: string
responses:
'200':
description: user
content:
application/json:
schema:
type: object
properties: *ref_8
required: *ref_9
/users/exists/{email}:
get:
summary: exists email
operationId: existsEmail
tags:
- user
parameters:
- name: email
in: path
required: true
schema:
type: string
responses:
'200':
description: user
content:
application/json:
schema:
type: boolean
/users/list_as_super_admin:
get:
summary: list all users as super admin (require to be super amdin)
operationId: listUsersAsSuperAdmin
tags:
- user
parameters:
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: user
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_10
required: *ref_11
/w/{workspace}/workspaces/list_pending_invites:
get:
summary: list pending invites for a workspace
operationId: listPendingInvites
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: user
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_12
required: *ref_13
/w/{workspace}/workspaces/get_settings:
get:
summary: get settings
operationId: getSettings
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: object
properties:
workspace_id:
type: string
slack_name:
type: string
slack_team_id:
type: string
slack_command_script:
type: string
auto_invite_domain:
type: string
auto_invite_operator:
type: boolean
auto_add:
type: boolean
plan:
type: string
customer_id:
type: string
webhook:
type: string
deploy_to:
type: string
openai_resource_path:
type: string
code_completion_enabled:
type: boolean
error_handler:
type: string
error_handler_extra_args:
type: object
additionalProperties: &ref_14 {}
error_handler_muted_on_cancel:
type: boolean
large_file_storage:
type: object
properties: &ref_15
type:
type: string
enum:
- S3Storage
- AzureBlobStorage
s3_resource_path:
type: string
azure_blob_resource_path:
type: string
public_resource:
type: boolean
git_sync:
type: object
properties: &ref_16
include_path:
type: array
items:
type: string
include_type:
type: array
items:
type: string
enum:
- script
- flow
- app
- folder
- resource
- variable
- secret
- resourcetype
- schedule
repositories:
type: array
items:
type: object
properties: &ref_174
script_path:
type: string
git_repo_resource_path:
type: string
use_individual_branch:
type: boolean
required: &ref_175
- script_path
- git_repo_resource_path
default_app:
type: string
required:
- code_completion_enabled
/w/{workspace}/workspaces/get_deploy_to:
get:
summary: get deploy to
operationId: getDeployTo
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: object
properties:
deploy_to:
type: string
/w/{workspace}/workspaces/is_premium:
get:
summary: get if workspace is premium
operationId: getIsPremium
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: boolean
/w/{workspace}/workspaces/premium_info:
get:
summary: get premium info
operationId: getPremiumInfo
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: object
properties:
premium:
type: boolean
usage:
type: number
seats:
type: number
required:
- premium
/w/{workspace}/workspaces/edit_slack_command:
post:
summary: edit slack command
operationId: editSlackCommand
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceInvite
required: true
content:
application/json:
schema:
type: object
properties:
slack_command_script:
type: string
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/run_slack_message_test_job:
post:
summary: run a job that sends a message to Slack
operationId: runSlackMessageTestJob
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: path to hub script to run and its corresponding args
required: true
content:
application/json:
schema:
type: object
properties:
hub_script_path:
type: string
channel:
type: string
test_msg:
type: string
responses:
'200':
description: status
content:
text/json:
schema:
type: object
properties:
job_uuid:
type: string
/w/{workspace}/workspaces/edit_deploy_to:
post:
summary: edit deploy to
operationId: editDeployTo
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
deploy_to:
type: string
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/edit_auto_invite:
post:
summary: edit auto invite
operationId: editAutoInvite
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceInvite
required: true
content:
application/json:
schema:
type: object
properties:
operator:
type: boolean
invite_all:
type: boolean
auto_add:
type: boolean
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/edit_webhook:
post:
summary: edit webhook
operationId: editWebhook
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceWebhook
required: true
content:
application/json:
schema:
type: object
properties:
webhook:
type: string
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/edit_copilot_config:
post:
summary: edit copilot config
operationId: editCopilotConfig
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceCopilotConfig
required: true
content:
application/json:
schema:
type: object
required:
- code_completion_enabled
properties:
openai_resource_path:
type: string
code_completion_enabled:
type: boolean
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/get_copilot_info:
get:
summary: get copilot info
operationId: getCopilotInfo
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
text/plain:
schema:
type: object
properties:
exists_openai_resource_path:
type: boolean
code_completion_enabled:
type: boolean
required:
- exists_openai_resource_path
- code_completion_enabled
/w/{workspace}/workspaces/edit_error_handler:
post:
summary: edit error handler
operationId: editErrorHandler
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: WorkspaceErrorHandler
required: true
content:
application/json:
schema:
type: object
properties:
error_handler:
type: string
error_handler_extra_args:
type: object
additionalProperties: *ref_14
error_handler_muted_on_cancel:
type: boolean
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/edit_large_file_storage_config:
post:
summary: edit large file storage settings
operationId: editLargeFileStorageConfig
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: LargeFileStorage info
required: true
content:
application/json:
schema:
type: object
properties:
large_file_storage:
type: object
properties: *ref_15
responses:
'200':
description: status
content:
application/json:
schema: {}
/w/{workspace}/workspaces/edit_git_sync_config:
post:
summary: edit workspace git sync settings
operationId: editWorkspaceGitSyncConfig
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: Workspace Git sync settings
required: true
content:
application/json:
schema:
type: object
properties:
git_sync_settings:
type: object
properties: *ref_16
responses:
'200':
description: status
content:
application/json:
schema: {}
/w/{workspace}/workspaces/edit_default_app:
post:
summary: edit default app for workspace
operationId: editWorkspaceDefaultApp
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: Workspace default app
required: true
content:
application/json:
schema:
type: object
properties:
default_app_path:
type: string
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/encryption_key:
get:
summary: retrieves the encryption key for this workspace
operationId: getWorkspaceEncryptionKey
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: object
properties:
key:
type: string
required:
- key
post:
summary: update the encryption key for this workspace
operationId: setWorkspaceEncryptionKey
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: New encryption key
required: true
content:
application/json:
schema:
type: object
properties:
new_key:
type: string
required:
- new_key
responses:
'200':
description: status
content:
text/plain:
schema:
type: string
/w/{workspace}/workspaces/default_app:
get:
summary: get default app for workspace
operationId: getWorkspaceDefaultApp
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: object
properties:
default_app_path:
type: string
/w/{workspace}/workspaces/get_large_file_storage_config:
get:
summary: get large file storage config
operationId: getLargeFileStorageConfig
tags:
- workspace
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: status
content:
application/json:
schema:
type: object
properties: *ref_15
/w/{workspace}/users/list:
get:
summary: list users
operationId: listUsers
tags:
- user
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: user
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_8
required: *ref_9
/w/{workspace}/users/list_usernames:
get:
summary: list usernames
operationId: listUsernames
tags:
- user
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: user
content:
application/json:
schema:
type: array
items:
type: string
/users/tokens/create:
post:
summary: create token
operationId: createToken
tags:
- user
requestBody:
description: new token
required: true
content:
application/json:
schema:
type: object
properties: &ref_126
label:
type: string
expiration:
type: string
format: date-time
scopes:
type: array
items:
type: string
responses:
'201':
description: token created
content:
text/plain:
schema:
type: string
/users/tokens/impersonate:
post:
summary: create token to impersonate a user (require superadmin)
operationId: createTokenImpersonate
tags:
- user
requestBody:
description: new token
required: true
content:
application/json:
schema:
type: object
properties: &ref_127
label:
type: string
expiration:
type: string
format: date-time
impersonate_email:
type: string
required: &ref_128
- impersonate_email
responses:
'201':
description: token created
content:
text/plain:
schema:
type: string
/users/tokens/delete/{token_prefix}:
delete:
summary: delete token
operationId: deleteToken
tags:
- user
parameters:
- name: token_prefix
in: path
required: true
schema:
type: string
responses:
'200':
description: delete token
content:
text/plain:
schema:
type: string
/users/tokens/list:
get:
summary: list token
operationId: listTokens
tags:
- user
parameters:
- name: exclude_ephemeral
in: query
schema:
type: boolean
responses:
'200':
description: truncated token
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_124
label:
type: string
expiration:
type: string
format: date-time
token_prefix:
type: string
created_at:
type: string
format: date-time
last_used_at:
type: string
format: date-time
scopes:
type: array
items:
type: string
required: &ref_125
- token_prefix
- created_at
- last_used_at
/w/{workspace}/oidc/token/{audience}:
post:
summary: get OIDC token (ee only)
operationId: getOidcToken
tags:
- oidc
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: audience
in: path
required: true
schema:
type: string
responses:
'200':
description: new oidc token
content:
text/plain:
schema:
type: string
/w/{workspace}/variables/create:
post:
summary: create variable
operationId: createVariable
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: already_encrypted
in: query
schema:
type: boolean
requestBody:
description: new variable
required: true
content:
application/json:
schema:
type: object
properties: &ref_131
path:
type: string
value:
type: string
is_secret:
type: boolean
description:
type: string
account:
type: integer
is_oauth:
type: boolean
required: &ref_132
- path
- value
- is_secret
- description
responses:
'201':
description: variable created
content:
text/plain:
schema:
type: string
/w/{workspace}/variables/encrypt:
post:
summary: encrypt value
operationId: encryptValue
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: new variable
required: true
content:
application/json:
schema:
type: string
responses:
'200':
description: encrypted value
content:
text/plain:
schema:
type: string
/w/{workspace}/variables/delete/{path}:
delete:
summary: delete variable
operationId: deleteVariable
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: variable deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/variables/update/{path}:
post:
summary: update variable
operationId: updateVariable
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: already_encrypted
in: query
schema:
type: boolean
requestBody:
description: updated variable
required: true
content:
application/json:
schema:
type: object
properties: &ref_133
path:
type: string
value:
type: string
is_secret:
type: boolean
description:
type: string
responses:
'200':
description: variable updated
content:
text/plain:
schema:
type: string
/w/{workspace}/variables/get/{path}:
get:
summary: get variable
operationId: getVariable
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: decrypt_secret
description: |
ask to decrypt secret if this variable is secret
(if not secret no effect, default: true)
in: query
schema:
type: boolean
- name: include_encrypted
description: >
ask to include the encrypted value if secret and decrypt secret is
not true (default: false)
in: query
schema:
type: boolean
responses:
'200':
description: variable
content:
application/json:
schema:
type: object
properties: &ref_18
workspace_id:
type: string
path:
type: string
value:
type: string
is_secret:
type: boolean
description:
type: string
account:
type: integer
is_oauth:
type: boolean
extra_perms:
type: object
additionalProperties:
type: boolean
is_expired:
type: boolean
refresh_error:
type: string
is_linked:
type: boolean
is_refreshed:
type: boolean
required: &ref_19
- workspace_id
- path
- is_secret
- extra_perms
/w/{workspace}/variables/get_value/{path}:
get:
summary: get variable value
operationId: getVariableValue
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: variable
content:
application/json:
schema:
type: string
/w/{workspace}/variables/exists/{path}:
get:
summary: does variable exists at path
operationId: existsVariable
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: variable
content:
application/json:
schema:
type: boolean
/w/{workspace}/variables/list:
get:
summary: list variables
operationId: listVariable
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: variable list
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_18
required: *ref_19
/w/{workspace}/variables/list_contextual:
get:
summary: list contextual variables
operationId: listContextualVariables
tags:
- variable
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: contextual variable list
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_129
name:
type: string
value:
type: string
description:
type: string
required: &ref_130
- name
- value
- description
/oauth/login_callback/{client_name}:
post:
security: []
summary: login with oauth authorization flow
operationId: loginWithOauth
tags:
- user
parameters:
- name: client_name
in: path
required: true
schema: &ref_20
type: string
requestBody:
description: Partially filled script
required: true
content:
application/json:
schema:
type: object
properties:
code:
type: string
state:
type: string
responses:
'200':
description: >
Successfully authenticated. The session ID is returned in a cookie
named `token` and as plaintext response. Preferred method of
authorization is through the bearer token. The cookie is only for
browser convenience.
headers:
Set-Cookie:
schema:
type: string
example: token=abcde12345; Path=/; HttpOnly
content:
text/plain:
schema:
type: string
/w/{workspace}/oauth/connect_slack_callback:
post:
summary: connect slack callback
operationId: connectSlackCallback
tags:
- oauth
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: code endpoint
required: true
content:
application/json:
schema:
type: object
properties:
code:
type: string
state:
type: string
required:
- code
- state
responses:
'200':
description: slack token
content:
text/plain:
schema:
type: string
/oauth/connect_callback/{client_name}:
post:
summary: connect callback
operationId: connectCallback
tags:
- oauth
parameters:
- name: client_name
in: path
required: true
schema: *ref_20
requestBody:
description: code endpoint
required: true
content:
application/json:
schema:
type: object
properties:
code:
type: string
state:
type: string
required:
- code
- state
responses:
'200':
description: oauth token
content:
application/json:
schema:
type: object
properties: &ref_167
access_token:
type: string
expires_in:
type: integer
refresh_token:
type: string
scope:
type: array
items:
type: string
required: &ref_168
- access_token
/w/{workspace}/oauth/create_account:
post:
summary: create OAuth account
operationId: createAccount
tags:
- oauth
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: code endpoint
required: true
content:
application/json:
schema:
type: object
properties:
refresh_token:
type: string
expires_in:
type: integer
client:
type: string
required:
- expires_in
- client
responses:
'200':
description: account set
content:
text/plain:
schema:
type: string
/w/{workspace}/oauth/refresh_token/{id}:
post:
summary: refresh token
operationId: refreshToken
tags:
- oauth
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: &ref_21
type: integer
requestBody:
description: variable path
required: true
content:
application/json:
schema:
type: object
properties:
path:
type: string
required:
- path
responses:
'200':
description: token refreshed
content:
text/plain:
schema:
type: string
/w/{workspace}/oauth/disconnect/{id}:
post:
summary: disconnect account
operationId: disconnectAccount
tags:
- oauth
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_21
responses:
'200':
description: disconnected client
content:
text/plain:
schema:
type: string
/w/{workspace}/oauth/disconnect_slack:
post:
summary: disconnect slack
operationId: disconnectSlack
tags:
- oauth
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: disconnected slack
content:
text/plain:
schema:
type: string
/oauth/list_logins:
get:
summary: list oauth logins
operationId: listOAuthLogins
tags:
- oauth
responses:
'200':
description: list of oauth and saml login clients
content:
application/json:
schema:
type: object
properties:
oauth:
type: array
items:
type: string
saml:
type: string
required:
- oauth
/oauth/list_connects:
get:
summary: list oauth connects
operationId: listOAuthConnects
tags:
- oauth
responses:
'200':
description: list of oauth connects clients
content:
application/json:
schema:
additionalProperties:
type: object
properties:
extra_params:
additionalProperties:
type: string
scopes:
type: array
items:
type: string
/w/{workspace}/resources/create:
post:
summary: create resource
operationId: createResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: update_if_exists
in: query
schema:
type: boolean
requestBody:
description: new resource
required: true
content:
application/json:
schema:
type: object
properties: &ref_136
path:
type: string
value: {}
description:
type: string
resource_type:
type: string
required: &ref_137
- path
- value
- resource_type
responses:
'201':
description: resource created
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/delete/{path}:
delete:
summary: delete resource
operationId: deleteResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: resource deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/update/{path}:
post:
summary: update resource
operationId: updateResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
requestBody:
description: updated resource
required: true
content:
application/json:
schema:
type: object
properties: &ref_138
path:
type: string
description:
type: string
value: {}
responses:
'200':
description: resource updated
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/update_value/{path}:
post:
summary: update resource value
operationId: updateResourceValue
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
requestBody:
description: updated resource
required: true
content:
application/json:
schema:
type: object
properties:
value: {}
responses:
'200':
description: resource value updated
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/get/{path}:
get:
summary: get resource
operationId: getResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: resource
content:
application/json:
schema:
type: object
properties: &ref_139
workspace_id:
type: string
path:
type: string
description:
type: string
resource_type:
type: string
value: {}
is_oauth:
type: boolean
extra_perms:
type: object
additionalProperties:
type: boolean
required: &ref_140
- path
- resource_type
- is_oauth
/w/{workspace}/resources/get_value_interpolated/{path}:
get:
summary: get resource interpolated (variables and resources are fully unrolled)
operationId: getResourceValueInterpolated
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: job_id
description: job id
in: query
schema:
type: string
format: uuid
responses:
'200':
description: resource value
content:
application/json:
schema: {}
/w/{workspace}/resources/get_value/{path}:
get:
summary: get resource value
operationId: getResourceValue
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: resource value
content:
application/json:
schema: {}
/w/{workspace}/resources/exists/{path}:
get:
summary: does resource exists
operationId: existsResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: does resource exists
content:
application/json:
schema:
type: boolean
/w/{workspace}/resources/list:
get:
summary: list resources
operationId: listResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: resource_type
description: resource_types to list from, separated by ',',
in: query
schema:
type: string
- name: resource_type_exclude
description: resource_types to not list from, separated by ',',
in: query
schema:
type: string
responses:
'200':
description: resource list
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_141
workspace_id:
type: string
path:
type: string
description:
type: string
resource_type:
type: string
value: {}
is_oauth:
type: boolean
extra_perms:
type: object
additionalProperties:
type: boolean
is_expired:
type: boolean
refresh_error:
type: string
is_linked:
type: boolean
is_refreshed:
type: boolean
account:
type: number
required: &ref_142
- path
- resource_type
- is_oauth
- is_linked
- is_refreshed
/w/{workspace}/resources/list_search:
get:
summary: list resources for search
operationId: listSearchResource
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: resource list
content:
application/json:
schema:
type: array
items:
type: object
properties:
path:
type: string
value: {}
required:
- path
- value
/w/{workspace}/resources/list_names/{name}:
get:
summary: list resource names
operationId: listResourceNames
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: &ref_80
type: string
responses:
'200':
description: resource list names
content:
application/json:
schema:
type: array
items:
type: object
properties:
name:
type: string
path:
type: string
required:
- name
- path
/w/{workspace}/resources/type/create:
post:
summary: create resource_type
operationId: createResourceType
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: new resource_type
required: true
content:
application/json:
schema:
type: object
properties: &ref_22
workspace_id:
type: string
name:
type: string
schema: {}
description:
type: string
required: &ref_23
- name
responses:
'201':
description: resource_type created
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/type/delete/{path}:
delete:
summary: delete resource_type
operationId: deleteResourceType
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: resource_type deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/type/update/{path}:
post:
summary: update resource_type
operationId: updateResourceType
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
requestBody:
description: updated resource_type
required: true
content:
application/json:
schema:
type: object
properties: &ref_143
schema: {}
description:
type: string
responses:
'200':
description: resource_type updated
content:
text/plain:
schema:
type: string
/w/{workspace}/resources/type/get/{path}:
get:
summary: get resource_type
operationId: getResourceType
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: resource_type deleted
content:
application/json:
schema:
type: object
properties: *ref_22
required: *ref_23
/w/{workspace}/resources/type/exists/{path}:
get:
summary: does resource_type exists
operationId: existsResourceType
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: does resource_type exist
content:
application/json:
schema:
type: boolean
/w/{workspace}/resources/type/list:
get:
summary: list resource_types
operationId: listResourceType
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: resource_type list
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_22
required: *ref_23
/w/{workspace}/resources/type/listnames:
get:
summary: list resource_types names
operationId: listResourceTypeNames
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: resource_type list
content:
application/json:
schema:
type: array
items:
type: string
/w/{workspace}/embeddings/query_resource_types:
get:
summary: query resource types by similarity
operationId: queryResourceTypes
tags:
- resource
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: text
description: query text
in: query
required: true
schema:
type: string
- name: limit
description: query limit
in: query
required: false
schema:
type: number
responses:
'200':
description: resource type details
content:
application/json:
schema:
type: array
items:
type: object
properties:
name:
type: string
score:
type: number
schema: {}
required:
- name
- score
/integrations/hub/list:
get:
summary: list hub integrations
operationId: listHubIntegrations
tags:
- integration
parameters:
- name: kind
description: query integrations kind
in: query
required: false
schema:
type: string
responses:
'200':
description: integrations details
content:
application/json:
schema:
type: array
items:
type: object
properties:
name:
type: string
required:
- name
/flows/hub/list:
get:
summary: list all hub flows
operationId: listHubFlows
tags:
- flow
responses:
'200':
description: hub flows list
content:
application/json:
schema:
type: object
properties:
flows:
type: array
items:
type: object
properties:
id:
type: number
flow_id:
type: number
summary:
type: string
apps:
type: array
items:
type: string
approved:
type: boolean
votes:
type: number
required:
- id
- flow_id
- summary
- apps
- approved
- votes
/flows/hub/get/{id}:
get:
summary: get hub flow by id
operationId: getHubFlowById
tags:
- flow
parameters:
- name: id
in: path
required: true
schema: *ref_24
responses:
'200':
description: flow
content:
application/json:
schema:
type: object
properties:
flow:
type: object
properties: &ref_43
summary:
type: string
description:
type: string
value:
type: object
properties: &ref_50
modules:
type: array
items:
type: object
properties: &ref_27
id:
type: string
value:
oneOf: &ref_206
- type: object
properties: &ref_192
input_transforms:
type: object
additionalProperties:
oneOf: &ref_25
- type: object
properties: &ref_188
value: {}
type:
type: string
enum:
- javascript
required: &ref_189
- expr
- type
- type: object
properties: &ref_190
expr:
type: string
type:
type: string
enum:
- javascript
required: &ref_191
- expr
- type
discriminator: &ref_26
propertyName: type
mapping:
static: '#/components/schemas/StaticTransform'
javascript: '#/components/schemas/JavascriptTransform'
content:
type: string
language:
type: string
enum:
- deno
- bun
- python3
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
path:
type: string
lock:
type: string
type:
type: string
enum:
- rawscript
tag:
type: string
concurrent_limit:
type: number
concurrency_time_window_s:
type: number
required: &ref_193
- type
- content
- language
- input_transforms
- type: object
properties: &ref_194
input_transforms:
type: object
additionalProperties:
oneOf: *ref_25
discriminator: *ref_26
path:
type: string
hash:
type: string
type:
type: string
enum:
- script
required: &ref_195
- type
- path
- input_transforms
- type: object
properties: &ref_196
input_transforms:
type: object
additionalProperties:
oneOf: *ref_25
discriminator: *ref_26
path:
type: string
type:
type: string
enum:
- flow
required: &ref_197
- type
- path
- input_transforms
- type: object
properties: &ref_198
modules:
type: array
items:
type: object
properties: *ref_27
required: &ref_28
- value
- id
iterator:
oneOf: *ref_25
discriminator: *ref_26
skip_failures:
type: boolean
type:
type: string
enum:
- forloopflow
parallel:
type: boolean
parallelism:
type: integer
required: &ref_199
- modules
- iterator
- skip_failures
- type
- type: object
properties: &ref_200
branches:
type: array
items:
type: object
properties:
summary:
type: string
expr:
type: string
modules:
type: array
items:
type: object
properties: *ref_27
required: *ref_28
required:
- modules
- expr
default:
type: array
items:
type: object
properties: *ref_27
required: *ref_28
required:
- modules
type:
type: string
enum:
- branchone
required: &ref_201
- branches
- default
- type
- type: object
properties: &ref_202
branches:
type: array
items:
type: object
properties:
summary:
type: string
skip_failure:
type: boolean
modules:
type: array
items:
type: object
properties: *ref_27
required: *ref_28
required:
- modules
- expr
type:
type: string
enum:
- branchall
parallel:
type: boolean
required: &ref_203
- branches
- type
- type: object
properties: &ref_204
type:
type: string
enum:
- identity
flow:
type: boolean
required: &ref_205
- type
discriminator: &ref_207
propertyName: type
mapping:
rawscript: '#/components/schemas/RawScript'
script: '#/components/schemas/PathScript'
flow: '#/components/schemas/PathFlow'
forloopflow: '#/components/schemas/ForloopFlow'
branchone: '#/components/schemas/BranchOne'
branchall: '#/components/schemas/BranchAll'
identity: '#/components/schemas/Identity'
stop_after_if:
type: object
properties:
skip_if_stopped:
type: boolean
expr:
type: string
required:
- expr
sleep:
oneOf: *ref_25
discriminator: *ref_26
cache_ttl:
type: number
timeout:
type: number
delete_after_use:
type: boolean
summary:
type: string
mock:
type: object
properties:
enabled:
type: boolean
return_value: {}
suspend:
type: object
properties:
required_events:
type: integer
timeout:
type: integer
resume_form:
type: object
properties:
schema:
type: object
user_auth_required:
type: boolean
user_groups_required:
oneOf: *ref_25
discriminator: *ref_26
self_approval_disabled:
type: boolean
priority:
type: number
retry:
type: object
properties: &ref_77
constant:
type: object
properties:
attempts:
type: integer
seconds:
type: integer
exponential:
type: object
properties:
attempts:
type: integer
multiplier:
type: integer
seconds:
type: integer
random_factor:
type: integer
minimum: 0
maximum: 100
required: *ref_28
failure_module:
type: object
properties: *ref_27
required: *ref_28
same_worker:
type: boolean
concurrent_limit:
type: number
concurrency_time_window_s:
type: number
skip_expr:
type: string
cache_ttl:
type: number
priority:
type: number
early_return:
type: string
required: &ref_51
- modules
schema:
type: object
required: &ref_44
- summary
- value
/apps/hub/list:
get:
summary: list all hub apps
operationId: listHubApps
tags:
- app
responses:
'200':
description: hub apps list
content:
application/json:
schema:
type: object
properties:
apps:
type: array
items:
type: object
properties:
id:
type: number
app_id:
type: number
summary:
type: string
apps:
type: array
items:
type: string
approved:
type: boolean
votes:
type: number
required:
- id
- app_id
- summary
- apps
- approved
- votes
/apps/hub/get/{id}:
get:
summary: get hub app by id
operationId: getHubAppById
tags:
- app
parameters:
- name: id
in: path
required: true
schema: *ref_24
responses:
'200':
description: app
content:
application/json:
schema:
type: object
properties:
app:
type: object
properties:
summary:
type: string
value: {}
required:
- summary
- value
required:
- app
/scripts/hub/get/{path}:
get:
summary: get hub script content by path
operationId: getHubScriptContentByPath
tags:
- script
parameters:
- name: path
in: path
required: true
schema: &ref_29
type: string
responses:
'200':
description: script details
content:
text/plain:
schema:
type: string
/scripts/hub/get_full/{path}:
get:
summary: get full hub script by path
operationId: getHubScriptByPath
tags:
- script
parameters:
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script details
content:
application/json:
schema:
type: object
properties:
content:
type: string
lockfile:
type: string
schema: {}
language:
type: string
summary:
type: string
required:
- content
- language
/scripts/hub/top:
get:
summary: get top hub scripts
operationId: getTopHubScripts
tags:
- script
parameters:
- name: limit
description: query limit
in: query
required: false
schema:
type: number
- name: app
description: query scripts app
in: query
required: false
schema:
type: string
- name: kind
description: query scripts kind
in: query
required: false
schema:
type: string
responses:
'200':
description: hub scripts list
content:
application/json:
schema:
type: object
properties:
asks:
type: array
items:
type: object
properties:
id:
type: number
ask_id:
type: number
summary:
type: string
app:
type: string
version_id:
type: number
kind:
name: kind
schema: &ref_30
type: string
enum:
- script
- failure
- trigger
- approval
votes:
type: number
views:
type: number
required:
- id
- ask_id
- summary
- app
- version_id
- kind
- views
- votes
/embeddings/query_hub_scripts:
get:
summary: query hub scripts by similarity
operationId: queryHubScripts
tags:
- script
parameters:
- name: text
description: query text
in: query
required: true
schema:
type: string
- name: kind
description: query scripts kind
in: query
required: false
schema:
type: string
- name: limit
description: query limit
in: query
required: false
schema:
type: number
- name: app
description: query scripts app
in: query
required: false
schema:
type: string
responses:
'200':
description: script details
content:
application/json:
schema:
type: array
items:
type: object
properties:
ask_id:
type: number
id:
type: number
version_id:
type: number
summary:
type: string
app:
type: string
kind:
name: kind
schema: *ref_30
score:
type: number
required:
- ask_id
- id
- version_id
- summary
- app
- kind
- score
/w/{workspace}/scripts/list_search:
get:
summary: list scripts for search
operationId: listSearchScript
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: script list
content:
application/json:
schema:
type: array
items:
type: object
properties:
path:
type: string
content:
type: string
required:
- path
- content
/w/{workspace}/scripts/list:
get:
summary: list all scripts
operationId: listScripts
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: order_desc
description: order by desc order (default true)
in: query
schema: &ref_41
type: boolean
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: &ref_42
type: string
- name: path_start
description: mask to filter matching starting path
in: query
schema:
type: string
- name: path_exact
description: mask to filter exact matching path
in: query
schema:
type: string
- name: first_parent_hash
description: mask to filter scripts whom first direct parent has exact hash
in: query
schema:
type: string
- name: last_parent_hash
description: >
mask to filter scripts whom last parent in the chain has exact
hash.
Beware that each script stores only a limited number of parents.
Hence
the last parent hash for a script is not necessarily its top-most
parent.
To find the top-most parent you will have to jump from last to last
hash
until finding the parent
in: query
schema:
type: string
- name: parent_hash
description: >
is the hash present in the array of stored parent hashes for this
script.
The same warning applies than for last_parent_hash. A script only
store a
limited number of direct parent
in: query
schema:
type: string
- name: show_archived
description: >
(default false)
show also the archived files.
when multiple archived hash share the same path, only the ones with
the latest create_at
are
ed.
in: query
schema:
type: boolean
- name: is_template
description: |
(default regardless)
if true show only the templates
if false show only the non templates
if not defined, show all regardless of if the script is a template
in: query
schema:
type: boolean
- name: kinds
description: |
(default regardless)
script kinds to filter, split by comma
in: query
schema:
type: string
- name: starred_only
description: |
(default false)
show only the starred items
in: query
schema:
type: boolean
responses:
'200':
description: All scripts
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_31
workspace_id:
type: string
hash:
type: string
path:
type: string
parent_hashes:
type: array
description: >
The first element is the direct parent of the script,
the second is the parent of the first, etc
items:
type: string
summary:
type: string
description:
type: string
content:
type: string
created_by:
type: string
created_at:
type: string
format: date-time
archived:
type: boolean
schema:
type: object
deleted:
type: boolean
is_template:
type: boolean
extra_perms:
type: object
additionalProperties:
type: boolean
lock:
type: string
lock_error_logs:
type: string
language:
type: string
enum:
- python3
- deno
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
- bun
kind:
type: string
enum:
- script
- failure
- trigger
- command
- approval
starred:
type: boolean
tag:
type: string
has_draft:
type: boolean
draft_only:
type: boolean
envs:
type: array
items:
type: string
concurrent_limit:
type: integer
concurrency_time_window_s:
type: integer
cache_ttl:
type: number
dedicated_worker:
type: boolean
ws_error_handler_muted:
type: boolean
priority:
type: integer
restart_unless_cancelled:
type: boolean
timeout:
type: integer
delete_after_use:
type: boolean
required: &ref_32
- hash
- path
- summary
- description
- content
- created_by
- created_at
- archived
- deleted
- is_template
- extra_perms
- language
- kind
- starred
/w/{workspace}/scripts/list_paths:
get:
summary: list all scripts paths
operationId: listScriptPaths
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: list of script paths
content:
text/plain:
schema:
type: array
items:
type: string
/w/{workspace}/drafts/create:
post:
summary: create draft
operationId: createDraft
tags:
- draft
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
path:
type: string
typ:
type: string
enum:
- flow
- script
- app
value: {}
required:
- path
- typ
- enum
responses:
'201':
description: draft created
content:
text/plain:
schema:
type: string
/w/{workspace}/drafts/delete/{kind}/{path}:
delete:
summary: delete draft
operationId: deleteDraft
tags:
- draft
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: kind
in: path
required: true
schema:
type: string
enum:
- script
- flow
- app
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: draft deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/scripts/create:
post:
summary: create script
operationId: createScript
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: Partially filled script
required: true
content:
application/json:
schema:
type: object
properties: &ref_34
path:
type: string
parent_hash:
type: string
summary:
type: string
description:
type: string
content:
type: string
schema:
type: object
is_template:
type: boolean
lock:
type: string
language:
type: string
enum:
- python3
- deno
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
- bun
kind:
type: string
enum:
- script
- failure
- trigger
- command
- approval
tag:
type: string
draft_only:
type: boolean
envs:
type: array
items:
type: string
concurrent_limit:
type: integer
concurrency_time_window_s:
type: integer
cache_ttl:
type: number
dedicated_worker:
type: boolean
ws_error_handler_muted:
type: boolean
priority:
type: integer
restart_unless_cancelled:
type: boolean
timeout:
type: integer
delete_after_use:
type: boolean
deployment_message:
type: string
concurrency_key:
type: string
required: &ref_35
- path
- summary
- description
- content
- language
responses:
'201':
description: script created
content:
text/plain:
schema:
type: string
/w/{workspace}/scripts/toggle_workspace_error_handler/p/{path}:
post:
summary: Toggle ON and OFF the workspace error handler for a given script
operationId: toggleWorkspaceErrorHandlerForScript
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: Workspace error handler enabled
required: true
content:
application/json:
schema:
type: object
properties:
muted:
type: boolean
responses:
'200':
description: error handler toggled
content:
text/plain:
schema:
type: string
/workers/custom_tags:
get:
summary: >-
get all instance custom tags (tags are used to dispatch jobs to
different worker groups)
operationId: getCustomTags
tags:
- worker
responses:
'200':
description: list of custom tags
content:
application/json:
schema:
type: array
items:
type: string
/workers/get_default_tags:
get:
summary: get all instance default tags
operationId: geDefaultTags
tags:
- worker
responses:
'200':
description: list of default tags
content:
application/json:
schema:
type: array
items:
type: string
/workers/is_default_tags_per_workspace:
get:
summary: is default tags per workspace
operationId: isDefaultTagsPerWorkspace
tags:
- worker
responses:
'200':
description: is the default tags per workspace
content:
application/json:
schema:
type: boolean
/w/{workspace}/scripts/archive/p/{path}:
post:
summary: archive script by path
operationId: archiveScriptByPath
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script archived
content:
text/plain:
schema:
type: string
/w/{workspace}/scripts/archive/h/{hash}:
post:
summary: archive script by hash
operationId: archiveScriptByHash
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: hash
in: path
required: true
schema: &ref_33
type: string
responses:
'200':
description: script details
content:
application/json:
schema:
type: object
properties: *ref_31
required: *ref_32
/w/{workspace}/scripts/delete/h/{hash}:
post:
summary: delete script by hash (erase content but keep hash, require admin)
operationId: deleteScriptByHash
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: hash
in: path
required: true
schema: *ref_33
responses:
'200':
description: script details
content:
application/json:
schema:
type: object
properties: *ref_31
required: *ref_32
/w/{workspace}/scripts/delete/p/{path}:
post:
summary: delete all scripts at a given path (require admin)
operationId: deleteScriptByPath
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script path
content:
application/json:
schema:
type: string
/w/{workspace}/scripts/get/p/{path}:
get:
summary: get script by path
operationId: getScriptByPath
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script details
content:
application/json:
schema:
type: object
properties: *ref_31
required: *ref_32
/w/{workspace}/scripts/get/draft/{path}:
get:
summary: get script by path with draft
operationId: getScriptByPathWithDraft
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script details
content:
application/json:
schema:
allOf: &ref_110
- type: object
properties: *ref_34
required: *ref_35
- type: object
properties:
draft:
type: object
properties: *ref_34
required: *ref_35
hash:
type: string
required:
- hash
/w/{workspace}/scripts/history/p/{path}:
get:
summary: get history of a script by path
operationId: getScriptHistoryByPath
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script history
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_111
script_hash:
type: string
deployment_msg:
type: string
required: &ref_112
- script_hash
/w/{workspace}/scripts/history_update/h/{hash}/p/{path}:
post:
summary: update history of a script
operationId: updateScriptHistory
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: hash
in: path
required: true
schema: *ref_33
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: Script deployment message
required: true
content:
application/json:
schema:
type: object
properties:
deployment_msg:
type: string
responses:
'200':
description: success
content:
text/plain:
schema:
type: string
/w/{workspace}/scripts/raw/p/{path}:
get:
summary: raw script by path
operationId: rawScriptByPath
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script content
content:
text/plain:
schema:
type: string
/scripts_u/tokened_raw/{workspace}/{token}/{path}:
get:
summary: >-
raw script by path with a token (mostly used by lsp to be used with
import maps to resolve scripts)
operationId: rawScriptByPathTokened
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: token
in: path
required: true
schema: &ref_96
type: string
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script content
content:
text/plain:
schema:
type: string
/w/{workspace}/scripts/exists/p/{path}:
get:
summary: exists script by path
operationId: existsScriptByPath
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: does it exists
content:
application/json:
schema:
type: boolean
/w/{workspace}/scripts/get/h/{hash}:
get:
summary: get script by hash
operationId: getScriptByHash
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: hash
in: path
required: true
schema: *ref_33
responses:
'200':
description: script details
content:
application/json:
schema:
type: object
properties: *ref_31
required: *ref_32
/w/{workspace}/scripts/raw/h/{path}:
get:
summary: raw script by hash
operationId: rawScriptByHash
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: script content
content:
text/plain:
schema:
type: string
/w/{workspace}/scripts/deployment_status/h/{hash}:
get:
summary: get script deployment status
operationId: getScriptDeploymentStatus
tags:
- script
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: hash
in: path
required: true
schema: *ref_33
responses:
'200':
description: script details
content:
application/json:
schema:
type: object
properties:
lock:
type: string
lock_error_logs:
type: string
/w/{workspace}/jobs/run/p/{path}:
post:
summary: run script by path
operationId: runScriptByPath
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: scheduled_for
description: when to schedule this job (leave empty for immediate run)
in: query
schema:
type: string
format: date-time
- name: scheduled_in_secs
description: schedule the script to execute in the number of seconds starting now
in: query
schema:
type: integer
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: &ref_36
type: string
format: uuid
- name: tag
description: Override the tag to use
in: query
schema: &ref_38
type: string
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: &ref_37
type: string
format: uuid
- name: invisible_to_owner
description: make the run invisible to the the script owner (default false)
in: query
schema:
type: boolean
requestBody:
description: script args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'201':
description: job created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/jobs/openai_sync/p/{path}:
post:
summary: run script by path in openai format
operationId: openaiSyncScriptByPath
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: &ref_39
type: string
- name: queue_limit
description: >
The maximum size of the queue for which the request would get
rejected if that job would push it above that limit
in: query
schema: &ref_40
type: string
requestBody:
description: script args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'200':
description: job result
content:
application/json:
schema: {}
/w/{workspace}/jobs/run_wait_result/p/{path}:
post:
summary: run script by path
operationId: runWaitResultScriptByPath
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: tag
description: Override the tag to use
in: query
schema: *ref_38
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: queue_limit
description: >
The maximum size of the queue for which the request would get
rejected if that job would push it above that limit
in: query
schema: *ref_40
requestBody:
description: script args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'200':
description: job result
content:
application/json:
schema: {}
get:
summary: run script by path with get
operationId: runWaitResultScriptByPathGet
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: tag
description: Override the tag to use
in: query
schema: *ref_38
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: queue_limit
description: >
The maximum size of the queue for which the request would get
rejected if that job would push it above that limit
in: query
schema: *ref_40
- name: payload
description: >
The base64 encoded payload that has been encoded as a JSON. e.g how
to encode such payload encodeURIComponent
`encodeURIComponent(btoa(JSON.stringify({a: 2})))`
in: query
schema: &ref_76
type: string
responses:
'200':
description: job result
content:
application/json:
schema: {}
/w/{workspace}/jobs/openai_sync/f/{path}:
post:
summary: run flow by path and wait until completion in openai format
operationId: openaiSyncFlowByPath
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: queue_limit
description: >
The maximum size of the queue for which the request would get
rejected if that job would push it above that limit
in: query
schema: *ref_40
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
requestBody:
description: script args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'200':
description: job result
content:
application/json:
schema: {}
/w/{workspace}/jobs/run_wait_result/f/{path}:
post:
summary: run flow by path and wait until completion
operationId: runWaitResultFlowByPath
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: queue_limit
description: >
The maximum size of the queue for which the request would get
rejected if that job would push it above that limit
in: query
schema: *ref_40
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
requestBody:
description: script args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'200':
description: job result
content:
application/json:
schema: {}
/w/{workspace}/jobs/result_by_id/{flow_job_id}/{node_id}:
get:
summary: get job result by id
operationId: resultById
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: flow_job_id
in: path
required: true
schema:
type: string
- name: node_id
in: path
required: true
schema:
type: string
responses:
'200':
description: job result
content:
application/json:
schema: {}
/w/{workspace}/flows/list_paths:
get:
summary: list all flow paths
operationId: listFlowPaths
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: list of flow paths
content:
text/plain:
schema:
type: array
items:
type: string
/w/{workspace}/flows/list_search:
get:
summary: list flows for search
operationId: listSearchFlow
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: flow list
content:
application/json:
schema:
type: array
items:
type: object
properties:
path:
type: string
value: {}
required:
- path
- value
/w/{workspace}/flows/list:
get:
summary: list all flows
operationId: listFlows
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: order_desc
description: order by desc order (default true)
in: query
schema: *ref_41
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
- name: path_start
description: mask to filter matching starting path
in: query
schema:
type: string
- name: path_exact
description: mask to filter exact matching path
in: query
schema:
type: string
- name: show_archived
description: >
(default false)
show also the archived files.
when multiple archived hash share the same path, only the ones with
the latest create_at
are displayed.
in: query
schema:
type: boolean
- name: starred_only
description: |
(default false)
show only the starred items
in: query
schema:
type: boolean
responses:
'200':
description: All flow
content:
application/json:
schema:
type: array
items:
allOf:
- allOf: &ref_45
- type: object
properties: *ref_43
required: *ref_44
- type: object
properties: &ref_155
workspace_id:
type: string
path:
type: string
edited_by:
type: string
edited_at:
type: string
format: date-time
archived:
type: boolean
extra_perms:
type: object
additionalProperties:
type: boolean
starred:
type: boolean
draft_only:
type: boolean
tag:
type: string
ws_error_handler_muted:
type: boolean
priority:
type: integer
dedicated_worker:
type: boolean
timeout:
type: number
required: &ref_156
- path
- edited_by
- edited_at
- archived
- extra_perms
- type: object
properties:
has_draft:
type: boolean
draft_only:
type: boolean
/w/{workspace}/flows/get/{path}:
get:
summary: get flow by path
operationId: getFlowByPath
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: flow details
content:
application/json:
schema:
allOf: *ref_45
/w/{workspace}/flows/toggle_workspace_error_handler/{path}:
post:
summary: Toggle ON and OFF the workspace error handler for a given flow
operationId: toggleWorkspaceErrorHandlerForFlow
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: Workspace error handler enabled
required: true
content:
application/json:
schema:
type: object
properties:
muted:
type: boolean
responses:
'200':
description: error handler toggled
content:
text/plain:
schema:
type: string
/w/{workspace}/flows/get/draft/{path}:
get:
summary: get flow by path with draft
operationId: getFlowByPathWithDraft
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: flow details with draft
content:
application/json:
schema:
allOf:
- allOf: *ref_45
- type: object
properties:
draft:
allOf: *ref_45
/w/{workspace}/flows/exists/{path}:
get:
summary: exists flow by path
operationId: existsFlowByPath
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: flow details
content:
application/json:
schema:
type: boolean
/w/{workspace}/flows/create:
post:
summary: create flow
operationId: createFlow
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: Partially filled flow
required: true
content:
application/json:
schema:
allOf:
- allOf: &ref_46
- type: object
properties: *ref_43
required: *ref_44
- type: object
properties:
path:
type: string
tag:
type: string
ws_error_handler_muted:
type: boolean
priority:
type: integer
dedicated_worker:
type: boolean
timeout:
type: number
required:
- path
- type: object
properties:
draft_only:
type: boolean
deployment_message:
type: string
responses:
'201':
description: flow created
content:
text/plain:
schema:
type: string
/w/{workspace}/flows/update/{path}:
post:
summary: update flow
operationId: updateFlow
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: Partially filled flow
required: true
content:
application/json:
schema:
allOf:
- allOf: *ref_46
- type: object
properties:
deployment_message:
type: string
responses:
'200':
description: flow updated
content:
text/plain:
schema:
type: string
/w/{workspace}/flows/archive/{path}:
post:
summary: archive flow by path
operationId: archiveFlowByPath
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: archiveFlow
required: true
content:
application/json:
schema:
type: object
properties:
archived:
type: boolean
responses:
'200':
description: flow archived
content:
text/plain:
schema:
type: string
/w/{workspace}/flows/delete/{path}:
delete:
summary: delete flow by path
operationId: deleteFlowByPath
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: flow delete
content:
text/plain:
schema:
type: string
/w/{workspace}/flows/input_history/p/{path}:
get:
summary: list inputs for previous completed flow jobs
operationId: getFlowInputHistoryByPath
tags:
- flow
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: input history for completed jobs with this flow path
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_87
id:
type: string
name:
type: string
args:
type: object
created_by:
type: string
created_at:
type: string
format: date-time
is_public:
type: boolean
success:
type: boolean
required: &ref_88
- id
- name
- args
- created_by
- created_at
- is_public
/w/{workspace}/raw_apps/list:
get:
summary: list all raw apps
operationId: listRawApps
tags:
- raw_app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: order_desc
description: order by desc order (default true)
in: query
schema: *ref_41
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
- name: path_start
description: mask to filter matching starting path
in: query
schema:
type: string
- name: path_exact
description: mask to filter exact matching path
in: query
schema:
type: string
- name: starred_only
description: |
(default false)
show only the starred items
in: query
schema:
type: boolean
responses:
'200':
description: All raw apps
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_162
workspace_id:
type: string
path:
type: string
summary:
type: string
extra_perms:
type: object
additionalProperties:
type: boolean
starred:
type: boolean
version:
type: number
edited_at:
type: string
format: date-time
required: &ref_163
- workspace_id
- path
- summary
- extra_perms
- version
- edited_at
/w/{workspace}/raw_apps/exists/{path}:
get:
summary: does an app exisst at path
operationId: existsRawApp
tags:
- raw_app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: app exists
content:
application/json:
schema:
type: boolean
/w/{workspace}/apps/get_data/{version}/{path}:
get:
summary: get app by path
operationId: getRawAppData
tags:
- raw_app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: version
in: path
required: true
schema: &ref_95
type: number
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: app details
content:
text/javascript:
schema:
type: string
/w/{workspace}/apps/list_search:
get:
summary: list apps for search
operationId: listSearchApp
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: app list
content:
application/json:
schema:
type: array
items:
type: object
properties:
path:
type: string
value: {}
required:
- path
- value
/w/{workspace}/apps/list:
get:
summary: list all apps
operationId: listApps
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: order_desc
description: order by desc order (default true)
in: query
schema: *ref_41
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
- name: path_start
description: mask to filter matching starting path
in: query
schema:
type: string
- name: path_exact
description: mask to filter exact matching path
in: query
schema:
type: string
- name: starred_only
description: |
(default false)
show only the starred items
in: query
schema:
type: boolean
responses:
'200':
description: All apps
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_160
id:
type: integer
workspace_id:
type: string
path:
type: string
summary:
type: string
version:
type: integer
extra_perms:
type: object
additionalProperties:
type: boolean
starred:
type: boolean
edited_at:
type: string
format: date-time
execution_mode:
type: string
enum:
- viewer
- publisher
- anonymous
required: &ref_161
- id
- workspace_id
- path
- summary
- version
- extra_perms
- edited_at
- execution_mode
/w/{workspace}/apps/create:
post:
summary: create app
operationId: createApp
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: new app
required: true
content:
application/json:
schema:
type: object
properties:
path:
type: string
value: {}
summary:
type: string
policy:
type: object
properties: &ref_47
triggerables:
type: object
additionalProperties:
type: object
execution_mode:
type: string
enum:
- viewer
- publisher
- anonymous
on_behalf_of:
type: string
on_behalf_of_email:
type: string
draft_only:
type: boolean
deployment_message:
type: string
required:
- path
- value
- summary
- policy
responses:
'201':
description: app created
content:
text/plain:
schema:
type: string
/w/{workspace}/apps/exists/{path}:
get:
summary: does an app exisst at path
operationId: existsApp
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: app exists
content:
application/json:
schema:
type: boolean
/w/{workspace}/apps/get/p/{path}:
get:
summary: get app by path
operationId: getAppByPath
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: app details
content:
application/json:
schema:
type: object
properties: &ref_48
id:
type: integer
workspace_id:
type: string
path:
type: string
summary:
type: string
versions:
type: array
items:
type: integer
created_by:
type: string
created_at:
type: string
format: date-time
value: {}
policy:
type: object
properties: *ref_47
execution_mode:
type: string
enum:
- viewer
- publisher
- anonymous
extra_perms:
type: object
additionalProperties:
type: boolean
required: &ref_49
- id
- workspace_id
- path
- summary
- versions
- created_by
- created_at
- value
- policy
- execution_mode
- extra_perms
/w/{workspace}/apps/get/draft/{path}:
get:
summary: get app by path with draft
operationId: getAppByPathWithDraft
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: app details with draft
content:
application/json:
schema:
allOf: &ref_164
- type: object
properties: *ref_48
required: *ref_49
- type: object
properties:
draft_only:
type: boolean
draft: {}
/w/{workspace}/apps/history/p/{path}:
get:
summary: get app history by path
operationId: getAppHistoryByPath
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
responses:
'200':
description: app history
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_165
version:
type: integer
deployment_msg:
type: string
required: &ref_166
- version
/w/{workspace}/apps/history_update/a/{id}/v/{version}:
post:
summary: update app history
operationId: updateAppHistory
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_24
- name: version
in: path
required: true
schema: &ref_97
type: integer
requestBody:
description: App deployment message
required: true
content:
application/json:
schema:
type: object
properties:
deployment_msg:
type: string
responses:
'200':
description: success
content:
text/plain:
schema:
type: string
/w/{workspace}/apps_u/public_app/{path}:
get:
summary: get public app by secret
operationId: getPublicAppBySecret
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: app details
content:
application/json:
schema:
type: object
properties: *ref_48
required: *ref_49
/w/{workspace}/apps_u/public_resource/{path}:
get:
summary: get public resource
operationId: get public resource
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: resource value
content:
application/json:
schema: {}
/w/{workspace}/apps/secret_of/{path}:
get:
summary: get public secret of app
operationId: getPublicSecretOfApp
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: app secret
content:
text/plain:
schema:
type: string
/w/{workspace}/apps/get/v/{id}:
get:
summary: get app by version
operationId: getAppByVersion
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_24
responses:
'200':
description: app details
content:
application/json:
schema:
type: object
properties: *ref_48
required: *ref_49
/w/{workspace}/raw_apps/create:
post:
summary: create raw app
operationId: createRawApp
tags:
- raw_app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: new raw app
required: true
content:
application/json:
schema:
type: object
properties:
path:
type: string
value:
type: string
summary:
type: string
required:
- path
- value
- summary
responses:
'201':
description: raw app created
content:
text/plain:
schema:
type: string
/w/{workspace}/raw_apps/update/{path}:
post:
summary: update app
operationId: updateRawApp
tags:
- raw_app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: updateraw app
required: true
content:
application/json:
schema:
type: object
properties:
path:
type: string
summary:
type: string
value:
type: string
responses:
'200':
description: app updated
content:
text/plain:
schema:
type: string
/w/{workspace}/raw_apps/delete/{path}:
delete:
summary: delete raw app
operationId: deleteRawApp
tags:
- raw_app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: app deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/apps/delete/{path}:
delete:
summary: delete app
operationId: deleteApp
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: app deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/apps/update/{path}:
post:
summary: update app
operationId: updateApp
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: update app
required: true
content:
application/json:
schema:
type: object
properties:
path:
type: string
summary:
type: string
value: {}
policy:
type: object
properties: *ref_47
deployment_message:
type: string
responses:
'200':
description: app updated
content:
text/plain:
schema:
type: string
/w/{workspace}/apps_u/execute_component/{path}:
post:
summary: executeComponent
operationId: executeComponent
tags:
- app
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
requestBody:
description: update app
required: true
content:
application/json:
schema:
type: object
properties:
component:
type: string
path:
type: string
args: {}
raw_code:
type: object
properties:
content:
type: string
language:
type: string
path:
type: string
cache_ttl:
type: integer
required:
- content
- language
force_viewer_static_fields:
type: object
required:
- args
- component
responses:
'200':
description: job uuid
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs/run/f/{path}:
post:
summary: run flow by path
operationId: runFlowByPath
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_29
- name: scheduled_for
description: when to schedule this job (leave empty for immediate run)
in: query
schema:
type: string
format: date-time
- name: scheduled_in_secs
description: schedule the script to execute in the number of seconds starting now
in: query
schema:
type: integer
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: tag
description: Override the tag to use
in: query
schema: *ref_38
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: invisible_to_owner
description: make the run invisible to the the flow owner (default false)
in: query
schema:
type: boolean
requestBody:
description: flow args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'201':
description: job created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/jobs/restart/f/{id}/from/{step_id}/{branch_or_iteration_n}:
post:
summary: restart a completed flow at a given step
operationId: restartFlowAtStep
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: &ref_73
type: string
format: uuid
- name: step_id
description: step id to restart the flow from
required: true
in: path
schema:
type: string
- name: branch_or_iteration_n
description: >-
for branchall or loop, the iteration at which the flow should
restart
required: true
in: path
schema:
type: integer
- name: scheduled_for
description: when to schedule this job (leave empty for immediate run)
in: query
schema:
type: string
format: date-time
- name: scheduled_in_secs
description: schedule the script to execute in the number of seconds starting now
in: query
schema:
type: integer
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: tag
description: Override the tag to use
in: query
schema: *ref_38
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: invisible_to_owner
description: make the run invisible to the the flow owner (default false)
in: query
schema:
type: boolean
requestBody:
description: flow args
required: true
content:
application/json:
schema:
type: object
additionalProperties: *ref_14
responses:
'201':
description: job created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/jobs/run/h/{hash}:
post:
summary: run script by hash
operationId: runScriptByHash
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: hash
in: path
required: true
schema: *ref_33
- name: scheduled_for
description: when to schedule this job (leave empty for immediate run)
in: query
schema:
type: string
format: date-time
- name: scheduled_in_secs
description: schedule the script to execute in the number of seconds starting now
in: query
schema:
type: integer
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: tag
description: Override the tag to use
in: query
schema: *ref_38
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: invisible_to_owner
description: make the run invisible to the the script owner (default false)
in: query
schema:
type: boolean
requestBody:
description: Partially filled args
required: true
content:
application/json:
schema:
type: object
responses:
'201':
description: job created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/jobs/run/preview:
post:
summary: run script preview
operationId: runScriptPreview
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: invisible_to_owner
description: make the run invisible to the the script owner (default false)
in: query
schema:
type: boolean
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
requestBody:
description: preview
required: true
content:
application/json:
schema:
type: object
properties: &ref_134
content:
type: string
path:
type: string
args:
type: object
additionalProperties: *ref_14
language:
type: string
enum:
- python3
- deno
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
- bun
tag:
type: string
kind:
type: string
enum:
- code
- identity
- http
dedicated_worker:
type: boolean
lock:
type: string
required: &ref_135
- args
responses:
'201':
description: job created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/jobs/run/dependencies:
post:
summary: run a one-off dependencies job
operationId: runRawScriptDependencies
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: raw script content
required: true
content:
application/json:
schema:
type: object
properties:
raw_scripts:
type: array
items:
type: object
properties: &ref_184
raw_code:
type: string
path:
type: string
language:
type: string
enum:
- python3
- deno
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
- bun
required: &ref_185
- raw_code
- path
- language
entrypoint:
type: string
required:
- entrypoint
- raw_scripts
responses:
'201':
description: dependency job result
content:
application/json:
schema:
type: object
properties:
lock:
type: string
required:
- lock
/w/{workspace}/jobs/run/preview_flow:
post:
summary: run flow preview
operationId: runFlowPreview
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to
the args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
- name: invisible_to_owner
description: make the run invisible to the the script owner (default false)
in: query
schema:
type: boolean
- name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the
queue or as a completed job, the request to create one will fail
(Bad Request)
in: query
schema: *ref_37
requestBody:
description: preview
required: true
content:
application/json:
schema:
type: object
properties: &ref_157
value:
type: object
properties: *ref_50
required: *ref_51
path:
type: string
args:
type: object
additionalProperties: *ref_14
tag:
type: string
restarted_from:
type: object
properties: &ref_159
flow_job_id:
type: string
format: uuid
step_id:
type: string
branch_or_iteration_n:
type: integer
required: &ref_158
- value
- content
- args
responses:
'201':
description: job created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/jobs/queue/list:
get:
summary: list all queued jobs
operationId: listQueue
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: order_desc
description: order by desc order (default true)
in: query
schema: *ref_41
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: script_path_exact
description: mask to filter exact matching path
in: query
schema: &ref_54
type: string
- name: script_path_start
description: mask to filter matching starting path
in: query
schema: &ref_55
type: string
- name: schedule_path
description: mask to filter by schedule path
in: query
schema: &ref_56
type: string
- name: script_hash
description: mask to filter exact matching path
in: query
schema: &ref_57
type: string
- name: started_before
description: filter on started before (inclusive) timestamp
in: query
schema: &ref_58
type: string
format: date-time
- name: started_after
description: filter on started after (exclusive) timestamp
in: query
schema: &ref_59
type: string
format: date-time
- name: success
description: filter on successful jobs
in: query
schema: &ref_60
type: boolean
- name: scheduled_for_before_now
description: filter on jobs scheduled_for before now (hence waitinf for a worker)
in: query
schema: &ref_68
type: boolean
- name: job_kinds
description: >-
filter on job kind (values 'preview', 'script', 'dependencies',
'flow') separated by,
in: query
schema: &ref_61
type: string
- name: suspended
description: filter on suspended jobs
in: query
schema: &ref_100
type: boolean
- name: running
description: filter on running jobs
in: query
schema: &ref_67
type: boolean
- name: args
description: >-
filter on jobs containing those args as a json subset (@> in
postgres)
in: query
schema: &ref_62
type: string
- name: result
description: >-
filter on jobs containing those result as a json subset (@> in
postgres)
in: query
schema: &ref_63
type: string
- name: tag
description: filter on jobs with a given tag/worker group
in: query
schema: &ref_64
type: string
- name: all_workspaces
description: >-
get jobs from all workspaces (only valid if request come from the
`admins` workspace)
in: query
schema:
type: boolean
responses:
'200':
description: All queued jobs
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_71
workspace_id:
type: string
id:
type: string
format: uuid
parent_job:
type: string
format: uuid
created_by:
type: string
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
scheduled_for:
type: string
format: date-time
running:
type: boolean
script_path:
type: string
script_hash:
type: string
args:
type: object
additionalProperties: *ref_14
logs:
type: string
raw_code:
type: string
canceled:
type: boolean
canceled_by:
type: string
canceled_reason:
type: string
last_ping:
type: string
format: date-time
job_kind:
type: string
enum:
- script
- preview
- dependencies
- flowdependencies
- appdependencies
- flow
- flowpreview
- script_hub
- identity
- deploymentcallback
- singlescriptflow
schedule_path:
type: string
permissioned_as:
type: string
description: >
The user (u/userfoo) or group (g/groupfoo) whom
the execution of this script will be permissioned_as and
by extension its DT_TOKEN.
flow_status:
type: object
properties: &ref_65
step:
type: integer
modules:
type: array
items:
type: object
properties: &ref_52
type:
type: string
enum:
- WaitingForPriorSteps
- WaitingForEvents
- WaitingForExecutor
- InProgress
- Success
- Failure
id:
type: string
job:
type: string
format: uuid
count:
type: integer
iterator:
type: object
properties:
index:
type: integer
itered:
type: array
items: {}
args: {}
flow_jobs:
type: array
items:
type: string
branch_chosen:
type: object
properties:
type:
type: string
enum:
- branch
- default
branch:
type: integer
required:
- type
branchall:
type: object
properties:
branch:
type: integer
len:
type: integer
required:
- branch
- len
approvers:
type: array
items:
type: object
properties:
resume_id:
type: integer
approver:
type: string
required:
- resume_id
- approver
required: &ref_53
- type
failure_module:
allOf:
- type: object
properties: *ref_52
required: *ref_53
- type: object
properties:
parent_module:
type: string
retry:
type: object
properties:
fail_count:
type: integer
failed_jobs:
type: array
items:
type: string
format: uuid
required: &ref_66
- step
- modules
- failure_module
raw_flow:
type: object
properties: *ref_50
required: *ref_51
is_flow_step:
type: boolean
language:
type: string
enum:
- python3
- deno
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
- bun
email:
type: string
visible_to_owner:
type: boolean
mem_peak:
type: integer
tag:
type: string
priority:
type: integer
required: &ref_72
- id
- running
- canceled
- job_kind
- permissioned_as
- is_flow_step
- email
- visible_to_owner
- tag
/w/{workspace}/jobs/queue/count:
get:
summary: get queue count
operationId: getQueueCount
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: all_workspaces
description: >-
get jobs from all workspaces (only valid if request come from the
`admins` workspace)
in: query
schema:
type: boolean
responses:
'200':
description: queue count
content:
application/json:
schema:
type: object
properties:
database_length:
type: integer
required:
- database_length
/w/{workspace}/jobs/completed/count:
get:
summary: get completed count
operationId: getCompletedCount
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: completed count
content:
application/json:
schema:
type: object
properties:
database_length:
type: integer
required:
- database_length
/w/{workspace}/jobs/queue/cancel_all:
post:
summary: cancel all jobs
operationId: cancelAll
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: uuids of canceled jobs
content:
application/json:
schema:
type: array
items:
type: string
/w/{workspace}/jobs/completed/list:
get:
summary: list all completed jobs
operationId: listCompletedJobs
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: order_desc
description: order by desc order (default true)
in: query
schema: *ref_41
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: script_path_exact
description: mask to filter exact matching path
in: query
schema: *ref_54
- name: script_path_start
description: mask to filter matching starting path
in: query
schema: *ref_55
- name: schedule_path
description: mask to filter by schedule path
in: query
schema: *ref_56
- name: script_hash
description: mask to filter exact matching path
in: query
schema: *ref_57
- name: started_before
description: filter on started before (inclusive) timestamp
in: query
schema: *ref_58
- name: started_after
description: filter on started after (exclusive) timestamp
in: query
schema: *ref_59
- name: success
description: filter on successful jobs
in: query
schema: *ref_60
- name: job_kinds
description: >-
filter on job kind (values 'preview', 'script', 'dependencies',
'flow') separated by,
in: query
schema: *ref_61
- name: args
description: >-
filter on jobs containing those args as a json subset (@> in
postgres)
in: query
schema: *ref_62
- name: result
description: >-
filter on jobs containing those result as a json subset (@> in
postgres)
in: query
schema: *ref_63
- name: tag
description: filter on jobs with a given tag/worker group
in: query
schema: *ref_64
- name: is_skipped
description: is the job skipped
in: query
schema:
type: boolean
- name: is_flow_step
description: is the job a flow step
in: query
schema:
type: boolean
responses:
'200':
description: All completed jobs
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_69
workspace_id:
type: string
id:
type: string
format: uuid
parent_job:
type: string
format: uuid
created_by:
type: string
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
duration_ms:
type: integer
success:
type: boolean
script_path:
type: string
script_hash:
type: string
args:
type: object
additionalProperties: *ref_14
result: {}
logs:
type: string
deleted:
type: boolean
raw_code:
type: string
canceled:
type: boolean
canceled_by:
type: string
canceled_reason:
type: string
job_kind:
type: string
enum:
- script
- preview
- dependencies
- flow
- flowdependencies
- appdependencies
- flowpreview
- script_hub
- identity
- deploymentcallback
- singlescriptflow
schedule_path:
type: string
permissioned_as:
type: string
description: >
The user (u/userfoo) or group (g/groupfoo) whom
the execution of this script will be permissioned_as and
by extension its DT_TOKEN.
flow_status:
type: object
properties: *ref_65
required: *ref_66
raw_flow:
type: object
properties: *ref_50
required: *ref_51
is_flow_step:
type: boolean
language:
type: string
enum:
- python3
- deno
- go
- bash
- powershell
- postgresql
- mysql
- bigquery
- snowflake
- mssql
- graphql
- nativets
- bun
is_skipped:
type: boolean
email:
type: string
visible_to_owner:
type: boolean
mem_peak:
type: integer
tag:
type: string
priority:
type: integer
required: &ref_70
- id
- created_by
- duration_ms
- created_at
- started_at
- success
- canceled
- job_kind
- permissioned_as
- is_flow_step
- is_skipped
- email
- visible_to_owner
- tag
/w/{workspace}/jobs/list:
get:
summary: list all jobs
operationId: listJobs
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
- name: parent_job
description: >-
The parent job that is at the origin and responsible for the
execution of this script if any
in: query
schema: *ref_36
- name: script_path_exact
description: mask to filter exact matching path
in: query
schema: *ref_54
- name: script_path_start
description: mask to filter matching starting path
in: query
schema: *ref_55
- name: schedule_path
description: mask to filter by schedule path
in: query
schema: *ref_56
- name: script_hash
description: mask to filter exact matching path
in: query
schema: *ref_57
- name: started_before
description: filter on started before (inclusive) timestamp
in: query
schema: *ref_58
- name: started_after
description: filter on started after (exclusive) timestamp
in: query
schema: *ref_59
- name: created_or_started_before
description: >-
filter on created_at for non non started job and started_at
otherwise before (inclusive) timestamp
in: query
schema: &ref_99
type: string
format: date-time
- name: running
description: filter on running jobs
in: query
schema: *ref_67
- name: scheduled_for_before_now
description: filter on jobs scheduled_for before now (hence waitinf for a worker)
in: query
schema: *ref_68
- name: created_or_started_after
description: >-
filter on created_at for non non started job and started_at
otherwise after (exclusive) timestamp
in: query
schema: &ref_98
type: string
format: date-time
- name: job_kinds
description: >-
filter on job kind (values 'preview', 'script', 'dependencies',
'flow') separated by,
in: query
schema: *ref_61
- name: args
description: >-
filter on jobs containing those args as a json subset (@> in
postgres)
in: query
schema: *ref_62
- name: tag
description: filter on jobs with a given tag/worker group
in: query
schema: *ref_64
- name: result
description: >-
filter on jobs containing those result as a json subset (@> in
postgres)
in: query
schema: *ref_63
- name: is_skipped
description: is the job skipped
in: query
schema:
type: boolean
- name: is_flow_step
description: is the job a flow step
in: query
schema:
type: boolean
- name: success
description: filter on successful jobs
in: query
schema:
type: boolean
- name: all_workspaces
description: >-
get jobs from all workspaces (only valid if request come from the
`admins` workspace)
in: query
schema:
type: boolean
responses:
'200':
description: All jobs
content:
application/json:
schema:
type: array
items:
allOf: &ref_74
- oneOf:
- type: object
properties: *ref_69
required: *ref_70
- type: object
properties: *ref_71
required: *ref_72
- type: object
properties:
type:
type: string
enum:
- CompletedJob
- QueuedJob
discriminator: &ref_75
propertyName: type
/jobs/db_clock:
get:
summary: get db clock
operationId: getDbClock
tags:
- job
responses:
'200':
description: the timestamp of the db that can be used to compute the drift
content:
application/json:
schema:
type: integer
/w/{workspace}/jobs_u/get/{id}:
get:
summary: get job
operationId: getJob
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: job details
content:
application/json:
schema:
allOf: *ref_74
discriminator: *ref_75
/w/{workspace}/jobs_u/get_root_job_id/{id}:
get:
summary: get root job id
operationId: getRootJobId
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: get root job id
content:
application/json:
schema:
type: string
/w/{workspace}/jobs_u/get_logs/{id}:
get:
summary: get job logs
operationId: getJob logs
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: job details
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs_u/getupdate/{id}:
get:
summary: get job updates
operationId: getJobUpdates
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: running
in: query
schema:
type: boolean
- name: log_offset
in: query
schema:
type: integer
responses:
'200':
description: job details
content:
application/json:
schema:
type: object
properties:
running:
type: boolean
completed:
type: boolean
new_logs:
type: string
mem_peak:
type: integer
/w/{workspace}/jobs_u/get_flow_debug_info/{id}:
get:
summary: get flow debug info
operationId: getFlowDebugInfo
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: flow debug info details
content:
application/json:
schema: {}
/w/{workspace}/jobs_u/completed/get/{id}:
get:
summary: get completed job
operationId: getCompletedJob
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: job details
content:
application/json:
schema:
type: object
properties: *ref_69
required: *ref_70
/w/{workspace}/jobs_u/completed/get_result/{id}:
get:
summary: get completed job result
operationId: getCompletedJobResult
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: result
content:
application/json:
schema: {}
/w/{workspace}/jobs_u/completed/get_result_maybe/{id}:
get:
summary: get completed job result if job is completed
operationId: getCompletedJobResultMaybe
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: get_started
in: query
schema: &ref_108
type: boolean
responses:
'200':
description: result
content:
application/json:
schema:
type: object
properties:
completed:
type: boolean
result: {}
success:
type: boolean
started:
type: boolean
required:
- completed
- result
/w/{workspace}/jobs/completed/delete/{id}:
post:
summary: delete completed job (erase content but keep run id)
operationId: deleteCompletedJob
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
responses:
'200':
description: job details
content:
application/json:
schema:
type: object
properties: *ref_69
required: *ref_70
/w/{workspace}/jobs_u/queue/cancel/{id}:
post:
summary: cancel queued job
operationId: cancelQueuedJob
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
requestBody:
description: reason
required: true
content:
application/json:
schema:
type: object
properties:
reason:
type: string
responses:
'200':
description: job canceled
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs_u/queue/cancel_persistent/{path}:
post:
summary: cancel all queued jobs for persistent script
operationId: cancelPersistentQueuedJobs
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
requestBody:
description: reason
required: true
content:
application/json:
schema:
type: object
properties:
reason:
type: string
responses:
'200':
description: persistent job scaled down to zero
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs_u/queue/force_cancel/{id}:
post:
summary: force cancel queued job
operationId: forceCancelQueuedJob
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
requestBody:
description: reason
required: true
content:
application/json:
schema:
type: object
properties:
reason:
type: string
responses:
'200':
description: job canceled
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs/job_signature/{id}/{resume_id}:
get:
summary: create an HMac signature given a job id and a resume id
operationId: createJobSignature
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: resume_id
in: path
required: true
schema:
type: integer
- name: approver
in: query
schema:
type: string
responses:
'200':
description: job signature
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs/resume_urls/{id}/{resume_id}:
get:
summary: get resume urls given a job_id, resume_id and a nonce to resume a flow
operationId: getResumeUrls
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: resume_id
in: path
required: true
schema:
type: integer
- name: approver
in: query
schema:
type: string
responses:
'200':
description: url endpoints
content:
application/json:
schema:
type: object
properties:
approvalPage:
type: string
resume:
type: string
cancel:
type: string
required:
- approvalPage
- resume
- cancel
/w/{workspace}/jobs_u/resume/{id}/{resume_id}/{signature}:
get:
summary: resume a job for a suspended flow
operationId: resumeSuspendedJobGet
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: payload
description: >
The base64 encoded payload that has been encoded as a JSON. e.g how
to encode such payload encodeURIComponent
`encodeURIComponent(btoa(JSON.stringify({a: 2})))`
in: query
schema: *ref_76
- name: resume_id
in: path
required: true
schema:
type: integer
- name: signature
in: path
required: true
schema:
type: string
- name: approver
in: query
schema:
type: string
responses:
'201':
description: job resumed
content:
text/plain:
schema:
type: string
post:
summary: resume a job for a suspended flow
operationId: resumeSuspendedJobPost
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: resume_id
in: path
required: true
schema:
type: integer
- name: signature
in: path
required: true
schema:
type: string
- name: approver
in: query
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'201':
description: job resumed
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs/flow/resume/{id}:
post:
summary: resume a job for a suspended flow as an owner
operationId: resumeSuspendedFlowAsOwner
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'201':
description: job resumed
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs_u/cancel/{id}/{resume_id}/{signature}:
get:
summary: cancel a job for a suspended flow
operationId: cancelSuspendedJobGet
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: resume_id
in: path
required: true
schema:
type: integer
- name: signature
in: path
required: true
schema:
type: string
- name: approver
in: query
schema:
type: string
responses:
'201':
description: job canceled
content:
text/plain:
schema:
type: string
post:
summary: cancel a job for a suspended flow
operationId: cancelSuspendedJobPost
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: resume_id
in: path
required: true
schema:
type: integer
- name: signature
in: path
required: true
schema:
type: string
- name: approver
in: query
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'201':
description: job canceled
content:
text/plain:
schema:
type: string
/w/{workspace}/jobs_u/get_flow/{id}/{resume_id}/{signature}:
get:
summary: get parent flow job of suspended job
operationId: getSuspendedJobFlow
tags:
- job
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
- name: resume_id
in: path
required: true
schema:
type: integer
- name: signature
in: path
required: true
schema:
type: string
- name: approver
in: query
schema:
type: string
responses:
'200':
description: parent flow details
content:
application/json:
schema:
type: object
properties:
job:
allOf: *ref_74
discriminator: *ref_75
approvers:
type: array
items:
type: object
properties:
resume_id:
type: integer
approver:
type: string
required:
- resume_id
- approver
required:
- job
- approvers
/schedules/preview:
post:
summary: preview schedule
operationId: previewSchedule
tags:
- schedule
requestBody:
description: schedule
required: true
content:
application/json:
schema:
type: object
properties:
schedule:
type: string
timezone:
type: string
required:
- schedule
- timezone
responses:
'200':
description: List of 5 estimated upcoming execution events (in UTC)
content:
application/json:
schema:
type: array
items:
type: string
format: date-time
/w/{workspace}/schedules/create:
post:
summary: create schedule
operationId: createSchedule
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: new schedule
required: true
content:
application/json:
schema:
type: object
properties: &ref_145
path:
type: string
schedule:
type: string
timezone:
type: string
script_path:
type: string
is_flow:
type: boolean
args:
type: object
additionalProperties: *ref_14
enabled:
type: boolean
on_failure:
type: string
on_failure_times:
type: number
on_failure_exact:
type: boolean
on_failure_extra_args:
type: object
additionalProperties: *ref_14
on_recovery:
type: string
on_recovery_times:
type: number
on_recovery_extra_args:
type: object
additionalProperties: *ref_14
ws_error_handler_muted:
type: boolean
retry:
type: object
properties: *ref_77
no_flow_overlap:
type: boolean
summary:
type: string
tag:
type: string
required: &ref_146
- path
- schedule
- timezone
- script_path
- is_flow
- args
responses:
'201':
description: schedule created
content:
text/plain:
schema:
type: string
/w/{workspace}/schedules/update/{path}:
post:
summary: update schedule
operationId: updateSchedule
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
requestBody:
description: updated schedule
required: true
content:
application/json:
schema:
type: object
properties: &ref_147
schedule:
type: string
timezone:
type: string
args:
type: object
additionalProperties: *ref_14
on_failure:
type: string
on_failure_times:
type: number
on_failure_exact:
type: boolean
on_failure_extra_args:
type: object
additionalProperties: *ref_14
on_recovery:
type: string
on_recovery_times:
type: number
on_recovery_extra_args:
type: object
additionalProperties: *ref_14
ws_error_handler_muted:
type: boolean
retry:
type: object
properties: *ref_77
no_flow_overlap:
type: boolean
summary:
type: string
tag:
type: string
required: &ref_148
- schedule
- timezone
- script_path
- is_flow
- args
responses:
'200':
description: schedule updated
content:
text/plain:
schema:
type: string
/w/{workspace}/schedules/setenabled/{path}:
post:
summary: set enabled schedule
operationId: setScheduleEnabled
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
requestBody:
description: updated schedule enable
required: true
content:
application/json:
schema:
type: object
properties:
enabled:
type: boolean
required:
- enabled
responses:
'200':
description: schedule enabled set
content:
text/plain:
schema:
type: string
/w/{workspace}/schedules/delete/{path}:
delete:
summary: delete schedule
operationId: deleteSchedule
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: schedule deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/schedules/get/{path}:
get:
summary: get schedule
operationId: getSchedule
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: schedule deleted
content:
application/json:
schema:
type: object
properties: &ref_78
path:
type: string
edited_by:
type: string
edited_at:
type: string
format: date-time
schedule:
type: string
timezone:
type: string
enabled:
type: boolean
script_path:
type: string
is_flow:
type: boolean
args:
type: object
additionalProperties: *ref_14
extra_perms:
type: object
additionalProperties:
type: boolean
email:
type: string
error:
type: string
on_failure:
type: string
on_failure_times:
type: number
on_failure_exact:
type: boolean
on_failure_extra_args:
type: object
additionalProperties: *ref_14
on_recovery:
type: string
on_recovery_times:
type: number
on_recovery_extra_args:
type: object
additionalProperties: *ref_14
ws_error_handler_muted:
type: boolean
retry:
type: object
properties: *ref_77
summary:
type: string
no_flow_overlap:
type: boolean
tag:
type: string
required: &ref_79
- path
- edited_by
- edited_at
- schedule
- script_path
- timezone
- extra_perms
- is_flow
- enabled
- email
/w/{workspace}/schedules/exists/{path}:
get:
summary: does schedule exists
operationId: existsSchedule
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: schedule exists
content:
application/json:
schema:
type: boolean
/w/{workspace}/schedules/list:
get:
summary: list schedules
operationId: listSchedules
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: path
description: filter by path
in: query
schema:
type: string
- name: is_flow
in: query
schema:
type: boolean
responses:
'200':
description: schedule list
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_78
required: *ref_79
/w/{workspace}/schedules/list_with_jobs:
get:
summary: list schedules with last 20 jobs
operationId: listSchedulesWithJobs
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: schedule list
content:
application/json:
schema:
type: array
items:
allOf: &ref_144
- type: object
properties: *ref_78
required: *ref_79
- type: object
properties:
jobs:
type: array
items:
type: object
properties:
id:
type: string
success:
type: boolean
duration_ms:
type: number
required:
- id
- success
- duration_ms
/w/{workspace}/schedules/setdefaulthandler:
post:
summary: Set default error or recoevery handler
operationId: setDefaultErrorOrRecoveryHandler
tags:
- schedule
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: Handler description
required: true
content:
application/json:
schema:
type: object
properties:
handler_type:
type: string
enum:
- error
- recovery
override_existing:
type: boolean
path:
type: string
extra_args:
type: object
number_of_occurence:
type: integer
number_of_occurence_exact:
type: boolean
workspace_handler_muted:
type: boolean
required:
- handler_type
- override_existing
responses:
'201':
description: default error handler set
/groups/list:
get:
summary: list instance groups
operationId: listInstanceGroups
tags:
- group
responses:
'200':
description: instance group list
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_81
name:
type: string
summary:
type: string
emails:
type: array
items:
type: string
required: &ref_82
- name
/groups/get/{name}:
get:
summary: get instance group
operationId: getInstanceGroup
tags:
- group
parameters:
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: instance group
content:
application/json:
schema:
type: object
properties: *ref_81
required: *ref_82
/groups/create:
post:
summary: create instance group
operationId: createInstanceGroup
tags:
- group
requestBody:
description: create instance group
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
summary:
type: string
required:
- name
responses:
'200':
description: instance group created
content:
text/plain:
schema:
type: string
/groups/update/{name}:
post:
summary: update instance group
operationId: updateInstanceGroup
tags:
- group
parameters:
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: update instance group
required: true
content:
application/json:
schema:
type: object
properties:
new_summary:
type: string
required:
- new_summary
responses:
'200':
description: instance group updated
content:
text/plain:
schema:
type: string
/groups/delete/{name}:
delete:
summary: delete instance group
operationId: deleteInstanceGroup
tags:
- group
parameters:
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: instance group deleted
content:
text/plain:
schema:
type: string
/groups/adduser/{name}:
post:
summary: add user to instance group
operationId: addUserToInstanceGroup
tags:
- group
parameters:
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: user to add to instance group
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
required:
- email
responses:
'200':
description: user added to instance group
content:
text/plain:
schema:
type: string
/groups/removeuser/{name}:
post:
summary: remove user from instance group
operationId: removeUserFromInstanceGroup
tags:
- group
parameters:
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: user to remove from instance group
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
required:
- email
responses:
'200':
description: user removed from instance group
content:
text/plain:
schema:
type: string
/w/{workspace}/groups/list:
get:
summary: list groups
operationId: listGroups
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: group list
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_83
name:
type: string
summary:
type: string
members:
type: array
items:
type: string
extra_perms:
type: object
additionalProperties:
type: boolean
required: &ref_84
- name
/w/{workspace}/groups/listnames:
get:
summary: list group names
operationId: listGroupNames
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: only_member_of
in: query
description: only list the groups the user is member of (default false)
schema:
type: boolean
responses:
'200':
description: group list
content:
application/json:
schema:
type: array
items:
type: string
/w/{workspace}/groups/create:
post:
summary: create group
operationId: createGroup
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: create group
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
summary:
type: string
required:
- name
responses:
'200':
description: group created
content:
text/plain:
schema:
type: string
/w/{workspace}/groups/update/{name}:
post:
summary: update group
operationId: updateGroup
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: updated group
required: true
content:
application/json:
schema:
type: object
properties:
summary:
type: string
responses:
'200':
description: group updated
content:
text/plain:
schema:
type: string
/w/{workspace}/groups/delete/{name}:
delete:
summary: delete group
operationId: deleteGroup
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: group deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/groups/get/{name}:
get:
summary: get group
operationId: getGroup
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: group
content:
application/json:
schema:
type: object
properties: *ref_83
required: *ref_84
/w/{workspace}/groups/adduser/{name}:
post:
summary: add user to group
operationId: addUserToGroup
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: added user to group
required: true
content:
application/json:
schema:
type: object
properties:
username:
type: string
responses:
'200':
description: user added to group
content:
text/plain:
schema:
type: string
/w/{workspace}/groups/removeuser/{name}:
post:
summary: remove user to group
operationId: removeUserToGroup
tags:
- group
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: added user to group
required: true
content:
application/json:
schema:
type: object
properties:
username:
type: string
responses:
'200':
description: user removed from group
content:
text/plain:
schema:
type: string
/w/{workspace}/folders/list:
get:
summary: list folders
operationId: listFolders
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: folder list
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_85
name:
type: string
owners:
type: array
items:
type: string
extra_perms:
type: object
additionalProperties:
type: boolean
required: &ref_86
- name
- owners
- extra_perms
/w/{workspace}/folders/listnames:
get:
summary: list folder names
operationId: listFolderNames
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: only_member_of
in: query
description: only list the folders the user is member of (default false)
schema:
type: boolean
responses:
'200':
description: folder list
content:
application/json:
schema:
type: array
items:
type: string
/w/{workspace}/folders/create:
post:
summary: create folder
operationId: createFolder
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: create folder
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
owners:
type: array
items:
type: string
extra_perms:
additionalProperties:
type: boolean
required:
- name
responses:
'200':
description: folder created
content:
text/plain:
schema:
type: string
/w/{workspace}/folders/update/{name}:
post:
summary: update folder
operationId: updateFolder
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: update folder
required: true
content:
application/json:
schema:
type: object
properties:
owners:
type: array
items:
type: string
extra_perms:
additionalProperties:
type: boolean
responses:
'200':
description: folder updated
content:
text/plain:
schema:
type: string
/w/{workspace}/folders/delete/{name}:
delete:
summary: delete folder
operationId: deleteFolder
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: folder deleted
content:
text/plain:
schema:
type: string
/w/{workspace}/folders/get/{name}:
get:
summary: get folder
operationId: getFolder
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: folder
content:
application/json:
schema:
type: object
properties: *ref_85
required: *ref_86
/w/{workspace}/folders/getusage/{name}:
get:
summary: get folder usage
operationId: getFolderUsage
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: folder
content:
application/json:
schema:
type: object
properties:
scripts:
type: number
flows:
type: number
apps:
type: number
resources:
type: number
variables:
type: number
schedules:
type: number
required:
- scripts
- flows
- apps
- resources
- variables
- schedules
/w/{workspace}/folders/addowner/{name}:
post:
summary: add owner to folder
operationId: addOwnerToFolder
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: owner user to folder
required: true
content:
application/json:
schema:
type: object
properties:
owner:
type: string
responses:
'200':
description: owner added to folder
content:
text/plain:
schema:
type: string
/w/{workspace}/folders/removeowner/{name}:
post:
summary: remove owner to folder
operationId: removeOwnerToFolder
tags:
- folder
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: added owner to folder
required: true
content:
application/json:
schema:
type: object
properties:
owner:
type: string
responses:
'200':
description: owner removed from folder
content:
text/plain:
schema:
type: string
/workers/list:
get:
summary: list workers
operationId: listWorkers
tags:
- worker
parameters:
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
- name: ping_since
in: query
required: false
description: >-
number of seconds the worker must have had a last ping more recent
of (default to 300)
schema:
type: integer
responses:
'200':
description: a list of workers
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_149
worker:
type: string
worker_instance:
type: string
last_ping:
type: number
started_at:
type: string
format: date-time
ip:
type: string
jobs_executed:
type: integer
custom_tags:
type: array
items:
type: string
worker_group:
type: string
wm_version:
type: string
required: &ref_150
- worker
- worker_instance
- ping_at
- started_at
- ip
- jobs_executed
- worker_group
- wm_version
/workers/exists_worker_with_tag:
get:
summary: exists worker with tag
operationId: existsWorkerWithTag
tags:
- worker
parameters:
- name: tag
in: query
required: true
schema:
type: string
responses:
'200':
description: whether a worker with the tag exists
content:
application/json:
schema:
type: boolean
/configs/list_worker_groups:
get:
summary: list worker groups
operationId: listWorkerGroups
tags:
- config
responses:
'200':
description: a list of worker group configs
content:
application/json:
schema:
type: array
items:
type: object
properties:
name:
type: string
config: {}
required:
- name
- config
/configs/get/{name}:
get:
summary: get config
operationId: get config
tags:
- config
parameters:
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: a config
content:
application/json:
schema: {}
/configs/update/{name}:
post:
summary: Update config
operationId: updateConfig
tags:
- config
parameters:
- name: name
in: path
required: true
schema: *ref_80
requestBody:
description: worker group
required: true
content:
application/json:
schema: {}
responses:
'200':
description: Update a worker group
content:
text/plain:
schema:
type: string
delete:
summary: Delete Config
operationId: deleteConfig
tags:
- config
parameters:
- name: name
in: path
required: true
schema: *ref_80
responses:
'200':
description: Delete config
content:
text/plain:
schema:
type: string
/w/{workspace}/acls/get/{kind}/{path}:
get:
summary: get granular acls
operationId: getGranularAcls
tags:
- granular_acl
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: kind
in: path
required: true
schema:
type: string
enum:
- script
- group_
- resource
- schedule
- variable
- flow
- folder
- app
- raw_app
responses:
'200':
description: acls
content:
application/json:
schema:
type: object
additionalProperties:
type: boolean
/w/{workspace}/acls/add/{kind}/{path}:
post:
summary: add granular acls
operationId: addGranularAcls
tags:
- granular_acl
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: kind
in: path
required: true
schema:
type: string
enum:
- script
- group_
- resource
- schedule
- variable
- flow
- folder
- app
- raw_app
requestBody:
description: acl to add
required: true
content:
application/json:
schema:
type: object
properties:
owner:
type: string
write:
type: boolean
required:
- owner
responses:
'200':
description: granular acl added
content:
text/plain:
schema:
type: string
/w/{workspace}/acls/remove/{kind}/{path}:
post:
summary: remove granular acls
operationId: removeGranularAcls
tags:
- granular_acl
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: kind
in: path
required: true
schema:
type: string
enum:
- script
- group_
- resource
- schedule
- variable
- flow
- folder
- app
- raw_app
requestBody:
description: acl to add
required: true
content:
application/json:
schema:
type: object
properties:
owner:
type: string
required:
- owner
responses:
'200':
description: granular acl removed
content:
text/plain:
schema:
type: string
/w/{workspace}/capture_u/{path}:
post:
summary: update flow preview capture
operationId: updateCapture
tags:
- capture
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'204':
description: flow preview captured
/w/{workspace}/capture/{path}:
put:
summary: create flow preview capture
operationId: createCapture
tags:
- capture
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'201':
description: flow preview capture created
get:
summary: get flow preview capture
operationId: getCapture
tags:
- capture
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
responses:
'200':
description: captured flow preview
content:
application/json:
schema: {}
'404':
description: capture does not exist for this flow
/w/{workspace}/favorites/star:
post:
summary: star item
operationId: star
tags:
- favorite
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
content:
application/json:
schema:
type: object
properties:
path:
type: string
favorite_kind:
type: string
enum:
- flow
- app
- script
- raw_app
responses:
'200':
description: star item
/w/{workspace}/favorites/unstar:
post:
summary: unstar item
operationId: unstar
tags:
- favorite
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
content:
application/json:
schema:
type: object
properties:
path:
type: string
favorite_kind:
type: string
enum:
- flow
- app
- script
- raw_app
responses:
'200':
description: unstar item
/w/{workspace}/inputs/history:
get:
summary: List Inputs used in previously completed jobs
operationId: getInputHistory
tags:
- input
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: runnable_id
in: query
schema: &ref_89
type: string
- name: runnable_type
in: query
schema: &ref_90
type: string
enum: &ref_117
- ScriptHash
- ScriptPath
- FlowPath
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: Input history for completed jobs
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_87
required: *ref_88
/w/{workspace}/inputs/list:
get:
summary: List saved Inputs for a Runnable
operationId: listInputs
tags:
- input
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: runnable_id
in: query
schema: *ref_89
- name: runnable_type
in: query
schema: *ref_90
- name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
- name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
responses:
'200':
description: Saved Inputs for a Runnable
content:
application/json:
schema:
type: array
items:
type: object
properties: *ref_87
required: *ref_88
/w/{workspace}/inputs/create:
post:
summary: Create an Input for future use in a script or flow
operationId: createInput
tags:
- input
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: runnable_id
in: query
schema: *ref_89
- name: runnable_type
in: query
schema: *ref_90
requestBody:
description: Input
required: true
content:
application/json:
schema:
type: object
properties: &ref_113
name:
type: string
args:
type: object
required: &ref_114
- name
- args
- created_by
responses:
'201':
description: Input created
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/inputs/update:
post:
summary: Update an Input
operationId: updateInput
tags:
- input
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: UpdateInput
required: true
content:
application/json:
schema:
type: object
properties: &ref_115
id:
type: string
name:
type: string
is_public:
type: boolean
required: &ref_116
- id
- name
- is_public
responses:
'201':
description: Input updated
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/inputs/delete/{input}:
post:
summary: Delete a Saved Input
operationId: deleteInput
tags:
- input
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: input
in: path
required: true
schema: &ref_107
type: string
responses:
'200':
description: Input deleted
content:
text/plain:
schema:
type: string
format: uuid
/w/{workspace}/job_helpers/duckdb_connection_settings:
post:
summary: >-
Converts an S3 resource to the set of instructions necessary to connect
DuckDB to an S3 bucket
operationId: duckdbConnectionSettings
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: S3 resource to connect to
required: true
content:
application/json:
schema:
type: object
properties:
s3_resource:
type: object
properties: &ref_91
bucket:
type: string
region:
type: string
endPoint:
type: string
useSSL:
type: boolean
accessKey:
type: string
secretKey:
type: string
pathStyle:
type: boolean
required: &ref_92
- bucket
- region
- endPoint
- useSSL
- pathStyle
responses:
'200':
description: Connection settings
content:
application/json:
schema:
type: object
properties:
connection_settings_str:
type: string
/w/{workspace}/job_helpers/v2/duckdb_connection_settings:
post:
summary: >-
Converts an S3 resource to the set of instructions necessary to connect
DuckDB to an S3 bucket
operationId: duckdbConnectionSettingsV2
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: >-
S3 resource path to use to generate the connection settings. If empty,
the S3 resource defined in the workspace settings will be used
required: true
content:
application/json:
schema:
type: object
properties:
s3_resource_path:
type: string
responses:
'200':
description: Connection settings
content:
application/json:
schema:
type: object
properties:
connection_settings_str:
type: string
required:
- connection_settings_str
/w/{workspace}/job_helpers/polars_connection_settings:
post:
summary: >-
Converts an S3 resource to the set of arguments necessary to connect
Polars to an S3 bucket
operationId: polarsConnectionSettings
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: S3 resource to connect to
required: true
content:
application/json:
schema:
type: object
properties:
s3_resource:
type: object
properties: *ref_91
required: *ref_92
responses:
'200':
description: Connection settings
content:
application/json:
schema:
type: object
properties:
endpoint_url:
type: string
key:
type: string
secret:
type: string
use_ssl:
type: boolean
cache_regions:
type: boolean
client_kwargs:
type: object
properties: &ref_93
region_name:
type: string
required: &ref_94
- region_name
required:
- endpoint_url
- use_ssl
- cache_regions
- client_kwargs
/w/{workspace}/job_helpers/v2/polars_connection_settings:
post:
summary: >-
Converts an S3 resource to the set of arguments necessary to connect
Polars to an S3 bucket
operationId: polarsConnectionSettingsV2
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: >-
S3 resource path to use to generate the connection settings. If empty,
the S3 resource defined in the workspace settings will be used
required: true
content:
application/json:
schema:
type: object
properties:
s3_resource_path:
type: string
responses:
'200':
description: Connection settings
content:
application/json:
schema:
type: object
properties:
s3fs_args:
type: object
properties:
endpoint_url:
type: string
key:
type: string
secret:
type: string
use_ssl:
type: boolean
cache_regions:
type: boolean
client_kwargs:
type: object
properties: *ref_93
required: *ref_94
required:
- endpoint_url
- use_ssl
- cache_regions
- client_kwargs
storage_options:
type: object
properties:
aws_endpoint_url:
type: string
aws_access_key_id:
type: string
aws_secret_access_key:
type: string
aws_region:
type: string
aws_allow_http:
type: string
required:
- aws_endpoint_url
- aws_region
- aws_allow_http
required:
- s3fs_args
- storage_options
/w/{workspace}/job_helpers/v2/s3_resource_info:
post:
summary: >-
Returns the s3 resource associated to the provided path, or the
workspace default S3 resource
operationId: s3ResourceInfo
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
requestBody:
description: >-
S3 resource path to use. If empty, the S3 resource defined in the
workspace settings will be used
required: true
content:
application/json:
schema:
type: object
properties:
s3_resource_path:
type: string
responses:
'200':
description: Connection settings
content:
application/json:
schema:
type: object
properties: *ref_91
required: *ref_92
/w/{workspace}/job_helpers/test_connection:
get:
summary: Test connection to the workspace datasets storage
operationId: datasetStorageTestConnection
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
responses:
'200':
description: Connection settings
content:
application/json:
schema: {}
/w/{workspace}/job_helpers/list_stored_files:
get:
summary: List the file keys available in the workspace files storage (S3)
operationId: listStoredFiles
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: max_keys
in: query
required: true
schema:
type: integer
- name: marker
in: query
schema:
type: string
- name: prefix
in: query
schema:
type: string
responses:
'200':
description: List of file keys
content:
application/json:
schema:
type: object
properties:
next_marker:
type: string
windmill_large_files:
type: array
items:
type: object
properties: &ref_169
s3:
type: string
required: &ref_170
- s3
restricted_access:
type: boolean
required:
- windmill_large_files
/w/{workspace}/job_helpers/load_file_metadata:
get:
summary: Load metadata of the file
operationId: loadFileMetadata
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: file_key
in: query
required: true
schema:
type: string
responses:
'200':
description: FileMetadata
content:
application/json:
schema:
type: object
properties: &ref_171
mime_type:
type: string
size_in_bytes:
type: integer
last_modified:
type: string
format: date-time
expires:
type: string
format: date-time
version_id:
type: string
/w/{workspace}/job_helpers/load_file_preview:
get:
summary: Load a preview of the file
operationId: loadFilePreview
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: file_key
in: query
required: true
schema:
type: string
- name: file_size_in_bytes
in: query
schema:
type: integer
- name: file_mime_type
in: query
schema:
type: string
- name: csv_separator
in: query
schema:
type: string
- name: csv_has_header
in: query
schema:
type: boolean
- name: read_bytes_from
in: query
schema:
type: integer
- name: read_bytes_length
in: query
schema:
type: integer
responses:
'200':
description: FilePreview
content:
application/json:
schema:
type: object
properties: &ref_172
msg:
type: string
content:
type: string
content_type:
type: string
enum:
- RawText
- Csv
- Parquet
- Unknown
required: &ref_173
- content_type
/w/{workspace}/job_helpers/load_parquet_preview/{path}:
get:
summary: Load a preview of a parquet file
operationId: loadParquetPreview
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: path
in: path
required: true
schema: *ref_17
- name: offset
in: query
schema:
type: number
- name: limit
in: query
schema:
type: number
- name: sort_col
in: query
schema:
type: string
- name: sort_desc
in: query
schema:
type: boolean
- name: search_col
in: query
schema:
type: string
- name: search_term
in: query
schema:
type: string
responses:
'200':
description: Parquet Preview
content:
application/json:
schema: {}
/w/{workspace}/job_helpers/delete_s3_file:
delete:
summary: Permanently delete file from S3
operationId: deleteS3File
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: file_key
in: query
required: true
schema:
type: string
responses:
'200':
description: Confirmation
content:
application/json:
schema: {}
/w/{workspace}/job_helpers/move_s3_file:
get:
summary: Move a S3 file from one path to the other within the same bucket
operationId: moveS3File
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: src_file_key
in: query
required: true
schema:
type: string
- name: dest_file_key
in: query
required: true
schema:
type: string
responses:
'200':
description: Confirmation
content:
application/json:
schema: {}
/w/{workspace}/job_helpers/upload_s3_file:
post:
summary: Upload file to S3 bucket
operationId: fileUpload
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: file_key
in: query
required: false
schema:
type: string
- name: file_extension
in: query
required: false
schema:
type: string
- name: s3_resource_path
in: query
required: false
schema:
type: string
- name: resource_type
in: query
required: false
schema:
type: string
requestBody:
description: File content
required: true
content:
application/octet-stream:
schema:
type: string
format: binary
responses:
'200':
description: File upload status
content:
application/json:
schema:
type: object
properties:
file_key:
type: string
required:
- file_key
/w/{workspace}/job_helpers/download_s3_file:
get:
summary: Download file to S3 bucket
operationId: fileDownload
tags:
- helpers
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: file_key
in: query
required: true
schema:
type: string
- name: s3_resource_path
in: query
required: false
schema:
type: string
- name: resource_type
in: query
required: false
schema:
type: string
responses:
'200':
description: Chunk of the downloaded file
content:
application/octet-stream:
schema:
type: string
format: binary
/w/{workspace}/job_metrics/get/{id}:
post:
summary: get job metrics
operationId: getJobMetrics
tags:
- metrics
parameters:
- name: workspace
in: path
required: true
schema: *ref_0
- name: id
in: path
required: true
schema: *ref_73
requestBody:
description: parameters for statistics retrieval
required: true
content:
application/json:
schema:
type: object
properties:
timeseries_max_datapoints:
type: integer
from_timestamp:
type: string
format: date-time
to_timestamp:
type: string
format: date-time
responses:
'200':
description: job details
content:
application/json:
schema:
type: object
properties:
metrics_metadata:
type: array
items:
type: object
properties: &ref_176
id:
type: string
name:
type: string
required: &ref_177
- id
scalar_metrics:
type: array
items:
type: object
properties: &ref_178
metric_id:
type: string
value:
type: number
required: &ref_179
- id
- value
timeseries_metrics:
type: array
items:
type: object
properties: &ref_180
metric_id:
type: string
values:
type: array
items:
type: object
properties: &ref_182
timestamp:
type: string
format: date-time
value:
type: number
required: &ref_183
- timestamp
- value
required: &ref_181
- id
- values
/concurrency_groups/list:
get:
summary: List all concurrency groups
operationId: listConcurrencyGroups
tags:
- concurrencyGroups
responses:
'200':
description: all concurrency groups
content:
application/json:
schema:
type: array
items:
type: object
properties: &ref_186
concurrency_id:
type: string
job_uuids:
type: array
items:
type: string
required: &ref_187
- concurrency_id
- job_uuids
/concurrency_groups/{concurrency_id}:
delete:
summary: Delete concurrency group
operationId: deleteConcurrencyGroup
tags:
- concurrencyGroups
parameters:
- name: concurrency_id
in: path
required: true
schema: &ref_109
type: string
responses:
'200':
description: concurrency group removed
content:
application/json:
schema:
type: object
properties: {}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
cookieAuth:
type: apiKey
in: cookie
name: token
parameters:
Key:
name: key
in: path
required: true
schema: *ref_7
WorkspaceId:
name: workspace
in: path
required: true
schema: *ref_0
VersionId:
name: version
in: path
required: true
schema: *ref_95
Token:
name: token
in: path
required: true
schema: *ref_96
AccountId:
name: id
in: path
required: true
schema: *ref_21
ClientName:
name: client_name
in: path
required: true
schema: *ref_20
ScriptPath:
name: path
in: path
required: true
schema: *ref_29
ScriptHash:
name: hash
in: path
required: true
schema: *ref_33
JobId:
name: id
in: path
required: true
schema: *ref_73
Path:
name: path
in: path
required: true
schema: *ref_17
PathId:
name: id
in: path
required: true
schema: *ref_24
PathVersion:
name: version
in: path
required: true
schema: *ref_97
Name:
name: name
in: path
required: true
schema: *ref_80
Page:
name: page
description: which page to return (start at 1, default 1)
in: query
schema: *ref_3
PerPage:
name: per_page
description: number of items to return for a given page (default 30, max 100)
in: query
schema: *ref_4
OrderDesc:
name: order_desc
description: order by desc order (default true)
in: query
schema: *ref_41
CreatedBy:
name: created_by
description: mask to filter exact matching user creator
in: query
schema: *ref_42
ParentJob:
name: parent_job
description: >-
The parent job that is at the origin and responsible for the execution
of this script if any
in: query
schema: *ref_36
WorkerTag:
name: tag
description: Override the tag to use
in: query
schema: *ref_38
NewJobId:
name: job_id
description: >-
The job id to assign to the created job. if missing, job is chosen
randomly using the ULID scheme. If a job id already exists in the queue
or as a completed job, the request to create one will fail (Bad Request)
in: query
schema: *ref_37
IncludeHeader:
name: include_header
description: >
List of headers's keys (separated with ',') whove value are added to the
args
Header's key lowercased and '-'' replaced to '_' such that
'Content-Type' becomes the 'content_type' arg key
in: query
schema: *ref_39
QueueLimit:
name: queue_limit
description: >
The maximum size of the queue for which the request would get rejected
if that job would push it above that limit
in: query
schema: *ref_40
Payload:
name: payload
description: >
The base64 encoded payload that has been encoded as a JSON. e.g how to
encode such payload encodeURIComponent
`encodeURIComponent(btoa(JSON.stringify({a: 2})))`
in: query
schema: *ref_76
ScriptStartPath:
name: script_path_start
description: mask to filter matching starting path
in: query
schema: *ref_55
SchedulePath:
name: schedule_path
description: mask to filter by schedule path
in: query
schema: *ref_56
ScriptExactPath:
name: script_path_exact
description: mask to filter exact matching path
in: query
schema: *ref_54
ScriptExactHash:
name: script_hash
description: mask to filter exact matching path
in: query
schema: *ref_57
StartedBefore:
name: started_before
description: filter on started before (inclusive) timestamp
in: query
schema: *ref_58
StartedAfter:
name: started_after
description: filter on started after (exclusive) timestamp
in: query
schema: *ref_59
CreatedOrStartedAfter:
name: created_or_started_after
description: >-
filter on created_at for non non started job and started_at otherwise
after (exclusive) timestamp
in: query
schema: *ref_98
CreatedOrStartedBefore:
name: created_or_started_before
description: >-
filter on created_at for non non started job and started_at otherwise
before (inclusive) timestamp
in: query
schema: *ref_99
Success:
name: success
description: filter on successful jobs
in: query
schema: *ref_60
ScheduledForBeforeNow:
name: scheduled_for_before_now
description: filter on jobs scheduled_for before now (hence waitinf for a worker)
in: query
schema: *ref_68
Suspended:
name: suspended
description: filter on suspended jobs
in: query
schema: *ref_100
Running:
name: running
description: filter on running jobs
in: query
schema: *ref_67
ArgsFilter:
name: args
description: filter on jobs containing those args as a json subset (@> in postgres)
in: query
schema: *ref_62
Tag:
name: tag
description: filter on jobs with a given tag/worker group
in: query
schema: *ref_64
ResultFilter:
name: result
description: filter on jobs containing those result as a json subset (@> in postgres)
in: query
schema: *ref_63
After:
name: after
description: filter on created after (exclusive) timestamp
in: query
schema: *ref_101
Before:
name: before
description: filter on created before (exclusive) timestamp
in: query
schema: *ref_102
Username:
name: username
description: filter on exact username of user
in: query
schema: *ref_103
Operation:
name: operation
description: filter on exact or prefix name of operation
in: query
schema: *ref_104
ResourceName:
name: resource
description: filter on exact or prefix name of resource
in: query
schema: *ref_105
ActionKind:
name: action_kind
description: filter on type of operation
in: query
schema: *ref_106
JobKinds:
name: job_kinds
description: >-
filter on job kind (values 'preview', 'script', 'dependencies', 'flow')
separated by,
in: query
schema: *ref_61
RunnableId:
name: runnable_id
in: query
schema: *ref_89
RunnableTypeQuery:
name: runnable_type
in: query
schema: *ref_90
InputId:
name: input
in: path
required: true
schema: *ref_107
GetStarted:
name: get_started
in: query
schema: *ref_108
ConcurrencyId:
name: concurrency_id
in: path
required: true
schema: *ref_109
schemas:
Script:
type: object
properties: *ref_31
required: *ref_32
NewScript:
type: object
properties: *ref_34
required: *ref_35
NewScriptWithDraft:
allOf: *ref_110
ScriptHistory:
type: object
properties: *ref_111
required: *ref_112
ScriptArgs:
type: object
additionalProperties: *ref_14
Input:
type: object
properties: *ref_87
required: *ref_88
CreateInput:
type: object
properties: *ref_113
required: *ref_114
UpdateInput:
type: object
properties: *ref_115
required: *ref_116
RunnableType:
type: string
enum: *ref_117
QueuedJob:
type: object
properties: *ref_71
required: *ref_72
CompletedJob:
type: object
properties: *ref_69
required: *ref_70
Job:
allOf: *ref_74
discriminator: *ref_75
User:
type: object
properties: *ref_8
required: *ref_9
Usage:
type: object
properties: *ref_118
Login:
type: object
properties: *ref_119
required: *ref_120
NewUser:
type: object
properties: *ref_121
required: *ref_122
EditWorkspaceUser:
type: object
properties: *ref_123
TruncatedToken:
type: object
properties: *ref_124
required: *ref_125
NewToken:
type: object
properties: *ref_126
NewTokenImpersonate:
type: object
properties: *ref_127
required: *ref_128
ListableVariable:
type: object
properties: *ref_18
required: *ref_19
ContextualVariable:
type: object
properties: *ref_129
required: *ref_130
CreateVariable:
type: object
properties: *ref_131
required: *ref_132
EditVariable:
type: object
properties: *ref_133
AuditLog:
type: object
properties: *ref_1
required: *ref_2
MainArgSignature:
type: object
properties:
type:
type: string
enum:
- Valid
- Invalid
error:
type: string
star_args:
type: boolean
star_kwargs:
type: boolean
args:
type: array
items:
type: object
properties:
name:
type: string
typ:
oneOf:
- type: string
enum:
- float
- int
- bool
- email
- unknown
- bytes
- dict
- datetime
- sql
- type: object
properties:
resource:
type: string
nullable: true
required:
- resource
- type: object
properties:
str:
type: array
items:
type: string
nullable: true
required:
- str
- type: object
properties:
object:
type: array
items:
type: object
properties:
key:
type: string
typ:
oneOf:
- type: string
enum:
- float
- int
- bool
- email
- unknown
- bytes
- dict
- datetime
- sql
- type: object
properties:
str: {}
required:
- str
required:
- key
- typ
required:
- object
- type: object
properties:
list:
oneOf:
- type: string
enum:
- float
- int
- bool
- email
- unknown
- bytes
- dict
- datetime
- sql
- type: object
properties:
str: {}
required:
- str
nullable: true
required:
- list
has_default:
type: boolean
default: {}
required:
- name
- typ
required:
- star_args
- start_kwargs
- args
- type
- error
Preview:
type: object
properties: *ref_134
required: *ref_135
CreateResource:
type: object
properties: *ref_136
required: *ref_137
EditResource:
type: object
properties: *ref_138
Resource:
type: object
properties: *ref_139
required: *ref_140
ListableResource:
type: object
properties: *ref_141
required: *ref_142
ResourceType:
type: object
properties: *ref_22
required: *ref_23
EditResourceType:
type: object
properties: *ref_143
Schedule:
type: object
properties: *ref_78
required: *ref_79
ScheduleWJobs:
allOf: *ref_144
NewSchedule:
type: object
properties: *ref_145
required: *ref_146
EditSchedule:
type: object
properties: *ref_147
required: *ref_148
Group:
type: object
properties: *ref_83
required: *ref_84
InstanceGroup:
type: object
properties: *ref_81
required: *ref_82
Folder:
type: object
properties: *ref_85
required: *ref_86
WorkerPing:
type: object
properties: *ref_149
required: *ref_150
UserWorkspaceList:
type: object
properties: *ref_151
required: *ref_152
CreateWorkspace:
type: object
properties: *ref_153
required: *ref_154
Workspace:
type: object
properties: *ref_5
required: *ref_6
WorkspaceInvite:
type: object
properties: *ref_12
required: *ref_13
GlobalUserInfo:
type: object
properties: *ref_10
required: *ref_11
Flow:
allOf: *ref_45
FlowMetadata:
type: object
properties: *ref_155
required: *ref_156
OpenFlowWPath:
allOf: *ref_46
FlowPreview:
type: object
properties: *ref_157
required: *ref_158
RestartedFrom:
type: object
properties: *ref_159
Policy:
type: object
properties: *ref_47
ListableApp:
type: object
properties: *ref_160
required: *ref_161
ListableRawApp:
type: object
properties: *ref_162
required: *ref_163
AppWithLastVersion:
type: object
properties: *ref_48
required: *ref_49
AppWithLastVersionWDraft:
allOf: *ref_164
AppHistory:
type: object
properties: *ref_165
required: *ref_166
SlackToken:
type: object
properties:
access_token:
type: string
team_id:
type: string
team_name:
type: string
bot:
type: object
properties:
bot_access_token:
type: string
required:
- access_token
- team_id
- team_name
- bot
TokenResponse:
type: object
properties: *ref_167
required: *ref_168
HubScriptKind:
name: kind
schema: *ref_30
PolarsClientKwargs:
type: object
properties: *ref_93
required: *ref_94
LargeFileStorage:
type: object
properties: *ref_15
WindmillLargeFile:
type: object
properties: *ref_169
required: *ref_170
WindmillFileMetadata:
type: object
properties: *ref_171
WindmillFilePreview:
type: object
properties: *ref_172
required: *ref_173
S3Resource:
type: object
properties: *ref_91
required: *ref_92
WorkspaceGitSyncSettings:
type: object
properties: *ref_16
GitRepositorySettings:
type: object
properties: *ref_174
required: *ref_175
UploadFilePart:
type: object
properties:
part_number:
type: integer
tag:
type: string
required:
- part_number
- tag
MetricMetadata:
type: object
properties: *ref_176
required: *ref_177
ScalarMetric:
type: object
properties: *ref_178
required: *ref_179
TimeseriesMetric:
type: object
properties: *ref_180
required: *ref_181
MetricDataPoint:
type: object
properties: *ref_182
required: *ref_183
RawScriptForDependencies:
type: object
properties: *ref_184
required: *ref_185
ConcurrencyGroup:
type: object
properties: *ref_186
required: *ref_187
StaticTransform:
type: object
properties: *ref_188
required: *ref_189
JavascriptTransform:
type: object
properties: *ref_190
required: *ref_191
InputTransform:
oneOf: *ref_25
discriminator: *ref_26
RawScript:
type: object
properties: *ref_192
required: *ref_193
PathScript:
type: object
properties: *ref_194
required: *ref_195
PathFlow:
type: object
properties: *ref_196
required: *ref_197
FlowModule:
type: object
properties: *ref_27
required: *ref_28
ForloopFlow:
type: object
properties: *ref_198
required: *ref_199
BranchOne:
type: object
properties: *ref_200
required: *ref_201
BranchAll:
type: object
properties: *ref_202
required: *ref_203
Identity:
type: object
properties: *ref_204
required: *ref_205
FlowModuleValue:
oneOf: *ref_206
discriminator: *ref_207
Retry:
type: object
properties: *ref_77
FlowValue:
type: object
properties: *ref_50
required: *ref_51
OpenFlow:
type: object
properties: *ref_43
required: *ref_44
FlowStatusModule:
type: object
properties: *ref_52
required: *ref_53
FlowStatus:
type: object
properties: *ref_65
required: *ref_66