Read the author's open Pixel conversation

GET

/v1/pixel/conversation

curl --request GET \
  --url https://api.pixonaut.app/v1/pixel/conversation \
  --header 'Authorization: Bearer <token>'

Operation ID: pixelConversation.get

A studio member’s open conversation, or the one a member holds in a connected store: a member key reads the conversation its member’s turns in that store hold, never the member’s studio one or another store’s.

Authorizations

• memberKey

Responses

200

The open conversation, or null when the author has none

Media typeapplication/json

object

conversation

required

object

cards

required

object

key

additional properties

object

change

object

added

required

Array<object>

object

label

required

string

renamedTo

string

text

string

type

required

string

changed

required

Array<object>

object

label

required

string

renamedTo

string

text

string

type

required

string

removed

required

Array<object>

object

label

required

string

renamedTo

string

text

string

type

required

string

restyled

required

boolean

current

object

name

string

names

Array<string>

estimate

object

availableCredits

required

number

credits

required

number

input

pictures

Array<object>

object

assetId

required

string

heightPx

required

number

letteringUnreliable

required

boolean

widthPx

required

number

refusedWith

string

runId

string

savedRevisions

object

key

additional properties

number

showcases

Array<object>

object

baseId

required

string

before

required

Array<object>

<= 50 items

object

id

required

string

/^[A-Za-z0-9_-]{1,40}$/

name

required

string

>= 1 characters <= 60 characters

values

required

object

key

additional properties

object

key

additional properties

name

required

string

status

required

string

tool

required

string

upscaleId

string

contentKeys

required

object

key

additional properties

string

id

required

string

messages

required

Array

Any of:

object

object

content

required

Any of:

string

string

>= 1 characters

Array

Array

>= 1 items

Any of:

object

object

text

required

string

type

required

string

Allowed values: text

object

object

assetId

required

string

type

required

string

Allowed values: attachment

object

object

type

required

string

Allowed values: upload

uploadId

required

string

object

object

content

required

Any of:

string

string

Array

Array

Any of:

object

object

text

required

string

type

required

string

Allowed values: text

object

object

of

required

One of:

object

object

id

required

string

>= 1 characters <= 200 characters /^[a-z0-9-]+(@\d+)?$/

kind

required

string

Allowed values: template

object

object

id

required

string

>= 1 characters <= 200 characters

kind

required

string

Allowed values: design

revision

required

integer

> 0

object

object

id

required

string

kind

required

string

Allowed values: asset

object

object

id

required

string

kind

required

string

Allowed values: upload

object

object

id

required

string

>= 1 characters <= 200 characters /^[a-z0-9-]+(@\d+)?$/

kind

required

string

Allowed values: trial

values

required

object

key

additional properties

object

key

additional properties

object

object

blankId

required

string

>= 1 characters <= 200 characters

id

required

string

>= 1 characters <= 200 characters /^([a-z0-9-]+)@(\d+)$/

kind

required

string

Allowed values: template_mockup

mockupId

string

>= 1 characters <= 200 characters

placementId

required

string

>= 1 characters <= 200 characters

viewId

string

>= 1 characters <= 200 characters

object

object

id

required

string

>= 1 characters <= 200 characters

kind

required

string

Allowed values: design_mockup

mockupId

string

>= 1 characters <= 200 characters

placementId

string

>= 1 characters <= 200 characters

viewId

string

>= 1 characters <= 200 characters

type

required

string

Allowed values: picture

is_error

boolean

tool_use_id

required

string

>= 1 characters

type

required

string

Allowed values: tool_result

role

required

string

Allowed values: user

object

object

content

required

Array

>= 1 items

Any of:

object

object

text

required

string

type

required

string

Allowed values: text

object

object

id

required

string

>= 1 characters

input

name

required

string

>= 1 characters

type

required

string

Allowed values: tool_use

object

object

id

required

string

>= 1 characters

input

name

required

string

type

required

string

Allowed values: server_tool_use

object

object

content

required

One of:

object

object

tool_references

required

Array<object>

object

tool_name

required

string

>= 1 characters

type

required

string

type

required

string

Allowed values: tool_search_tool_search_result

object

object

error_code

required

string

type

required

string

Allowed values: tool_search_tool_result_error

tool_use_id

required

string

>= 1 characters

type

required

string

Allowed values: tool_search_tool_result

role

required

string

Allowed values: assistant

unavailable

required

Array<string>

unseen

required

Array<string>

uploads

required

object

key

additional properties

object

kind

required

string

name

required

string

upscaled

required

object

key

additional properties

object

assetId

required

string

heightPx

required

number

letteringUnreliable

required

boolean

widthPx

required

number

working

required

Whether a turn, or a card being applied, holds the conversation now: one still running after the panel that asked for it closed. Read again until it is false to see what it did.

boolean

Examples

Exampleexample

Example

{
  "conversation": {
    "cards": {},
    "contentKeys": {},
    "id": "pcv_5f0c2a9e1b7d4c3a8e6f0b12",
    "messages": [
      {
        "content": "Make a product for the Summer mug template",
        "role": "user"
      },
      {
        "content": [
          {
            "text": "Done: the Summer mug is on sale in the store.",
            "type": "text"
          }
        ],
        "role": "assistant"
      }
    ],
    "unavailable": [],
    "unseen": [],
    "uploads": {},
    "upscaled": {}
  },
  "working": false
}

Headers

X-Request-Id

required

string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

401

Refused: unauthorized, member_link_required, member_link_revoked

Media typeapplication/json

object

error

required

string

Examples

member_link_required

{
  "error": "member_link_required"
}

member_link_revoked

{
  "error": "member_link_revoked"
}

unauthorized

{
  "error": "unauthorized"
}

Headers

X-Request-Id

required

string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

403

Refused: origin_forbidden, feature_disabled, forbidden, workspace_suspended

Media typeapplication/json

object

error

required

string

feature

The feature the tenant does not have. Always sent with feature_disabled.

string

Examples

feature_disabled

{
  "error": "feature_disabled",
  "feature": "api"
}

forbidden

{
  "error": "forbidden"
}

origin_forbidden

{
  "error": "origin_forbidden"
}

workspace_suspended

{
  "error": "workspace_suspended"
}

Headers

X-Request-Id

required

string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

500

Refused: db_error. A request that failed unexpectedly answers as text instead.

object

error

required

string

Examples

Exampledb_error

db_error

{
  "error": "db_error"
}

string

Allowed value: Internal Server Error

Headers

X-Request-Id

required

string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.