# BlobHub

## Docs

- [Introduction](https://docs.blobhub.io/general/introduction.md): Welcome to BlobHub — the end-to-end platform for building and deploying agentic applications.
- [Quickstart](https://docs.blobhub.io/general/quickstart.md): Go from zero to your first Blob, Revision, and Workflow Execution in a few minutes.
- [Concepts](https://docs.blobhub.io/general/concepts.md): Key terms and concepts from the BlobHub universe
- [Service Accounts](https://docs.blobhub.io/general/service-accounts.md): A machine identity that is a user in its own right — not a borrowed human identity.
- [Provisioning](https://docs.blobhub.io/general/provisioning.md): Get a validated credential onto a CI runner, a container, a cluster, or a host — with no terminal involved
- [Architecture](https://docs.blobhub.io/general/architecture.md): A high-level view of the BlobHub stack — surfaces, platform, and Blob Type engines.
- [Introduction](https://docs.blobhub.io/rest-api/introduction.md): BlobHub REST API — the programmatic entry point into the platform.
- [Authentication](https://docs.blobhub.io/rest-api/authentication.md): The three ways to authenticate a request to the BlobHub REST API.
- [Conventions](https://docs.blobhub.io/rest-api/conventions.md): Shared patterns across the BlobHub REST API
- [Google Sign-In](https://docs.blobhub.io/rest-api/auth/google-signin.md)
- [Anonymous Sign-In](https://docs.blobhub.io/rest-api/auth/anonymous-signin.md)
- [Refresh Token](https://docs.blobhub.io/rest-api/auth/refresh-token.md)
- [Impersonate](https://docs.blobhub.io/rest-api/auth/impersonate.md)
- [Get User](https://docs.blobhub.io/rest-api/users/get-user.md)
- [Update User](https://docs.blobhub.io/rest-api/users/update-user.md)
- [Get User Limits](https://docs.blobhub.io/rest-api/users/get-limits.md)
- [List Organizations](https://docs.blobhub.io/rest-api/users/list-orgs.md)
- [Create Account](https://docs.blobhub.io/rest-api/users/create-account.md)
- [List Accounts](https://docs.blobhub.io/rest-api/users/list-accounts.md)
- [Delete User](https://docs.blobhub.io/rest-api/users/delete-user.md)
- [Create Organization](https://docs.blobhub.io/rest-api/orgs/create-org.md)
- [Get Organization](https://docs.blobhub.io/rest-api/orgs/get-org.md)
- [Update Organization](https://docs.blobhub.io/rest-api/orgs/update-org.md)
- [Delete Organization](https://docs.blobhub.io/rest-api/orgs/delete-org.md)
- [List Blobs](https://docs.blobhub.io/rest-api/orgs/list-blobs.md)
- [Get Organization Limits](https://docs.blobhub.io/rest-api/orgs/get-limits.md)
- [Create Blob](https://docs.blobhub.io/rest-api/orgs/create-blob.md)
- [Get Blob](https://docs.blobhub.io/rest-api/blobs/get-blob.md)
- [Update Blob](https://docs.blobhub.io/rest-api/blobs/update-blob.md)
- [Delete Blob](https://docs.blobhub.io/rest-api/blobs/delete-blob.md)
- [Get Blob Limits](https://docs.blobhub.io/rest-api/blobs/get-limits.md)
- [List Revisions](https://docs.blobhub.io/rest-api/blobs/list-revisions.md)
- [Create Revision](https://docs.blobhub.io/rest-api/blobs/create-revision.md)
- [Resolve Metadata](https://docs.blobhub.io/rest-api/blobs/resolve-metadata.md)
- [Create Metadata](https://docs.blobhub.io/rest-api/blobs/create-metadata.md)
- [Get Metadata Item](https://docs.blobhub.io/rest-api/blobs/get-metadata.md)
- [Update Metadata Item](https://docs.blobhub.io/rest-api/blobs/update-metadata.md)
- [Delete Metadata Item](https://docs.blobhub.io/rest-api/blobs/delete-metadata.md)
- [Get Revision](https://docs.blobhub.io/rest-api/revisions/get-revision.md)
- [Update Revision](https://docs.blobhub.io/rest-api/revisions/update-revision.md)
- [Delete Revision](https://docs.blobhub.io/rest-api/revisions/delete-revision.md)
- [Commit Revision](https://docs.blobhub.io/rest-api/revisions/commit-revision.md)
- [Resolve Metadata](https://docs.blobhub.io/rest-api/revisions/resolve-metadata.md)
- [Create Metadata](https://docs.blobhub.io/rest-api/revisions/create-metadata.md)
- [Get Metadata Item](https://docs.blobhub.io/rest-api/revisions/get-metadata.md)
- [Update Metadata Item](https://docs.blobhub.io/rest-api/revisions/update-metadata.md)
- [Delete Metadata Item](https://docs.blobhub.io/rest-api/revisions/delete-metadata.md)
- [List API Keys](https://docs.blobhub.io/rest-api/shared/list-api-keys.md)
- [Create API Key](https://docs.blobhub.io/rest-api/shared/create-api-key.md)
- [Delete API Key](https://docs.blobhub.io/rest-api/shared/delete-api-key.md)
- [List Members](https://docs.blobhub.io/rest-api/shared/list-members.md)
- [Add Member](https://docs.blobhub.io/rest-api/shared/add-member.md)
- [Remove Member](https://docs.blobhub.io/rest-api/shared/delete-member.md)
- [List Credentials](https://docs.blobhub.io/rest-api/shared/list-credentials.md)
- [Create Credential](https://docs.blobhub.io/rest-api/shared/create-credential.md)
- [Delete Credential](https://docs.blobhub.io/rest-api/shared/delete-credential.md)
- [Get Operation](https://docs.blobhub.io/rest-api/operations/get-operation.md)
- [Introduction](https://docs.blobhub.io/web-socket/introduction.md): BlobHub WebSocket API — real-time events across the platform.
- [Authentication](https://docs.blobhub.io/web-socket/authentication.md)
- [Overview](https://docs.blobhub.io/web-socket/protocol/overview.md)
- [Lifecycle](https://docs.blobhub.io/web-socket/protocol/lifecycle.md)
- [Subscription](https://docs.blobhub.io/web-socket/server/subscription.md)
- [Introduction](https://docs.blobhub.io/blob-types/introduction.md): Understanding the different types of Blobs available.
- [Definition Format](https://docs.blobhub.io/blob-types/workflow/workflows/definition-format.md): Understanding the structure of a Workflow Definition
- [Components](https://docs.blobhub.io/blob-types/workflow/workflows/components.md): Understanding the executable nodes that power BlobHub workflows.
- [Code Component (logic.code)](https://docs.blobhub.io/blob-types/workflow/workflows/component-code.md): Execute custom Python code within the workflow environment.
- [Data Types](https://docs.blobhub.io/blob-types/workflow/workflows/data-types.md): Definitions for internal and standard value objects.
- [Session Lifecycle](https://docs.blobhub.io/blob-types/workflow/workflows/session-lifecycle.md): How a session moves between open, closing, closed and deleting — and what each status permits.
- [Session Events](https://docs.blobhub.io/blob-types/workflow/workflows/session-events.md): Definitions for asynchronous events emitted by a Session context.
- [Execution Events](https://docs.blobhub.io/blob-types/workflow/workflows/execution-events.md): Definitions for real-time tracking events emitted during a Workflow Execution.
- [Definition Format](https://docs.blobhub.io/blob-types/workflow/playgrounds/definition-format.md): Understanding the structure of a Playground Definition
- [Widgets](https://docs.blobhub.io/blob-types/workflow/playgrounds/widgets.md): Mapping interactive UI components mapped natively into Playgrounds.
- [Create Definition](https://docs.blobhub.io/blob-types/workflow/operations/create-definition.md)
- [List Definitions](https://docs.blobhub.io/blob-types/workflow/operations/list-definitions.md)
- [Download Definition](https://docs.blobhub.io/blob-types/workflow/operations/download-definition.md)
- [Update Definition](https://docs.blobhub.io/blob-types/workflow/operations/update-definition.md)
- [Delete Definition](https://docs.blobhub.io/blob-types/workflow/operations/delete-definition.md)
- [Check Definition](https://docs.blobhub.io/blob-types/workflow/operations/check-definition.md)
- [Upload Definition Content](https://docs.blobhub.io/blob-types/workflow/operations/upload-definition.md)
- [Create Session](https://docs.blobhub.io/blob-types/workflow/operations/create-session.md)
- [List Sessions](https://docs.blobhub.io/blob-types/workflow/operations/list-sessions.md)
- [Get Session](https://docs.blobhub.io/blob-types/workflow/operations/get-session.md)
- [Update Session](https://docs.blobhub.io/blob-types/workflow/operations/update-session.md)
- [Close Session](https://docs.blobhub.io/blob-types/workflow/operations/close-session.md)
- [Reopen Session](https://docs.blobhub.io/blob-types/workflow/operations/reopen-session.md)
- [Delete Session](https://docs.blobhub.io/blob-types/workflow/operations/delete-session.md)
- [Create Execution](https://docs.blobhub.io/blob-types/workflow/operations/create-execution.md)
- [List Executions](https://docs.blobhub.io/blob-types/workflow/operations/list-executions.md)
- [Get Execution](https://docs.blobhub.io/blob-types/workflow/operations/get-execution.md)
- [Stop Execution](https://docs.blobhub.io/blob-types/workflow/operations/stop-execution.md)
- [List Session Events](https://docs.blobhub.io/blob-types/workflow/operations/list-session-events.md)
- [List Execution Events](https://docs.blobhub.io/blob-types/workflow/operations/list-execution-events.md)
- [Download Event Data](https://docs.blobhub.io/blob-types/workflow/operations/download-execution-event-data.md)
- [List Session Objects](https://docs.blobhub.io/blob-types/workflow/operations/list-session-objects.md)
- [Upload Session Object](https://docs.blobhub.io/blob-types/workflow/operations/upload-session-object.md)
- [Download Session Object](https://docs.blobhub.io/blob-types/workflow/operations/download-session-object.md)
- [Session Objects](https://docs.blobhub.io/blob-types/workflow/session-objects/introduction.md)
- [Introduction](https://docs.blobhub.io/blob-types/workflow/session-objects/thread/introduction.md)
- [Post Session Thread Item](https://docs.blobhub.io/blob-types/workflow/operations/post-session-thread-item.md)
- [List Session Thread Items](https://docs.blobhub.io/blob-types/workflow/operations/list-session-thread-items.md)
- [Get Session Thread Item](https://docs.blobhub.io/blob-types/workflow/operations/get-session-thread-item.md)
- [Introduction](https://docs.blobhub.io/blob-types/workflow/session-objects/graph/introduction.md)
- [Apply Session Graph Mutations](https://docs.blobhub.io/blob-types/workflow/operations/apply-session-graph-mutations.md)
- [Query Session Graph](https://docs.blobhub.io/blob-types/workflow/operations/query-session-graph.md)
- [List Session Graph Elements](https://docs.blobhub.io/blob-types/workflow/operations/list-session-graph-elements.md)
- [List Session Graph Neighbors](https://docs.blobhub.io/blob-types/workflow/operations/list-session-graph-neighbors.md)
- [Get Session Graph Element](https://docs.blobhub.io/blob-types/workflow/operations/get-session-graph-element.md)
- [Get Session Graph Elements](https://docs.blobhub.io/blob-types/workflow/operations/get-session-graph-elements.md)
- [Overview](https://docs.blobhub.io/blob-types/scheduler/overview.md): Understanding the Scheduler blob type.
- [Create Schedule](https://docs.blobhub.io/blob-types/scheduler/operations/create-schedule.md)
- [Update Schedule](https://docs.blobhub.io/blob-types/scheduler/operations/update-schedule.md)
- [Delete Schedule](https://docs.blobhub.io/blob-types/scheduler/operations/delete-schedule.md)
- [List Schedules](https://docs.blobhub.io/blob-types/scheduler/operations/list-schedules.md)
- [Get Schedule](https://docs.blobhub.io/blob-types/scheduler/operations/get-schedule.md)
- [List Executions](https://docs.blobhub.io/blob-types/scheduler/operations/list-executions.md)
- [Upload Model](https://docs.blobhub.io/blob-types/onnx/upload.md)
- [Describe Model](https://docs.blobhub.io/blob-types/onnx/describe.md)
- [Download Model](https://docs.blobhub.io/blob-types/onnx/download.md)
- [Introduction](https://docs.blobhub.io/cli/introduction.md): Drive BlobHub blobs, revisions and workflow code from a terminal
- [Concepts](https://docs.blobhub.io/cli/concepts.md): The CLI mental model: shared and domain commands, manifests, the compiled/verbatim split, and drift
- [Authentication](https://docs.blobhub.io/cli/auth.md): Store credentials, inspect the identity a command runs as, and switch between profiles
- [Utilities](https://docs.blobhub.io/cli/utilities.md): Diagnose a setup with doctor, and install shell completion
- [blobhub blob show](https://docs.blobhub.io/cli/blob/show.md): The blob record and the phase of its latest revision, for a blob of any domain in any phase
- [blobhub blob revisions](https://docs.blobhub.io/cli/blob/revisions.md): Every revision of a blob, newest first, with the latest marked and each phase shown
- [blobhub blob limits](https://docs.blobhub.io/cli/blob/limits.md): The limits that apply to a blob, including the import allowlist, and the admin key needed to read them
- [Configuration](https://docs.blobhub.io/cli/configuration.md): Where credentials live, how a command resolves them, and what it prints on which stream
- [Error codes](https://docs.blobhub.io/cli/error-codes.md): Every code the CLI can raise, what it means, and what to do about it
- [Workflow overview](https://docs.blobhub.io/cli/workflow/overview.md): What a workflow deployment is, the shape of a deployable project, and the ten commands that move it
- [blobhub workflow pull](https://docs.blobhub.io/cli/workflow/commands/pull.md): Download each manifest definition into its source file, verbatim and code-unaware
- [blobhub workflow push](https://docs.blobhub.io/cli/workflow/commands/push.md): Upload each manifest definition verbatim, creating it first when its alias is absent
- [blobhub workflow build](https://docs.blobhub.io/cli/workflow/commands/build.md): Compile each bound component locally and write the result into the definition file — no network
- [blobhub workflow deploy](https://docs.blobhub.io/cli/workflow/commands/deploy.md): Compile, upload only the definitions that changed, then check what was uploaded
- [blobhub workflow diff](https://docs.blobhub.io/cli/workflow/commands/diff.md): Report every local/remote difference — presence, topology, code, remote edits — writing nothing
- [blobhub workflow check](https://docs.blobhub.io/cli/workflow/commands/check.md): Run the platform checker against what is already deployed, and print its events
- [blobhub workflow eject](https://docs.blobhub.io/cli/workflow/commands/eject.md): Split a definition’s stored code into local files, to adopt a workflow authored in the browser
- [blobhub workflow execute](https://docs.blobhub.io/cli/workflow/commands/execute.md): Create an execution of a workflow definition, and with --watch follow it to completion
- [blobhub workflow ls](https://docs.blobhub.io/cli/workflow/commands/ls.md): List the revision’s definitions, marking which ones the manifest covers
- [blobhub workflow prune](https://docs.blobhub.io/cli/workflow/commands/prune.md): Delete the definitions the manifest does not cover — the one command that resolves drift
- [Manifest](https://docs.blobhub.io/cli/workflow/manifest.md): The manifest format: the shared base every blob domain extends, and the workflow_blob_deployment body
- [Compiler](https://docs.blobhub.io/cli/workflow/compiler.md): How a Python package becomes the flat, import-less namespace a logic.code component executes
- [Sandbox](https://docs.blobhub.io/cli/workflow/sandbox.md): What the logic.code sandbox pre-binds, what it refuses, and how the blob import allowlist extends it
- [Scheduler overview](https://docs.blobhub.io/cli/scheduler/overview.md): What a scheduler deployment is, the two blobs one deploy touches, and the four commands that manage it
- [blobhub scheduler ls](https://docs.blobhub.io/cli/scheduler/commands/ls.md): List the revision’s schedules, marking which the manifest covers and which are firing unclaimed
- [blobhub scheduler pull](https://docs.blobhub.io/cli/scheduler/commands/pull.md): Reverse each deployed schedule’s stored UUIDs back into a symbolic manifest, overwriting the file
- [blobhub scheduler diff](https://docs.blobhub.io/cli/scheduler/commands/diff.md): Report per-alias create/update/unchanged plus drift, without writing or deploying anything
- [blobhub scheduler deploy](https://docs.blobhub.io/cli/scheduler/commands/deploy.md): Make the manifest real: create schedules that don’t exist, update those that do, by alias
- [Scheduler manifest](https://docs.blobhub.io/cli/scheduler/manifest.md): The scheduler_blob_deployment body: schedules, their targets, and what is checked before a deploy
- [Introduction](https://docs.blobhub.io/worker/introduction.md): Run BlobHub work on your own machine
- [Concepts](https://docs.blobhub.io/worker/concepts.md): The worker mental model: process, sections, job types, sessions, threads, and agents
- [Authentication and Profiles](https://docs.blobhub.io/worker/auth.md): Store a credential, see which one a start would use, and run several workers on one machine
- [blobhub-worker login](https://docs.blobhub.io/worker/cli/login.md): Store the API key and validate identity
- [blobhub-worker start](https://docs.blobhub.io/worker/cli/start.md): Run the worker
- [blobhub-worker instance](https://docs.blobhub.io/worker/cli/instance.md): Inspect and stop the workers running on this machine
- [Configuration](https://docs.blobhub.io/worker/configuration.md): The complete config.yaml reference
- [Reference](https://docs.blobhub.io/worker/reference.md): Process exit codes and generic worker limitations
- [Introduction](https://docs.blobhub.io/worker/specification.md): The worker specification: data model, on-disk and on-wire state, and sync
- [Filesystem Layout](https://docs.blobhub.io/worker/filesystem.md): The shared credential store, and what a profile keeps under ~/.blobhub-worker/
- [Job Types](https://docs.blobhub.io/worker/job-types.md): The job_type discriminator on a section, and the supported types
- [Introduction](https://docs.blobhub.io/worker/session-agent-harness/overview.md): session_agent_harness: drive coding agents against BlobHub session threads
- [Filesystem Layout](https://docs.blobhub.io/worker/session-agent-harness/filesystem.md): session_agent_harness per-section subtree inside a profile state tree
- [Worker Session Object](https://docs.blobhub.io/worker/session-agent-harness/worker-object.md): Affinity lock and activity log for a worker-attached session
- [Job Session Object](https://docs.blobhub.io/worker/session-agent-harness/thread-object.md): The per-thread session object the worker drives: metadata, ownership, settings
- [Thread Items](https://docs.blobhub.io/worker/session-agent-harness/thread-items.md): Content and metadata shape for items the worker posts
- [Handoff](https://docs.blobhub.io/worker/session-agent-harness/thread-handoff.md): The thread lifecycle state machine: pending, active, completed, failed
- [Interactive](https://docs.blobhub.io/worker/session-agent-harness/interactive-prompts.md): When the agent asks for input: pending_prompt and pending_prompt_resolved items
- [Recovery](https://docs.blobhub.io/worker/session-agent-harness/recovery.md): Behavior across worker restarts, agent crashes, and network blips
- [Reference](https://docs.blobhub.io/worker/session-agent-harness/reference.md): session_agent_harness error codes and limitations
- [Introduction](https://docs.blobhub.io/sdk/introduction.md): BlobHub SDK Documentation

## Optional

- [Main](https://blobhub.io/)
- [Featured](https://blobhub.io/p/blobhub)