POST /api/human-support/conversations/current/messages

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

Parameter	Location	Type and requirement
`x-idempotency-key`	header	string · required Pattern: `^[A-Za-z0-9_-]{8,128}$`
`Origin`	header	string · required An origin allowed by this deployment.
`X-CSRF-Token`	header	string · required Must match the CSRF cookie issued to this browser.

Body · application/json

message required · string

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

{
  "message": "Explain the data used in this research."
}

cURL (POSIX shell)

curl --include \
  --request POST \
  'https://api.weavers.app/api/human-support/conversations/current/messages' \
  --cookie cookies.txt --cookie-jar cookies.txt \
  --header 'x-idempotency-key: example-request-0001' \
  --header 'Origin: https://weavers.app' \
  --header "X-CSRF-Token: ${CSRF_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data-binary @request.json

Responses

200 · Successful response.

application/json

200 example · synthetic data

{
  "conversation": {
    "id": "1",
    "userId": 1,
    "title": "Example research",
    "status": "waiting_for_human",
    "preview": null,
    "lastMessageAt": "2025-01-01T00:00:00.000Z",
    "lastUserMessageAt": null,
    "lastAgentMessageAt": null,
    "claimedAt": null,
    "resolvedAt": null,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z",
    "metadata": {}
  },
  "message": {
    "id": "1",
    "conversationId": "1",
    "senderRole": "user",
    "senderUserId": null,
    "content": "Explain the data used in this research.",
    "metadata": {},
    "createdAt": "2025-01-01T00:00:00.000Z"
  },
  "createdConversation": false
}

View response model

conversation required · object

View conversation model

id required · string

userId required · number

title required · string

status required · "waiting_for_human" | "waiting_for_user" | "resolved"

preview required · null | string

View preview model

Variant 1: null

null

Variant 2: string

string

lastMessageAt required · string

lastUserMessageAt required · null | string

View lastUserMessageAt model

Variant 1: null

null

Variant 2: string

string

lastAgentMessageAt required · null | string

View lastAgentMessageAt model

Variant 1: null

null

Variant 2: string

string

claimedAt required · null | string

View claimedAt model

Variant 1: null

null

Variant 2: string

string

resolvedAt required · null | string

View resolvedAt model

Variant 1: null

null

Variant 2: string

string

createdAt required · string

updatedAt required · string

metadata required · object

View metadata model

Additional fields: JSON value.

Additional fields: JSON values.

message required · object

View message model

id required · string

conversationId required · string

senderRole required · "user" | "system" | "agent"

senderUserId required · null | number

View senderUserId model

Variant 1: null

null

Variant 2: number

number

content required · string

metadata required · object

View metadata model

Additional fields: JSON value.

createdAt required · string

Additional fields: JSON values.

createdConversation required · boolean

Additional fields: JSON values.

201 · Resource created.

application/json

201 example · synthetic data

{
  "conversation": {
    "id": "1",
    "userId": 1,
    "title": "Example research",
    "status": "waiting_for_human",
    "preview": null,
    "lastMessageAt": "2025-01-01T00:00:00.000Z",
    "lastUserMessageAt": null,
    "lastAgentMessageAt": null,
    "claimedAt": null,
    "resolvedAt": null,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z",
    "metadata": {}
  },
  "message": {
    "id": "1",
    "conversationId": "1",
    "senderRole": "user",
    "senderUserId": null,
    "content": "Explain the data used in this research.",
    "metadata": {},
    "createdAt": "2025-01-01T00:00:00.000Z"
  },
  "createdConversation": false
}

View response model

conversation required · object

View conversation model

id required · string

userId required · number

title required · string

status required · "waiting_for_human" | "waiting_for_user" | "resolved"

preview required · null | string

View preview model

Variant 1: null

null

Variant 2: string

string

lastMessageAt required · string

lastUserMessageAt required · null | string

View lastUserMessageAt model

Variant 1: null

null

Variant 2: string

string

lastAgentMessageAt required · null | string

View lastAgentMessageAt model

Variant 1: null

null

Variant 2: string

string

claimedAt required · null | string

View claimedAt model

Variant 1: null

null

Variant 2: string

string

resolvedAt required · null | string

View resolvedAt model

Variant 1: null

null

Variant 2: string

string

createdAt required · string

updatedAt required · string

metadata required · object

View metadata model

Additional fields: JSON value.

Additional fields: JSON values.

message required · object

View message model

id required · string

conversationId required · string

senderRole required · "user" | "system" | "agent"

senderUserId required · null | number

View senderUserId model

Variant 1: null

null

Variant 2: number

number

content required · string

metadata required · object

View metadata model

Additional fields: JSON value.

createdAt required · string

Additional fields: JSON values.

createdConversation required · boolean

Additional fields: JSON values.

400 · Invalid request.

application/json

400 example · synthetic data

{
  "error": "example",
  "code": "example"
}

View response model

Variant 1: object

error required · string

code required · 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.

409 · Revision, state or idempotency conflict.

application/json

409 example · synthetic data

{
  "error": "example",
  "code": "example"
}

View response model

error required · string

code required · 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

Additional fields: JSON values.

503 · Service or dependency unavailable.

application/json

503 example · synthetic data

{
  "error": "example",
  "code": "example"
}

View response model

error required · string

code required · string

Additional fields: JSON values.