Skip to documentation
Weavers Docs

Pages and endpoints

Tab to navigate · Enter to openEsc to close

POST /api/eureka/loomy/conversations

Account required · HTTP API reference

All endpoints · Authentication and retries · Download OpenAPI

  • Requires a signed-in account and permission to access this resource. Use identifiers returned by your own account's earlier requests.
  • Protected writes require an allowed Origin, the CSRF cookie and matching X-CSRF-Token header.

Request

ParameterLocationType and requirement
Originheaderstring · required

An origin allowed by this deployment.

X-CSRF-Tokenheaderstring · required

Must match the CSRF cookie issued to this browser.

Body · application/json

Example

Examples use fictional data. Replace identifiers with resources you can access. For account requests, cookies.txt must contain your own session; set CSRF_TOKEN to the matching CSRF cookie value where required.

Save as request.json
{}
cURL (POSIX shell)
curl --include \
  --request POST \
  'https://api.weavers.app/api/eureka/loomy/conversations' \
  --cookie cookies.txt --cookie-jar cookies.txt \
  --header 'Origin: https://weavers.app' \
  --header "X-CSRF-Token: ${CSRF_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data-binary @request.json

Responses

201 · Resource created.

application/json

201 example · synthetic data
{
  "conversation": {
    "conversationId": "1",
    "title": "Example research",
    "preview": null,
    "lastMessageAt": "2025-01-01T00:00:00.000Z",
    "messageCount": 1
  },
  "messages": []
}
View response model
conversation required · object
View conversation model
conversationId required · string
title required · string
preview required · null | string
View preview model
Variant 1: null

null

Variant 2: string

string

lastMessageAt required · string
messageCount required · number

Additional fields: JSON values.

messages required · array of object
View messages model

Array items:

id required · string
requestKey optional · string
role required · "user" | "assistant"
content required · string
createdAt required · string
proposal required · null | object
View proposal model
Variant 1: null

null

Variant 2: object
kind required · "ticker_pool"
reviewRequired optional · false | true
strategyId required · string
strategyRevision required · number
before required · array of string
View before model

Array items:

string

after required · array of string
View after model

Array items:

string

reason required · string

Additional fields: JSON values.

Variant 3: object
kind required · "strategy_name"
strategyId required · string
strategyRevision required · number
before required · string
after required · string

Additional fields: JSON values.

Variant 4: object
kind required · "builder"
strategyId required · string
strategyRevision required · number
stage required · "signal-predictor" | "execution-policy"
changes required · array of object
View changes model

Array items:

controlId required · string
value required · null | string | number | false | true
View value model
Variant 1: null

null

Variant 2: string

string

Variant 3: number

number

Variant 4: false

false

Variant 5: true

true

reason required · string

Additional fields: JSON values.

review required · array of object
View review model

Array items:

Variant 1: object
controlId required · string
ok required · true
label required · string
before required · null | string | number | false | true
View before model
Variant 1: null

null

Variant 2: string

string

Variant 3: number

number

Variant 4: false

false

Variant 5: true

true

after required · null | string | number | false | true
View after model
Variant 1: null

null

Variant 2: string

string

Variant 3: number

number

Variant 4: false

false

Variant 5: true

true

Additional fields: JSON values.

Variant 2: object
controlId required · string
ok required · false
label required · null | string
View label model
Variant 1: null

null

Variant 2: string

string

error required · string

Additional fields: JSON values.

Additional fields: JSON values.

Variant 5: object
kind required · "data_window"
strategyId required · string
strategyRevision required · number
before required · object
View before model
startDate required · string
endDate required · string
holdoutDays optional · null | number
View holdoutDays model
Variant 1: null

null

Variant 2: number

number

holdoutStartDate optional · null | string
View holdoutStartDate model
Variant 1: null

null

Variant 2: string

string

Additional fields: JSON values.

after required · object
View after model
startDate required · string
endDate required · string
holdoutDays optional · null | number
View holdoutDays model
Variant 1: null

null

Variant 2: number

number

holdoutStartDate optional · null | string
View holdoutStartDate model
Variant 1: null

null

Variant 2: string

string

Additional fields: JSON values.

reason required · string

Additional fields: JSON values.

Variant 6: object
kind required · "navigation"
strategyId required · string
strategyRevision required · number
view required · "python" | "tickers" | "notebook" | "canvas" | "builder" | "preflight"
symbols required · array of string
View symbols model

Array items:

string

Additional fields: JSON values.

Variant 7: object
kind required · "notebook"
strategyId required · string
strategyRevision required · number
notebookKey required · string
response required · object
View response model
schema required · "weavers.notebook.codex_assistant.v1"
version required · 1
message required · string
edits required · array of object
View edits model

Array items:

Variant 1: object
operation required · "replace_cell_source"
cellId required · string
source required · string
reason optional · string

Additional fields: JSON values.

Variant 2: object
operation required · "create_cell"
cellId optional · string
afterCellId optional · null | string
View afterCellId model
Variant 1: null

null

Variant 2: string

string

source required · string
reason optional · string

Additional fields: JSON values.

Variant 3: object
operation required · "delete_cell"
cellId required · string
reason optional · string

Additional fields: JSON values.

Variant 4: object
operation required · "move_cell"
cellId required · string
afterCellId optional · null | string
View afterCellId model
Variant 1: null

null

Variant 2: string

string

reason optional · string

Additional fields: JSON values.

warnings required · array of string
View warnings model

Array items:

string

Additional fields: JSON values.

Additional fields: JSON values.

Variant 8: object
kind required · "python_source"
strategyId required · string
strategyRevision required · number
beforeSourceRevision required · number
beforeSourceSha256 required · null | string
View beforeSourceSha256 model
Variant 1: null

null

Variant 2: string

string

beforeSource required · null | string
View beforeSource model
Variant 1: null

null

Variant 2: string

string

datasetVersionId required · null | string
View datasetVersionId model
Variant 1: null

null

Variant 2: string

string

datasetSha256 required · null | string
View datasetSha256 model
Variant 1: null

null

Variant 2: string

string

experimentDraftId required · null | string
View experimentDraftId model
Variant 1: null

null

Variant 2: string

string

experimentDraftRevision required · null | number
View experimentDraftRevision model
Variant 1: null

null

Variant 2: number

number

source required · string
reason required · string

Additional fields: JSON values.

Variant 9: object
kind required · "canvas_block"
strategyId required · string
strategyRevision required · number
blockKind required · "channel" | "ohlc" | "coverage" | "behaviour"
symbols required · array of string
View symbols model

Array items:

string

timeframe required · "1D" | "1H"
startDate required · string
endDate required · string

Additional fields: JSON values.

Variant 10: object
kind required · "canvas_plan"
reviewRequired optional · false | true
strategyId required · string
strategyRevision required · number
tickerPool required · null | object
View tickerPool model
Variant 1: null

null

Variant 2: object
before required · array of string
View before model

Array items:

string

after required · array of string
View after model

Array items:

string

reason required · string

Additional fields: JSON values.

chartSymbols required · array of string
View chartSymbols model

Array items:

string

blocks required · array of object
View blocks model

Array items:

blockKind required · "channel" | "ohlc" | "coverage" | "behaviour"
symbols required · array of string
View symbols model

Array items:

string

timeframe required · "1D" | "1H"
startDate required · string
endDate required · string

Additional fields: JSON values.

Additional fields: JSON values.

Variant 11: object
kind required · "canvas_evidence"
strategyId required · string
strategyRevision required · number
runId required · null | string
View runId model
Variant 1: null

null

Variant 2: string

string

evidenceKinds required · array of "folds" | "run_summary" | "trajectories" | "pareto" | "calibration" | "equity" | "validation_overlay" | "holdout_replay" | "certification"
View evidenceKinds model

Array items:

"folds" | "run_summary" | "trajectories" | "pareto" | "calibration" | "equity" | "validation_overlay" | "holdout_replay" | "certification"

Additional fields: JSON values.

pythonContext optional · object
View pythonContext model
sourceRevision required · number
sourceSha256 required · null | string
View sourceSha256 model
Variant 1: null

null

Variant 2: string

string

datasetVersionId required · null | string
View datasetVersionId model
Variant 1: null

null

Variant 2: string

string

datasetSha256 required · null | string
View datasetSha256 model
Variant 1: null

null

Variant 2: string

string

experimentDraftId required · null | string
View experimentDraftId model
Variant 1: null

null

Variant 2: string

string

experimentDraftRevision required · null | number
View experimentDraftRevision model
Variant 1: null

null

Variant 2: number

number

Additional fields: JSON values.

Additional fields: JSON values.

Additional fields: JSON values.

400 · Invalid request.

application/json

400 example · synthetic data
{}
View response model

Error envelopes can include resource-specific details. Check the status before reading these fields.

error optional · string
code optional · string
message optional · string

Additional fields: JSON values.

401 · Authentication is missing or invalid.

application/json

401 example · synthetic data
{}
View response model

Error envelopes can include resource-specific details. Check the status before reading these fields.

error optional · string
code optional · string
message optional · string

Additional fields: JSON values.

403 · Permission, origin or CSRF check failed.

application/json

403 example · synthetic data
{}
View response model

Error envelopes can include resource-specific details. Check the status before reading these fields.

error optional · string
code optional · string
message optional · string

Additional fields: JSON values.

429 · Rate limit reached; honor Retry-After when supplied.

application/json

429 example · synthetic data
{}
View response model

Error envelopes can include resource-specific details. Check the status before reading these fields.

error optional · string
code optional · string
message optional · string

Additional fields: JSON values.

500 · Server failure.

application/json

500 example · synthetic data
{
  "error": "example",
  "code": "example"
}
View response model
error required · string
code required · string
requestId optional · string

Additional fields: JSON values.

default · Operation-specific error. Inspect error/code before deciding whether to retry.

application/json

default example · synthetic data
{
  "error": "example",
  "code": "example"
}
View response model
Variant 1: object
requestId optional · string
error required · string
code required · string

Additional fields: JSON values.

Variant 2: object
error required · string
code required · string

Additional fields: JSON values.