Topolo Docs Topolo Platform
Open workspace

Get agent pack

Connect portable agent pack identities, scoped continuity and Bytes artifacts through published workspace contracts.

Reviewed source-contract reference. CLI 0.13.4 is released. Hosted pack contracts below are taken from Agent source 573c9a11b1b6674b163ce21273a162a4ed453282; their activation and deployed worked responses remain pending. This draft does not establish settings, shared context or intake acceptance for the existing 70 Codex and 70 Claude agents.

Outcome

Connect portable agent pack identities, scoped continuity and Bytes artifacts through published workspace contracts.

GET /api/agent-packs/{instanceId}

Before calling

Discover the exact credential-scoped published action and intended context. Bind the authorized Agent workspace when required. Confirm the declared agents:read permission. This is a read; it does not authorize a later mutation.

Input fields

FieldRequiredType
instanceIdYesstring

Source input template

The following schema-based example is illustrative and has not been executed. Every fixture identifier/decision reference must be replaced with a genuinely discovered resource or recorded decision. Do not send it unchanged.

{
  "instanceId": "example-pack-instance"
}

Interpret and verify

  • Validate the response against outputSchema and confirm it belongs to the selected workspace.

The exact input and output schemas accompany this draft in the hidden agent layer and contract bundle. No successful/refused deployed response is supplied here; capture and validate it after the original activation/usage proof.

Effects

  • Reads the selected Agent workspace resource without changing service state.

Errors and recovery

  • 401 authentication_required: Authenticate again or provide a valid Topolo API key.
  • 403 permission_denied: Grant the required Agent permission and workspace binding.
  • 422 invalid_input: Correct the request using inputSchema, then validate before retrying.
  • 429 rate_limited: Wait for Retry-After when present, then retry without a duplicate concurrent call.
  • 503 dependency_unavailable: Retry the action; if it persists, inspect the request ID.

This action does not change service state.