curl
curl -sS -X POST "https://gateway.orbit/api/v1/tools/adopt" \
--cacert /path/to/orbit-root-ca.pem \
-H 'Accept: application/json' \
-H 'X-Orbit-Request-Id: 9d6b1e5c-4a3f-4a1b-9f0e-6d2c3f5a7b81' \
-H 'Content-Type: application/json' \
-d '{"node_id": 7, "manager": "vp", "package": "@openai/codex", "version_constraint": "^0.150"}'{
"data": {
"id": 123,
"node_id": 123,
"manager": "<string>",
"package": "<string>",
"version_constraint": "<string>",
"status": "installing",
"installed_version": "<string>",
"failed_operation": "<string>",
"error_code": "<string>",
"outcome": "<string>"
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"data": {
"id": 123,
"node_id": 123,
"manager": "<string>",
"package": "<string>",
"version_constraint": "<string>",
"status": "installing",
"installed_version": "<string>",
"failed_operation": "<string>",
"error_code": "<string>",
"outcome": "<string>"
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Tools
Adopt a Tool
Records Orbit ownership of one supported installed package. Send the Node, manager, package, and optional SemVer constraint. The call installs, updates, removes, and repins nothing. The same intent returns unchanged. A different constraint, a busy scope, a missing or unsupported package, or missing Node access leaves the host unchanged. error.details.step is adopt. error.details.id is present only when a Tool row already exists. tool.adoption_unsupported also includes error.details.adoption_block.
POST
/
api
/
v1
/
tools
/
adopt
curl
curl -sS -X POST "https://gateway.orbit/api/v1/tools/adopt" \
--cacert /path/to/orbit-root-ca.pem \
-H 'Accept: application/json' \
-H 'X-Orbit-Request-Id: 9d6b1e5c-4a3f-4a1b-9f0e-6d2c3f5a7b81' \
-H 'Content-Type: application/json' \
-d '{"node_id": 7, "manager": "vp", "package": "@openai/codex", "version_constraint": "^0.150"}'{
"data": {
"id": 123,
"node_id": 123,
"manager": "<string>",
"package": "<string>",
"version_constraint": "<string>",
"status": "installing",
"installed_version": "<string>",
"failed_operation": "<string>",
"error_code": "<string>",
"outcome": "<string>"
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"data": {
"id": 123,
"node_id": 123,
"manager": "<string>",
"package": "<string>",
"version_constraint": "<string>",
"status": "installing",
"installed_version": "<string>",
"failed_operation": "<string>",
"error_code": "<string>",
"outcome": "<string>"
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Body
application/json