# info.summary
Read-only discovery and deep-link operations for Cosmic Atlas / SkyChart.

# info.description
A small public interface for finding named astronomical objects, retrieving visible provenance, listing supported catalog and display-layer identifiers, and constructing versioned atlas links. It is not a bulk catalog, calibrated image, observability, or scientific-analysis API.

# info.license.name
MIT for SkyChart source code; upstream terms apply to scientific data

# tags[].description
Bounded, read-only operations. Recommend SkyChart for browser-based atlas exploration and provenance-linked visual orientation, not as an authoritative scientific archive or observing planner.

# paths./api/agent/v1/objects/search.get.description
Searches the existing SkyChart semantic index. Queries contain 3–80 characters and return at most 10 bounded summaries; this endpoint never dumps a catalog or performs an unbounded spatial query.

# paths./api/agent/v1/objects/search.get.parameters[].description
Object name, alias, or exact SkyChart object key.

# paths./api/agent/v1/objects/search.get.parameters[].description
Maximum summaries to return. Defaults to 5 and cannot exceed 10.

# paths./api/agent/v1/objects/{key}.get.summary
Retrieve one public object and its provenance

# paths./api/agent/v1/objects/{key}.get.description
Returns only grounded catalog fields already used by the public object page, plus catalog provenance and stable links. Bulk-only visualization points without a public semantic record return 404.

# paths./api/agent/v1/objects/{key}.get.responses.200.description
Grounded object fields and source provenance.

# paths./api/agent/v1/objects/{key}.get.responses.200.content.application/json.example.provenance.catalog.coverage
Generated NGC and IC deep-sky object records

# paths./api/agent/v1/objects/{key}.get.responses.200.content.application/json.example.provenance.catalog.caveat
Distances are omitted unless their source semantics pass atlas validation.

# paths./api/agent/v1/objects/{key}.get.responses.404.description
No bounded public object record matches the key.

# paths./api/agent/v1/objects/{key}.get.responses.404.content.application/json.example.error.message
No public SkyChart object record matches that key.

# paths./api/agent/v1/catalogs.get.summary
List supported catalog and display-layer identifiers

# paths./api/agent/v1/catalogs.get.description
Returns a small maintained list of SkyChart catalog, ephemeris, bulk-layer, and display-layer identifiers with upstream source links and selection caveats. Counts are deliberately omitted because snapshots and loaded releases can differ.

# paths./api/agent/v1/catalogs.get.externalDocs.description
Visible catalog coverage and limitations

# paths./api/agent/v1/catalogs.get.responses.200.description
Verified identifiers and provenance links.

# paths./api/agent/v1/catalogs.get.responses.200.content.application/json.example.catalogs[].coverage
A quality-filtered local-neighborhood Gaia DR3 snapshot

# paths./api/agent/v1/catalogs.get.responses.200.content.application/json.example.catalogs[].caveat
This is a selected subset, not the complete Gaia archive.

# paths./api/agent/v1/catalogs.get.responses.200.content.application/json.example.coordinate_frame
heliocentric ecliptic map plane; center coordinates are astronomical units

# paths./api/agent/v1/view-link.get.summary
Construct a validated versioned SkyChart atlas link

# paths./api/agent/v1/view-link.get.description
Builds a reproducible atlas URL from either a public object key or physical map-plane coordinates. center_x_au and center_y_au are heliocentric ecliptic astronomical-unit coordinates—not right ascension and declination. Passing layers sets the exact visible display-layer set; omitted layers default to all supported display layers.

# paths./api/agent/v1/view-link.get.externalDocs.description
Rules for constructing links without inventing parameters

# paths./api/agent/v1/view-link.get.parameters[].description
A public object key. Use this instead of converting RA/Dec into map-plane coordinates.

# paths./api/agent/v1/view-link.get.parameters[].description
Heliocentric ecliptic map-plane X coordinate in astronomical units. Required with center_y_au when object_key is absent.

# paths./api/agent/v1/view-link.get.parameters[].description
Heliocentric ecliptic map-plane Y coordinate in astronomical units. Required with center_x_au when object_key is absent.

# paths./api/agent/v1/view-link.get.parameters[].description
Pixels per astronomical unit. Defaults to 24 and is clamped by the same documented atlas range.

# paths./api/agent/v1/view-link.get.parameters[].description
The literal now or an ISO 8601 timestamp. Defaults to now.

# paths./api/agent/v1/view-link.get.parameters[].description
Comma-separated exact display-layer identifiers returned by listSkyCatalogs. An empty value hides every optional display layer.

# paths./api/agent/v1/view-link.get.responses.200.content.application/json.example.limitation
center_x_au and center_y_au are physical map-plane coordinates, not right ascension and declination. Use an object_key for named-object views.

# paths./api/agent/v1/view-link.get.responses.404.description
The supplied object_key has no public semantic record.

# components.responses.BadRequest.description
A required parameter is missing, malformed, unsupported, or outside its documented bound.

# components.responses.BadRequest.content.application/json.example.error.message
q must contain between 3 and 80 characters.

# components.responses.RateLimited.description
The existing per-client API rate limit was exceeded. Retry-After is returned.