# Nebyoulous

> The astrophotography workspace: plan, sync, stack, and publish from the web, the CLI, or your AI assistant.

- [Nebyoulous](https://docs.nebyoulous.space/index.md): Plan the night, sync the frames, stack in the cloud, and publish the story behind the image, from the web, the CLI, or your AI assistant.
- [Quickstart](https://docs.nebyoulous.space/quickstart.md): Create an account, connect your AI assistant, and sync your first frames.
- [Session planner](https://docs.nebyoulous.space/workspace/planner.md): Plan a night before you pack the car — nightly score, ranked targets, and saved sessions.
- [Gear](https://docs.nebyoulous.space/workspace/gear.md): Record the equipment you own, group it into a rig, and attach that rig to an integration set.
- [Integration sets](https://docs.nebyoulous.space/workspace/integration-sets.md): Group the lights, calibration frames, and exports for one target, then browse, export, or stack them.
- [Stacking](https://docs.nebyoulous.space/workspace/stacking.md): Calibrate, register, and combine the frames in an integration set, or reject frames before you stack.
- [Drafts & posts](https://docs.nebyoulous.space/workspace/posts.md): Iterate privately on a draft, then publish a structured record of the finished image.
- [MCP overview](https://docs.nebyoulous.space/mcp/overview.md): Drive your Nebyoulous workspace from Claude, Cursor, VS Code, or any MCP client.
- [Connect a client](https://docs.nebyoulous.space/mcp/remote.md): Add the hosted Nebyoulous MCP server to Claude Code, Claude Desktop, Cursor, VS Code, or any client that supports remote MCP.
- [CLI server (stdio)](https://docs.nebyoulous.space/mcp/local.md): Run nebyoulous mcp:serve to give your assistant the hosted tools plus local tools that read your disks.
- [Tool reference](https://docs.nebyoulous.space/mcp/tools.md): Every tool the Nebyoulous MCP server exposes: 45 hosted tools, plus 8 local tools on the CLI server.
- [CLI overview](https://docs.nebyoulous.space/cli/overview.md): Install nebyoulous, sign in, and learn the conventions every command shares.
- [Sync frames](https://docs.nebyoulous.space/cli/sync.md): Upload a folder into an integration set, or mirror a card to a local folder. Both skip duplicates and resume after an interruption.
- [Command reference](https://docs.nebyoulous.space/cli/commands.md): Every nebyoulous command with its arguments, flags, and examples.
- [API overview](https://docs.nebyoulous.space/api-reference/introduction.md): The Nebyoulous REST API: base URL, conventions, errors, and how the reference is built.
- [Authentication](https://docs.nebyoulous.space/api-reference/authentication.md): Send a bearer token with every request. Get one with OAuth 2.1 and PKCE, the same flow MCP clients use.
- [Workflows](https://docs.nebyoulous.space/api-reference/workflows.md): End-to-end recipes: upload frames into an integration set, stack them, and download the master.
- [Health check](https://docs.nebyoulous.space/api-reference/system/health-check.md)
- [Return the authenticated Lumigraph actor and user profile.](https://docs.nebyoulous.space/api-reference/account/return-the-authenticated-lumigraph-actor-and-user-profile.md)
- [Update the authenticated user's username.](https://docs.nebyoulous.space/api-reference/account/update-the-authenticated-users-username.md)
- [List integration sets for the authenticated user.](https://docs.nebyoulous.space/api-reference/integration-sets/list-integration-sets-for-the-authenticated-user.md)
- [Create an integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/create-an-integration-set.md)
- [Get an owned integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/get-an-owned-integration-set.md)
- [Update an owned integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/update-an-owned-integration-set.md)
- [Delete an owned integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/delete-an-owned-integration-set.md)
- [List uploaded assets for an owned integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/list-uploaded-assets-for-an-owned-integration-set.md)
- [Delete uploaded integration assets under a folder path.](https://docs.nebyoulous.space/api-reference/integration-sets/delete-uploaded-integration-assets-under-a-folder-path.md)
- [List gear profile links for an integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/list-gear-profile-links-for-an-integration-set.md)
- [Replace gear profile links for an integration set.](https://docs.nebyoulous.space/api-reference/integration-sets/replace-gear-profile-links-for-an-integration-set.md)
- [Mark a presigned upload as complete.](https://docs.nebyoulous.space/api-reference/uploads/mark-a-presigned-upload-as-complete.md)
- [Mark multiple presigned uploads as complete.](https://docs.nebyoulous.space/api-reference/uploads/mark-multiple-presigned-uploads-as-complete.md)
- [Create a presigned upload target.](https://docs.nebyoulous.space/api-reference/uploads/create-a-presigned-upload-target.md)
- [Create presigned upload targets for multiple files.](https://docs.nebyoulous.space/api-reference/uploads/create-presigned-upload-targets-for-multiple-files.md)
- [Delete an integration asset.](https://docs.nebyoulous.space/api-reference/assets/delete-an-integration-asset.md)
- [Redirect to a signed asset download URL.](https://docs.nebyoulous.space/api-reference/assets/redirect-to-a-signed-asset-download-url.md)
- [Redirect to a signed asset view URL.](https://docs.nebyoulous.space/api-reference/assets/redirect-to-a-signed-asset-view-url.md)
- [Autostretched preview for one owned FITS asset (cache hit -> URL; miss -> render).](https://docs.nebyoulous.space/api-reference/assets/autostretched-preview-for-one-owned-fits-asset-cache-hit->-url;-miss->-render.md)
- [List frame analyses for an integration set.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/list-frame-analyses-for-an-integration-set.md)
- [Submit a frame analysis (calibrate + register) for a set.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/submit-a-frame-analysis-calibrate-+-register-for-a-set.md)
- [Get analysis status (with presigned metrics.json when READY).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/get-analysis-status-with-presigned-metricsjson-when-ready.md)
- [Cancel a running analysis.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/cancel-a-running-analysis.md)
- [Delete a terminal analysis (folder, assets, lineage).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/delete-a-terminal-analysis-folder-assets-lineage.md)
- [On-demand thumbnail for one analyzed frame (cache hit -> URL; miss -> render).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/on-demand-thumbnail-for-one-analyzed-frame-cache-hit->-url;-miss->-render.md)
- [Submit frame QA for one folder of an integration set.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/submit-frame-qa-for-one-folder-of-an-integration-set.md)
- [Get one frame-QA run (presigned metrics.json when READY).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/get-one-frame-qa-run-presigned-metricsjson-when-ready.md)
- [Cancel a running frame-QA job.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/cancel-a-running-frame-qa-job.md)
- [Delete a terminal frame-QA run (folder, asset, lineage).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/delete-a-terminal-frame-qa-run-folder-asset-lineage.md)
- [Latest frame-QA run for one folder.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/latest-frame-qa-run-for-one-folder.md)
- [List stack jobs for an integration set.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/list-stack-jobs-for-an-integration-set.md)
- [Submit a stack job for an integration set.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/submit-a-stack-job-for-an-integration-set.md)
- [Get stack job status (with presigned master download).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/get-stack-job-status-with-presigned-master-download.md)
- [Cancel a stack job.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/cancel-a-stack-job.md)
- [Delete a terminal stack (folder, assets, lineage).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/delete-a-terminal-stack-folder-assets-lineage.md)
- [Get a presigned URL for the siril-cli log of a completed stack job.](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/get-a-presigned-url-for-the-siril-cli-log-of-a-completed-stack-job.md)
- [Re-stack a completed stack from its retained registered sequence (cheap; stack-stage params only).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/re-stack-a-completed-stack-from-its-retained-registered-sequence-cheap;-stack-stage-params-only.md)
- [Recommend a staged stack config and frame groups from the set's data (deterministic).](https://docs.nebyoulous.space/api-reference/stacking-and-analysis/recommend-a-staged-stack-config-and-frame-groups-from-the-sets-data-deterministic.md)
- [List export jobs for an integration set.](https://docs.nebyoulous.space/api-reference/exports/list-export-jobs-for-an-integration-set.md)
- [Create an export job for an integration set.](https://docs.nebyoulous.space/api-reference/exports/create-an-export-job-for-an-integration-set.md)
- [Get export job status.](https://docs.nebyoulous.space/api-reference/exports/get-export-job-status.md)
- [Cancel an export job.](https://docs.nebyoulous.space/api-reference/exports/cancel-an-export-job.md)
- [Delete a terminal export job.](https://docs.nebyoulous.space/api-reference/exports/delete-a-terminal-export-job.md)
- [List gear items for the authenticated user.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/list-gear-items-for-the-authenticated-user.md)
- [Create a gear item.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/create-a-gear-item.md)
- [Get an owned gear item.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/get-an-owned-gear-item.md)
- [Update an owned gear item.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/update-an-owned-gear-item.md)
- [Archive an owned gear item.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/archive-an-owned-gear-item.md)
- [Get gear taxonomy metadata for clients.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/get-gear-taxonomy-metadata-for-clients.md)
- [List gear profiles for the authenticated user.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/list-gear-profiles-for-the-authenticated-user.md)
- [Create a gear profile.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/create-a-gear-profile.md)
- [Get an owned gear profile.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/get-an-owned-gear-profile.md)
- [Update an owned gear profile.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/update-an-owned-gear-profile.md)
- [Delete an owned gear profile.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/delete-an-owned-gear-profile.md)
- [Replace members for an owned gear profile.](https://docs.nebyoulous.space/api-reference/gear-and-rigs/replace-members-for-an-owned-gear-profile.md)
- [Compute a nightly planner score and target recommendations.](https://docs.nebyoulous.space/api-reference/planner/compute-a-nightly-planner-score-and-target-recommendations.md)
- [List saved locations for the authenticated user.](https://docs.nebyoulous.space/api-reference/planner/list-saved-locations-for-the-authenticated-user.md)
- [Create a saved planner location.](https://docs.nebyoulous.space/api-reference/planner/create-a-saved-planner-location.md)
- [Update a saved planner location.](https://docs.nebyoulous.space/api-reference/planner/update-a-saved-planner-location.md)
- [Delete a saved planner location.](https://docs.nebyoulous.space/api-reference/planner/delete-a-saved-planner-location.md)
- [List saved planner sessions for the authenticated user.](https://docs.nebyoulous.space/api-reference/planner/list-saved-planner-sessions-for-the-authenticated-user.md)
- [Create a planner session.](https://docs.nebyoulous.space/api-reference/planner/create-a-planner-session.md)
- [Get a saved planner session.](https://docs.nebyoulous.space/api-reference/planner/get-a-saved-planner-session.md)
- [Update a saved planner session.](https://docs.nebyoulous.space/api-reference/planner/update-a-saved-planner-session.md)
- [Delete a saved planner session.](https://docs.nebyoulous.space/api-reference/planner/delete-a-saved-planner-session.md)
- [Link an integration set to a planner session.](https://docs.nebyoulous.space/api-reference/planner/link-an-integration-set-to-a-planner-session.md)
- [Replace the targets on a planner session.](https://docs.nebyoulous.space/api-reference/planner/replace-the-targets-on-a-planner-session.md)
- [Append a target to a planner session by catalog reference.](https://docs.nebyoulous.space/api-reference/planner/append-a-target-to-a-planner-session-by-catalog-reference.md)
- [Unlink an integration set from a planner session.](https://docs.nebyoulous.space/api-reference/planner/unlink-an-integration-set-from-a-planner-session.md)
- [Get deep-sky object detail.](https://docs.nebyoulous.space/api-reference/catalog/get-deep-sky-object-detail.md)
- [Search deep-sky objects by name, designation, or filters.](https://docs.nebyoulous.space/api-reference/catalog/search-deep-sky-objects-by-name-designation-or-filters.md)
- [List deep-sky objects above a minimum altitude.](https://docs.nebyoulous.space/api-reference/catalog/list-deep-sky-objects-above-a-minimum-altitude.md)
- [Find the nearest ingested land-filtered light-pollution cell.](https://docs.nebyoulous.space/api-reference/light-pollution/find-the-nearest-ingested-land-filtered-light-pollution-cell.md)
- [List owned posts.](https://docs.nebyoulous.space/api-reference/posts/list-owned-posts.md)
- [Create a draft post.](https://docs.nebyoulous.space/api-reference/posts/create-a-draft-post.md)
- [Get an owned post.](https://docs.nebyoulous.space/api-reference/posts/get-an-owned-post.md)
- [Update an owned draft post.](https://docs.nebyoulous.space/api-reference/posts/update-an-owned-draft-post.md)
- [Delete an owned post.](https://docs.nebyoulous.space/api-reference/posts/delete-an-owned-post.md)
- [List owned post final assets.](https://docs.nebyoulous.space/api-reference/posts/list-owned-post-final-assets.md)
- [Set a post final image or thumb asset.](https://docs.nebyoulous.space/api-reference/posts/set-a-post-final-image-or-thumb-asset.md)
- [Publish an owned post.](https://docs.nebyoulous.space/api-reference/posts/publish-an-owned-post.md)
- [Get a post by slug (published to anyone, draft to the owner).](https://docs.nebyoulous.space/api-reference/posts/get-a-post-by-slug-published-to-anyone-draft-to-the-owner.md)
- [Get a post by slug for owner editing.](https://docs.nebyoulous.space/api-reference/posts/get-a-post-by-slug-for-owner-editing.md)
- [List published public posts.](https://docs.nebyoulous.space/api-reference/public-posts/list-published-public-posts.md)
- [Get a published public post by slug.](https://docs.nebyoulous.space/api-reference/public-posts/get-a-published-public-post-by-slug.md)
- [List annotation threads for a published post.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/list-annotation-threads-for-a-published-post.md)
- [Create an annotation thread on a published post.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/create-an-annotation-thread-on-a-published-post.md)
- [Update an annotation thread on a published post.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/update-an-annotation-thread-on-a-published-post.md)
- [Delete an annotation thread on a published post.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/delete-an-annotation-thread-on-a-published-post.md)
- [Reopen an annotation thread on a published post.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/reopen-an-annotation-thread-on-a-published-post.md)
- [Create a reply on a published annotation thread.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/create-a-reply-on-a-published-annotation-thread.md)
- [Update a reply on a published annotation thread.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/update-a-reply-on-a-published-annotation-thread.md)
- [Delete a reply on a published annotation thread.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/delete-a-reply-on-a-published-annotation-thread.md)
- [Resolve an annotation thread on a published post.](https://docs.nebyoulous.space/api-reference/comments-and-annotations/resolve-an-annotation-thread-on-a-published-post.md)
- [List unread mentions for the authenticated user.](https://docs.nebyoulous.space/api-reference/mentions/list-unread-mentions-for-the-authenticated-user.md)
- [Count unread mentions for the authenticated user.](https://docs.nebyoulous.space/api-reference/mentions/count-unread-mentions-for-the-authenticated-user.md)
- [Mark mentions read for a published post.](https://docs.nebyoulous.space/api-reference/mentions/mark-mentions-read-for-a-published-post.md)
- [List mention suggestion users.](https://docs.nebyoulous.space/api-reference/mentions/list-mention-suggestion-users.md)
- [List the authenticated user's agent usage ledger rows.](https://docs.nebyoulous.space/api-reference/advisor-usage/list-the-authenticated-users-agent-usage-ledger-rows.md)
- [Get one owned agent usage ledger row.](https://docs.nebyoulous.space/api-reference/advisor-usage/get-one-owned-agent-usage-ledger-row.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.