Read an agent conversation

GET

/api/v1/agents/{id}/messages

Code sample: cURL

curl 'https://api.justcrawl.io/api/v1/agents/AGENT_ID/messages?limit=200' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Returns the tenant-scoped transcript. The latest 200 rows are returned by default.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Agent and conversation id.

Query Parameters

limit

integer

default: 200 >= 1 <= 200

latest

boolean

default: true

False returns the oldest page; true returns the most recent page.

Responses

200

Conversation messages in sequence order.

Media typeapplication/json

object

messages

required

Array<object>

object

id

required

string format: uuid

conversationId

required

string format: uuid

role

required

string

Allowed values: user assistant tool system

content

required

object

key

additional properties

any

turnId

required

string format: uuid

nullable

seq

required

integer

model

required

string

nullable

inputTokens

required

integer

nullable

outputTokens

required

integer

nullable

createdAt

required

string format: date-time

Example

{
  "messages": [
    {
      "role": "user"
    }
  ]
}

401

Missing or invalid authentication token

Media typeapplication/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media typeapplication/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

404

Resource not found

Media typeapplication/json

object

error

string

Example

{
  "error": "Workflow not found"
}

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}