Get a resource
GET/api/v1/catalog/resources/{id}
One resource with its current state (the redacted document its
source sent), its connections to other resources, its
application and, for a workload, its latest live report. For a
key that also holds catalog:component:read, proposals lists the
match proposals waiting on it.
Requires the catalog:resource:read scope.
Authorization
Parameters
Path parameters
idstring requiredThe resource's ID.
Responses
200
The resource.
dataResourceDetailShow ResourceDetail properties
idstringenvironment_idstringsource_idstringexternal_idstringproviderstringkindstringnamestringnamespacestringcomponent_idstring | nullcomponent_bound_bystring | nullWhat bound it to its service, when something did.statusstringmissing_sincestring (date-time) | nullfirst_seen_atstring (date-time)last_seen_atstring (date-time)imagesarray of stringstateobject | nullidstringcontent_hashstringpayloadobjectThe redacted document its source sent.observed_atstring (date-time)
proposalsarray of MatchOnly withcatalog:component:read.Show Match properties
idstringresource_idstring | nullapplication_idstring | nullcomponent_idstring | nullThe service proposed, when it exists.proposed_slugstring | nullA slug nobody declared yet; accepting creates that service.reasonstringWhich rule proposed it.confidencenumberstatusstringdecided_bystring | nulldecided_atstring (date-time) | nullcreated_atstring (date-time)resourceobject | nullenvironment_idstringproviderstringkindstringnamestringnamespacestringstatusstring
applicationobject | nullenvironment_idstringnamespacestringnamestringkey_sourcestringowner_hintstring | null
componentobject | nullslugstringdisplay_namestring
connectionsarray of objectdirectionstringtypestringother_idstring | nullother_kindstringother_namestringother_namespacestringdeclaredbooleanTrue for a link people declared, false for one observed.
connections_truncatedbooleanapplicationobject | nullidstringnamestringkey_sourcestring
liveLive | null- Live
Show Live properties
desiredintegerreadyintegeravailableintegerupdatedintegerpodsobjectPods by phase.restartsintegerreasonsobjectContainers in each failing state, such asCrashLoopBackOff.pods_seenbooleanobserved_atstring (date-time)healthHealth
- null
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
403
The key lacks a scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
404
Nothing with this ID (or slug) exists in the organization (NOT_FOUND).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X GET 'https://evohub.io/api/v1/catalog/resources/res_6b8d0f2a4c6e8a1c3e5b7d9f1a3c5e7b' \
-H 'Authorization: Bearer <TOKEN>'
