GoRunner docs
Search or askSearch⌘K

Move a workflow to a folder

PUT/api/workflows/{id}/folder

Files a workflow in a folder, or takes it out of one.

Needs an API token with the Write permission for workflows (workflow:write).

Parameters

Path

idRequired · UUID

The workflow’s ID.

Body

folderIdOptional · UUID or null

A folder in this workspace, or null for no folder. Left out means no folder too.

One folder at a time

A workflow is in one folder at most. Moving it makes no version and doesn’t change definitionRev.

Make and list folders with Create a folder and List folders.

Responses

  • 200OK

    Moved. The answer names the folder it is in now.

  • id isn’t a UUID, the body isn’t JSON, or the folder isn’t in this workspace.

  • The token lacks the Write permission for workflows.

  • No workflow with this ID in the token’s workspace.

  • Nothing moved. Try again.

Any call can also answer: 401 UNAUTHORIZED · 401 TOKEN_ENDED · 403 TOKEN_SURFACE_OFF · 403 FEATURE_OFF · 403 EMBED_NOT_ALLOWED · 403 EMBED_NOT_AVAILABLE · 403 ACCOUNT_SUSPENDED · 413 PAYLOAD_TOO_LARGE · 415 INVALID_CONTENT_TYPE · 429 RATE_LIMITED · 503 BUSY · 503 PAUSED · 503 SERVICE_UNAVAILABLE. See Errors.

Request

GORUNNER="https://api.gorunner.io"
GORUNNER_TOKEN="grt_…"  # needs Write for workflows
WORKFLOW_ID="your-workflow-id"

URL="$GORUNNER/api/workflows/$WORKFLOW_ID/folder"
curl -X PUT "$URL" \
  -H "Authorization: Bearer $GORUNNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "folderId": "7a2c9e41-5b3d-4f08-a6e1-2d9c4b7f0e13"
  }'

Response · 200 OK

json
{
  "data": {
    "id": "3b1e5c2a-7d4f-4e8b-a1c6-5f2d9b0e7a31",
    "folderId": "7a2c9e41-5b3d-4f08-a6e1-2d9c4b7f0e13"
  }
}
Every field

Body

folderIdOptional · UUID or null

Destination folder, or null to remove the workflow from every folder.

Response · 200 OK

dataobject
idUUID
folderIdUUID or null