get items

Everything known about up to 25 items: url, description, tags, fields, starred and hidden state, comments, provenance, lineage, variations, versions, technical data, and understanding (which reads are stored, which are not, what each would cost, and the cloud processing left this month; understanding.next names the tool for each missing read). A ref nothing answers to comes back in unresolved, refs past 25 in truncated, and a part that could not be read in degraded; none of the three fails the call. Free.

POST

/

tools

/

get_items

get items

curl --request POST \
  --url https://eversince.ai/api/v1/tools/get_items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "refs": [
    "<string>"
  ]
}
'

import requests

url = "https://eversince.ai/api/v1/tools/get_items"

payload = { "refs": ["<string>"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({refs: ['<string>']})
};

fetch('https://eversince.ai/api/v1/tools/get_items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the key's own.

Body

application/json

refs

string[]

required

25 a time; the rest come back named in truncated.

Minimum array length: 1

An item ref, item id, or the job id that made it.

fields

enum<string>[]

Only these parts, each one a read of its own. All of them by default.

Available options:

labels,

lineage,

comments,

versions,

variations,

understanding

response_format

enum<string>

concise is the item alone: what it is, its file, technical, description, tags and fields. detailed (the default) adds every part around it.

Available options:

concise,

detailed

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

ok

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

get items

curl --request POST \
  --url https://eversince.ai/api/v1/tools/get_items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "refs": [
    "<string>"
  ]
}
'

import requests

url = "https://eversince.ai/api/v1/tools/get_items"

payload = { "refs": ["<string>"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({refs: ['<string>']})
};

fetch('https://eversince.ai/api/v1/tools/get_items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}