Pipeline Assistant

Create Session

post

Create a new pipeline assistant session

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Request to create a new assistant session.

goalstringRequired

What the user wants to accomplish

autonomy_levelany ofOptional

Deprecated. Kept for backward compatibility.

Default: semi_auto

string · enumOptionalPossible values:

or

nullOptional

model_nameany ofOptional

Model to use (e.g., 'anthropic/claude-sonnet-4'). Defaults to configured model.

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/pipeline-assistant/sessions

HTTPcURLJavaScriptPython

POST /api/public/v1/pipeline-assistant/sessions HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "goal": "text",
  "autonomy_level": "semi_auto",
  "model_name": "text"
}

{
  "session_id": "text",
  "goal": "text",
  "autonomy_level": "guided",
  "current_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "messages": [
    {
      "role": "user",
      "content": "text",
      "tool_call_id": "text",
      "timestamp": "2026-03-10T23:53:02.480Z",
      "structured_question": {
        "question": "text",
        "options": [
          {
            "id": "text",
            "label": "text",
            "value": "text",
            "description": "text"
          }
        ]
      },
      "preview_results": {
        "job_id": "text",
        "status": "text",
        "output_dataset_id": "text",
        "total_samples": 0,
        "samples": [
          {
            "question": "text",
            "question_type": "text",
            "label": "text",
            "label_confidence": 1,
            "prompt_preview": "text",
            "metadata_keys": [
              "text"
            ]
          }
        ],
        "notes": [
          "text"
        ]
      }
    }
  ],
  "dataset_ids": [
    "text"
  ],
  "created_at": "2026-03-10T23:53:02.480Z"
}

Send Message

post

Send a message to the assistant

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

session_idstringRequired

Body

application/json

Request to send a message to an assistant session.

contentstringRequired

The user's message

Responses

200

Successful Response

application/json

Response from sending a message.

current_configany ofOptional

Updated pipeline configuration (if changed)

or

nullOptional

422

Validation Error

application/json

post

/pipeline-assistant/sessions/{session_id}/messages

HTTPcURLJavaScriptPython

POST /api/public/v1/pipeline-assistant/sessions/{session_id}/messages HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "content": "text"
}

{
  "message": {
    "role": "user",
    "content": "text",
    "tool_call_id": "text",
    "timestamp": "2026-03-10T23:53:02.480Z",
    "structured_question": {
      "question": "text",
      "options": [
        {
          "id": "text",
          "label": "text",
          "value": "text",
          "description": "text"
        }
      ]
    },
    "preview_results": {
      "job_id": "text",
      "status": "text",
      "output_dataset_id": "text",
      "total_samples": 0,
      "samples": [
        {
          "question": "text",
          "question_type": "text",
          "label": "text",
          "label_confidence": 1,
          "prompt_preview": "text",
          "metadata_keys": [
            "text"
          ]
        }
      ],
      "notes": [
        "text"
      ]
    }
  },
  "current_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Get Session

get

Get the current state of a session

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

session_idstringRequired

Responses

200

Successful Response

application/json

Response containing session state.

session_idstringRequired

Unique session identifier

goalstringRequired

The user's stated goal

autonomy_levelstring · enumRequired

Current autonomy level

Possible values:

current_configany ofOptional

The current pipeline configuration (if generated)

or

nullOptional

dataset_idsstring[]Optional

Dataset IDs generated during this session

created_atstring · date-timeRequired

When the session was created

422

Validation Error

application/json

get

/pipeline-assistant/sessions/{session_id}

HTTPcURLJavaScriptPython

GET /api/public/v1/pipeline-assistant/sessions/{session_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "session_id": "text",
  "goal": "text",
  "autonomy_level": "guided",
  "current_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "messages": [
    {
      "role": "user",
      "content": "text",
      "tool_call_id": "text",
      "timestamp": "2026-03-10T23:53:02.480Z",
      "structured_question": {
        "question": "text",
        "options": [
          {
            "id": "text",
            "label": "text",
            "value": "text",
            "description": "text"
          }
        ]
      },
      "preview_results": {
        "job_id": "text",
        "status": "text",
        "output_dataset_id": "text",
        "total_samples": 0,
        "samples": [
          {
            "question": "text",
            "question_type": "text",
            "label": "text",
            "label_confidence": 1,
            "prompt_preview": "text",
            "metadata_keys": [
              "text"
            ]
          }
        ],
        "notes": [
          "text"
        ]
      }
    }
  ],
  "dataset_ids": [
    "text"
  ],
  "created_at": "2026-03-10T23:53:02.480Z"
}

Delete Session

delete

Delete a session

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

session_idstringRequired

Responses

204

Successful Response

422

Validation Error

application/json

delete

/pipeline-assistant/sessions/{session_id}

HTTPcURLJavaScriptPython

DELETE /api/public/v1/pipeline-assistant/sessions/{session_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content