Skip to content
Docs
Follow yggy on LinkedInFollow @yggy_tech on X

Project hot vs. cold triple storage

GET
/api/v1/projects/{projectId}/storage
 
curl --request GET \
  --url https://api.yggy.tech/api/v1/projects/example/storage \
  --header 'Authorization: Bearer <token>'

Point-in-time estimates of this project’s triple storage: hot triples in the live graph, cold triples in archive storage, and the size of the stored files.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
projectId
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Project tier storage

Media type application/json
object
projectExternalId
required
string
mode
required

Effective storage policy: hot-first or cold-first

string
hotTriples
required

Estimated triples in the live graph

number
coldTriples
required

Triples in cold object storage (manifest count)

number
hydratingTriples
required

Triples currently promoting back to hot

number
blobObjects
required

Distinct cold archive blobs backing this project

number
blobBytes
required

Summed blob bytes (partial when bytesTruncated)

number
bytesTruncated
required

True when blobBytes hit the stat cap and is partial

boolean
Example generated
{
  "projectExternalId": "example",
  "mode": "example",
  "hotTriples": 1,
  "coldTriples": 1,
  "hydratingTriples": 1,
  "blobObjects": 1,
  "blobBytes": 1,
  "bytesTruncated": true
}

404

Section titled “404 ”

Project not found

Media type application/json
object
success
required
boolean
error
required
object
message
required
string
code
required
string
Allowed values: INTERNAL_ERROR VALIDATION_ERROR UNAUTHORIZED RATE_LIMITED ORG_REQUIRED FORBIDDEN NOT_FOUND CONFLICT PROJECT_DENIED USAGE_LIMIT_EXCEEDED HUGINN_ERROR HUGINN_STREAM_ERROR QUERY_FAILED PROVIDER_CONFLICT PROVIDER_CONFIG_INVALID PROVIDER_NOT_CONNECTED PROVIDER_RATE_LIMITED PROJECT_MEMBER_USER_NOT_IN_ORG PROJECT_MEMBER_UNKNOWN_ROLE PROJECT_MEMBER_LAST_OWNER PROJECT_CONFLICT STORAGE_NOT_CONFIGURED BILLING_NOT_CONFIGURED LICENSE_INACTIVE PLAN_REQUIRED MEMBER_LIMIT_REACHED SAGA_ASK_QUOTA_EXCEEDED SAGA_ASK_RATE_LIMITED SAGA_ASK_BUSY SAGA_ASK_PAUSED SAGA_ASK_UPSTREAM SAGA_DICTATION_BUSY SAGA_DICTATION_UNAVAILABLE SAGA_SHARE_LINK_LIMIT PROJECT_MEMBERSHIP_JWT_TOO_LARGE WEBHOOK_URL_INVALID WEBHOOK_ADDRESS_BLOCKED WEBHOOK_EVENT_UNKNOWN WEBHOOK_ENDPOINT_LIMIT WEBHOOK_ENDPOINT_DISABLED WEBHOOK_DELIVERY_IN_PROGRESS ORG_KEY_PERSONAL_SCOPE API_KEY_PERMISSION_EXCEEDS_ROLE API_KEY_NO_PERMISSIONS ORG_KEY_GRAPH_SCOPE_UNAVAILABLE ORG_KEY_TOO_MANY_PROJECTS SENDER_IS_LOGIN_EMAIL SENDER_TAKEN
details
Example 
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR"
  }
}