API reference

Retrieve one item of a conversation.

GET

/conversations/{conversation_id}/items/{item_id}

const url = 'https://api.helping.io/v1/conversations/example/items/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.helping.io/v1/conversations/example/items/example \
  --header 'Authorization: Bearer <token>'

Authorizations

api_key

Parameters

Path Parameters

conversation_id

required

string

The opaque conv_... id of the conversation

item_id

required

string

The item’s id, as the item list returned it

Query Parameters

include

Array<string>

Allowed values: reasoning.encrypted_content message.output_text.logprobs message.input_image.image_url file_search_call.results web_search_call.results web_search_call.action.sources computer_call_output.output.image_url code_interpreter_call.outputs

Extras to return that are omitted by default.

Responses

200

The item.

400

An include value this API does not recognize.

401

Missing or invalid API key (the error envelope)

403

The key is not entitled to what the request asked for (the error envelope)

404

No such conversation or item, or one this key cannot reach.

429

This organization has exhausted its retrieval allowance; retry after the Retry-After header.

500

The request could not be completed; quote the x-request-id response header when reporting it.

503

The request could not be served this instant; retry after the Retry-After header.