Download OpenAPI specification:Download
SkyPortal provides an API to access most of its underlying
functionality. To use it, you will need an API token. This
can be generated via the web application from your profile page or, if
you are an admin, you may use the system provisioned token stored
inside of .tokens.yaml
.
Once you have a token, you may access SkyPortal programmatically as follows.
import requests
token = 'ea70a5f0-b321-43c6-96a1-b2de225e0339'
def api(method, endpoint, data=None):
headers = {'Authorization': f'token {token}'}
response = requests.request(method, endpoint, json=data, headers=headers)
return response
response = api('GET', 'http://localhost:5000/api/sysinfo')
print(f'HTTP code: {response.status_code}, {response.reason}')
if response.status_code in (200, 400):
print(f'JSON response: {response.json()}')
curl -s -H 'Authorization: token ea70a5f0-b321-43c6-96a1-b2de225e0339' http://localhost:5000/api/sysinfo
There are two ways to pass information along with a request: path and body parameters.
Path parameters (also called query or URL parameters) are embedded in
the URL called. For example, you can specify numPerPage
or
pageNumber
path parameters when calling /api/candidates
as
follows:
curl -s -H 'Authorization: token ea70a5f0-b321-43c6-96a1-b2de225e0339' \
http://localhost:5000/api/candidates?numPerPage=100&pageNumber=1
When using Python's requests
library, a dictionary of path
parameters can be passed in via the params
keyword argument:
token = 'ea70a5f0-b321-43c6-96a1-b2de225e0339'
response = requests.get(
"http://localhost:5000/api/sources",
params={"includeComments": True, "includeThumbnails": False},
headers={'Authorization': f'token {token}'},
)
Request body parameters (or simply: the body of the request)
contains data uploaded to a specific endpoint. These are the
parameters listed under REQUEST BODY SCHEMA: application/json
in the
API docs.
When using Python's requests
library, body parameters are specified
using the json
keyword argument:
token = "abc"
response = requests.post(
"http://localhost:5000/api/sources",
json={
"id": "14gqr",
"ra": 353.36647,
"dec": 33.646149,
"group_ids": [52, 97],
},
headers={"Authorization": f"token {token}"},
)
In the above examples, the SkyPortal server is located at
http://localhost:5000
. In case of success, the HTTP response is 200:
HTTP code: 200, OK
JSON response: {'status': 'success', 'data': {}, 'version': '0.9.dev0+git20200819.84c453a'}
On failure, it is 400; the JSON response has status="error"
with the reason
for the failure given in message
:
{
"status": "error",
"message": "Invalid API endpoint",
"data": {},
"version": "0.9.1"
}
Several API endpoints (notably the sources and candidates APIs) enforce pagination to limit the number of records that can be fetched per request. These APIs expose parameters that facilitate pagination (see the various API docs for details). A sample pagination script is included here:
import requests
import time
base_url = "https://fritz.science/api/sources"
token = "your_token_id_here"
group_ids = [4, 71] # If applicable
all_sources = []
num_per_page = 500
page = 1
total_matches = None
retry_attempts = 0
max_retry_attempts = 10
while retry_attempts <= max_retry_attempts:
r = requests.get(
f"{base_url}?group_ids={','.join([str(gid) for gid in group_ids])}&pageNumber={page}&numPerPage={num_per_page}&totalMatches={total_matches}",
headers={"Authorization": f"token {token}"},
)
if r.status_code == 429:
print("Request rate limit exceeded; sleeping 1s before trying again...")
time.sleep(1)
continue
data = r.json()
if data["status"] != "success":
print(data) # log as appropriate
retry_attempts += 1
time.sleep(5)
continue
else:
retry_attempts = 0
all_sources.extend(data["data"]["sources"])
total_matches = data["data"]["totalMatches"]
print(f"Fetched {len(all_sources)} of {total_matches} sources.")
if len(all_sources) >= total_matches:
break
page += 1
Produce a report on allocations for an instrument
instrument_id required | integer |
output_format | string Output format for analysis. Can be png or pdf |
{- "status": "success",
- "message": "string"
}
Retrieve an allocation
allocation_id required | integer |
{- "status": "success",
- "data": {
- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2023-07-10T21:32:34Z",
- "end_date": "2023-07-10T21:32:34Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string",
- "id": 0
}, - "message": "string"
}
Update an allocation on a robotic instrument
allocation_id required | integer |
requests | Array of any |
default_requests | Array of any |
default_observation_plans | Array of any |
catalog_queries | Array of any |
observation_plans | Array of any |
group | any Nullable The Group the allocation is associated with. |
instrument | any Nullable The Instrument the allocation is associated with. |
allocation_users | Array of any |
gcn_triggers | Array of any |
pi | string Nullable The PI of the allocation's proposal. |
proposal_id | string Nullable The ID of the proposal associated with this allocation. |
start_date | string <date-time> Nullable The UTC start date of the allocation. |
end_date | string <date-time> Nullable The UTC end date of the allocation. |
hours_allocated required | number The number of hours allocated. |
default_share_group_ids | any Nullable |
group_id required | integer The ID of the Group the allocation is associated with. |
instrument_id required | integer The ID of the Instrument the allocation is associated with. |
_altdata | string Nullable |
{- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2023-07-10T21:32:34Z",
- "end_date": "2023-07-10T21:32:34Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string"
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all allocations
instrument_id | number Instrument ID to retrieve allocations for |
{- "status": "success",
- "data": [
- {
- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2023-07-10T21:32:34Z",
- "end_date": "2023-07-10T21:32:34Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string",
- "id": 0
}
], - "message": "string"
}
Post new allocation on a robotic instrument
requests | Array of any |
default_requests | Array of any |
default_observation_plans | Array of any |
catalog_queries | Array of any |
observation_plans | Array of any |
group | any Nullable The Group the allocation is associated with. |
instrument | any Nullable The Instrument the allocation is associated with. |
allocation_users | Array of any |
gcn_triggers | Array of any |
pi | string Nullable The PI of the allocation's proposal. |
proposal_id | string Nullable The ID of the proposal associated with this allocation. |
start_date | string <date-time> Nullable The UTC start date of the allocation. |
end_date | string <date-time> Nullable The UTC end date of the allocation. |
hours_allocated required | number The number of hours allocated. |
default_share_group_ids | any Nullable |
group_id required | integer The ID of the Group the allocation is associated with. |
instrument_id required | integer The ID of the Instrument the allocation is associated with. |
_altdata | string Nullable |
{- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2023-07-10T21:32:34Z",
- "end_date": "2023-07-10T21:32:34Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve all observation analyses
gcnevent_id | number GcnEvent ID to retrieve observation efficiency analyses for |
{- "status": "success",
- "data": [
- {
- "gcnevent": null,
- "localization": null,
- "instrument": null,
- "requester": null,
- "groups": [
- null
], - "gcnevent_id": 0,
- "localization_id": 0,
- "instrument_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
], - "message": "string"
}
Retrieve all observation plan efficiency analyses
observation_plan_id | number EventObservationPlan ID to retrieve observation plan efficiency analyses for |
{- "status": "success",
- "data": [
- {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
], - "message": "string"
}
Retrieve a default analysis
analysis_service_id required | any Analysis service ID |
default_analysis_id required | any Default analysis ID |
{- "status": "success",
- "data": {
- "analysis_service": null,
- "groups": [
- null
], - "author": null,
- "analysis_service_id": 0,
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "default_analysis_parameters": "string",
- "source_filter": null,
- "stats": null,
- "author_id": 0,
- "id": 0
}, - "message": "string"
}
Delete a default analysis
analysis_service_id required | integer Analysis service ID |
default_analysis_id required | integer Default analysis ID |
{- "status": "success",
- "message": "string"
}
Retrieve all default analyses
analysis_service_id required | any Analysis service ID, if not provided, return all default analyses for all analysis services |
{- "status": "success",
- "data": [
- {
- "analysis_service": null,
- "groups": [
- null
], - "author": null,
- "analysis_service_id": 0,
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "default_analysis_parameters": "string",
- "source_filter": null,
- "stats": null,
- "author_id": 0,
- "id": 0
}
], - "message": "string"
}
Get Swift LSXPS objects and post them as sources. Repeated posting will skip the existing source.
telescope_name | integer Name of telescope to assign this catalog to. Use the same name as your nickname for the Neil Gehrels Swift Observatory. Defaults to Swift. |
groupIDs | object If provided, save to these group IDs. |
{- "telescope_name": 0,
- "groupIDs": { }
}
{- "status": "success",
- "message": "string"
}
Get Gaia Photometric Alert objects and post them as sources. Repeated posting will skip the existing source.
telescope_name | string Name of telescope to assign this catalog to. Use the same name as your nickname for Gaia. Defaults to Gaia. |
groupIDs | object If provided, save to these group IDs. |
startDate | str Arrow parsable string. Filter by start date. |
endDate | str Arrow parsable string. Filter by end date. |
{- "telescope_name": "string",
- "groupIDs": { },
- "startDate": null,
- "endDate": null
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "sent_by": null,
- "notices": [
- null
], - "predictions": [
- null
], - "measurements": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "sent_by_id": 0,
- "event_id": "string",
- "event_uri": "string",
- "status": "string",
- "id": 0
}
], - "message": "string"
}
get Gaia parallax and magnitudes and post them as an annotation, based on cross-match to the Gaia DR3.
obj_id required | string ID of the object to retrieve Gaia colors for |
catalog | string The name of the catalog key, associated with a catalog cross match, from which the data should be retrieved. Default is "gaiadr3.gaia_source". |
crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve Gaia sources If not specified (or None) will use the default from the config file, or 2 arcsec if not specified in the config. |
crossmatchLimmag | number Crossmatch limiting magnitude (for Gaia G mag). Will ignore sources fainter than this magnitude. If not specified, will use the default value in the config file, or None if not specified in the config. If value is cast to False (0, False or None), will take sources of any magnitude. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "crossmatchLimmag": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
get WISE colors and post them as an annotation based on cross-matches to some catalog (default is allwise_p3as_psd).
obj_id required | string ID of the object to retrieve WISE colors for |
catalog | string The name of the catalog key, associated with a catalog cross match, from which the data should be retrieved. Default is allwise_p3as_psd. |
crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve photoz's Default is 2. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
get cross-match with Vizier and post them as an annotation based on cross-matches to some catalog (default is VII/290, i.e. the million quasar catalog).
obj_id required | string ID of the object to retrieve the Vizier crossmatch for |
catalog | string The name of the catalog key, associated with a catalog cross match, from which the data should be retrieved. Default is VII/290. |
crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve photoz's Default is 2. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Generate a PDF/PNG finding chart for a position or Gaia ID
location_type required | string Enum: "gaia_dr3" "gaia_dr2" "pos" What is the type of the search? From gaia or by position? If |
catalog_id | string |
ra | float [ 0 .. 360 ) RA of the source of interest at the time of observation of interest (ie. the user is responsible for proper motion calulations). |
dec | float [ -90 .. 90 ] DEC of the source of interest at the time of observation of interest (ie. the user is responsible for proper motion calulations). |
imsize | float [ 2 .. 15 ] Image size in arcmin (square). Defaults to 4.0 |
facility | string Enum: "Keck" "Shane" "P200" What type of starlist should be used? Defaults to Keck |
image_source | string Enum: "ps1" "desi" "dss" "ztfref" Source of the image used in the finding chart. Defaults to ps1 |
use_ztfref | boolean Use ZTFref catalog for offset star positions, otherwise DR3. Defaults to True. |
obstime | string datetime of observation in isoformat (e.g. 2020-12-30T12:34:10). Defaults to now. |
type | string Enum: "png" "pdf" Output datafile type. Defaults to pdf. |
num_offset_stars | integer [ 0 .. 4 ] Number of offset stars to determine and show [0,4] (default: 3) |
A PDF/PNG finding chart file
{- "status": "error",
- "data": { },
- "message": "string"
}
Retrieve an Analysis Service by id
analysis_service_id required | integer |
{- "status": "success",
- "data": {
- "groups": [
- null
], - "obj_analyses": [
- null
], - "default_analyses": [
- null
], - "name": "string",
- "display_name": "string",
- "description": "string",
- "version": "string",
- "contact_name": "string",
- "contact_email": "string",
- "url": "string",
- "optional_analysis_parameters": "string",
- "authentication_type": "none",
- "_authinfo": "string",
- "enabled": true,
- "analysis_type": "lightcurve_fitting",
- "input_data_types": [
- null
], - "timeout": 0,
- "upload_only": true,
- "display_on_resource_dropdown": true,
- "is_summary": true,
- "id": 0
}, - "message": "string"
}
Delete an Analysis Service.
analysis_service_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "groups": [
- null
], - "obj_analyses": [
- null
], - "default_analyses": [
- null
], - "name": "string",
- "display_name": "string",
- "description": "string",
- "version": "string",
- "contact_name": "string",
- "contact_email": "string",
- "url": "string",
- "optional_analysis_parameters": "string",
- "authentication_type": "none",
- "_authinfo": "string",
- "enabled": true,
- "analysis_type": "lightcurve_fitting",
- "input_data_types": [
- null
], - "timeout": 0,
- "upload_only": true,
- "display_on_resource_dropdown": true,
- "is_summary": true,
- "id": 0
}
], - "message": "string"
}
Upload an upload_only analysis result
analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
resource_id required | string The ID of the underlying data. This would be a string for an object ID. |
analysis_service_id required | string the analysis service id to be used |
results | object Results data of this analysis |
show_parameters | boolean Whether to render the parameters of this analysis |
show_plots | boolean Whether to render the plots of this analysis |
show_corner | boolean Whether to render the corner plots of this analysis |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view analysis results. Defaults to all of requesting user's groups. |
{- "results": { },
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "analysis_id": 0
}
}
Retrieve an Analysis by id
analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
analysis_id required | int ID of the analysis to return. |
objID | string Return any analysis on an object with ID objID |
analysisServiceID | int ID of the analysis service used to create the analysis, used only if no analysis_id is given |
includeAnalysisData | boolean Boolean indicating whether to include the data associated with the analysis in the response. Could be a large amount of data. Only works for single analysis requests. Defaults to false. |
summaryOnly | boolean Boolean indicating whether to return only analyses that
use analysis services with |
includeFilename | boolean Boolean indicating whether to include the filename of the data associated with the analysis in the response. Defaults to false. |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2023-07-10T21:32:34Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2023-07-10T21:32:34Z",
- "status_message": "string"
}, - "message": "string"
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2023-07-10T21:32:34Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2023-07-10T21:32:34Z",
- "status_message": "string"
}
], - "message": "string"
}
Begin an analysis run
analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
resource_id required | string The ID of the underlying data. This would be a string for an object ID. |
analysis_service_id required | string the analysis service id to be used |
show_parameters | boolean Whether to render the parameters of this analysis |
show_plots | boolean Whether to render the plots of this analysis |
show_corner | boolean Whether to render the corner plots of this analysis |
analysis_parameters | object Dictionary of parameters to be passed thru to the analysis |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view analysis results. Defaults to all of requesting user's groups. |
{- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": {
- "property1": "string",
- "property2": "string"
}, - "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "analysis_id": 0
}
}
Retrieve an Analysis by id
analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
analysis_id required | int ID of the analysis to return. |
objID | string Return any analysis on an object with ID objID |
analysisServiceID | int ID of the analysis service used to create the analysis, used only if no analysis_id is given |
includeAnalysisData | boolean Boolean indicating whether to include the data associated with the analysis in the response. Could be a large amount of data. Only works for single analysis requests. Defaults to false. |
summaryOnly | boolean Boolean indicating whether to return only analyses that
use analysis services with |
includeFilename | boolean Boolean indicating whether to include the filename of the data associated with the analysis in the response. Defaults to false. |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2023-07-10T21:32:34Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2023-07-10T21:32:34Z",
- "status_message": "string"
}, - "message": "string"
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2023-07-10T21:32:34Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2023-07-10T21:32:34Z",
- "status_message": "string"
}
], - "message": "string"
}
Begin an analysis run
analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
resource_id required | string The ID of the underlying data. This would be a string for an object ID. |
analysis_service_id required | string the analysis service id to be used |
show_parameters | boolean Whether to render the parameters of this analysis |
show_plots | boolean Whether to render the plots of this analysis |
show_corner | boolean Whether to render the corner plots of this analysis |
analysis_parameters | object Dictionary of parameters to be passed thru to the analysis |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view analysis results. Defaults to all of requesting user's groups. |
{- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": {
- "property1": "string",
- "property2": "string"
}, - "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "analysis_id": 0
}
}
Retrieve primary data associated with an Analysis.
analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
analysis_id required | integer |
product_type required | string What type of data to retrieve: must be one of "corner", "results", or "plot" |
plot_number required | integer if product_type == "plot", which plot number should be returned? Default to zero (first plot). |
download | bool Download the results as a file |
plot_kwargs | object Extra parameters to pass to the plotting functions if new plots are to be generated (e.g. with corner plots) |
Requested analysis file
{- "download": null,
- "plot_kwargs": {
- "property1": { },
- "property2": { }
}
}
{ }
Retrieve an observing run assignment
assignment_id required | integer |
{- "status": "success",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "obj": null,
- "spectra": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "run": null,
- "requester_id": 0,
- "last_modified_by_id": 0,
- "obj_id": "string",
- "comment": "string",
- "status": "string",
- "priority": "1",
- "run_id": 0,
- "id": 0
}, - "message": "string"
}
Update an assignment
assignment_id required | integer |
requester | any Nullable The User who created this assignment. |
last_modified_by | any Nullable |
obj | any Nullable The assigned Obj. |
spectra | Array of any |
photometry | Array of any |
photometric_series | Array of any |
run | any Nullable The ObservingRun this target was assigned to. |
requester_id required | integer The ID of the User who created this assignment. |
obj_id required | string ID of the assigned Obj. |
comment | string Nullable A comment on the assignment. Typically a justification for the request, or instructions for taking the data. |
status | string Status of the assignment [done, not done, pending]. |
priority required | string <= 1 characters Enum: "1" "2" "3" "4" "5" Priority of the request (1 = lowest, 5 = highest). |
run_id required | integer ID of the ObservingRun this target was assigned to. |
{- "requester": null,
- "last_modified_by": null,
- "obj": null,
- "spectra": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "run": null,
- "requester_id": 0,
- "obj_id": "string",
- "comment": "string",
- "status": "string",
- "priority": "1",
- "run_id": 0
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "requester": null,
- "last_modified_by": null,
- "obj": null,
- "spectra": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "run": null,
- "requester_id": 0,
- "last_modified_by_id": 0,
- "obj_id": "string",
- "comment": "string",
- "status": "string",
- "priority": "1",
- "run_id": 0,
- "id": 0
}
], - "message": "string"
}
Post new target assignment to observing run
comment | string An optional comment describing the request. |
obj_id required | string The ID of the object to observe. |
run_id required | integer |
status | string The status of the request |
priority required | any Enum: "1" "2" "3" "4" "5" Priority of the request, (lowest = 1, highest = 5). |
{- "comment": "string",
- "obj_id": "string",
- "run_id": 0,
- "status": "string",
- "priority": "1"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a candidate
obj_id required | string |
includeComments | boolean Boolean indicating whether to include associated comments. Defaults to false. |
includeAlerts | boolean Boolean indicating whether to include associated alerts. Defaults to false. |
{- "status": "success",
- "data": {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}, - "message": "string"
}
Check if a Candidate exists
obj_id required | string |
{- "status": "success",
- "message": "string"
}
Delete candidate(s)
obj_id required | string |
filter_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve all candidates
numPerPage | integer Number of candidates to return per paginated request. Defaults to 25. Capped at 500. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
totalMatches | integer Used only in the case of paginating query results - if provided, this allows for avoiding a potentially expensive query.count() call. |
autosave | boolean Automatically save candidates passing query. |
autosaveGroupIds | boolean Group ID(s) to save candidates to. |
savedStatus | string Enum: "all" "savedToAllSelected" "savedToAnySelected" "savedToAnyAccessible" "notSavedToAnyAccessible" "notSavedToAnySelected" "notSavedToAllSelected" String indicating the saved status to filter candidate results for. Must be one of the enumerated values. |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by Candidate.passed_at >= startDate |
endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by Candidate.passed_at <= endDate |
groupIDs | Array of integers Comma-separated string of group IDs (e.g. "1,2"). Defaults to all of user's groups if filterIDs is not provided. |
filterIDs | Array of integers Comma-separated string of filter IDs (e.g. "1,2"). Defaults to all of user's groups' filters if groupIDs is not provided. |
annotationExcludeOrigin | string Only load objects that do not have annotations from this origin. If the annotationsExcludeOutdatedDate is also given, then annotations with this origin will still be loaded if they were modified before that date. |
annotationExcludeOutdatedDate | string An Arrow parseable string designating when an existing annotation is outdated. Only relevant if giving the annotationExcludeOrigin argument. Will treat objects with outdated annotations as if they did not have that annotation, so it will load an object if it doesn't have an annotation with the origin specified or if it does have it but the annotation modified date < annotationsExcludeOutdatedDate |
sortByAnnotationOrigin | string The origin of the Annotation to sort by |
sortByAnnotationKey | string The key of the Annotation data value to sort by |
sortByAnnotationOrder | string The sort order for annotations - either "asc" or "desc". Defaults to "asc". |
annotationFilterList | Array of strings Comma-separated string of JSON objects representing annotation filters. Filter objects are expected to have keys { origin, key, value } for non-numeric value types, or { origin, key, min, max } for numeric values. |
includePhotometry | boolean Boolean indicating whether to include associated photometry. Defaults to false. |
includeSpectra | boolean Boolean indicating whether to include associated spectra. Defaults to false. |
includeComments | boolean Boolean indicating whether to include associated comments. Defaults to false. |
classifications | Array of strings Comma-separated string of classification(s) to filter for candidates matching that/those classification(s). |
minRedshift | number If provided, return only candidates with a redshift of at least this value |
maxRedshift | number If provided, return only candidates with a redshift of at most this value |
listName | string Get only candidates saved to the querying user's list, e.g., "favorites". |
listNameReject | string Get only candidates that ARE NOT saved to the querying user's list, e.g., "rejected_candidates". |
photometryAnnotationsFilter | Array of strings Comma-separated string of "annotation: value: operator" triplet(s) to filter for sources matching that/those photometry annotation(s), i.e. "drb: 0.5: lt" |
photometryAnnotationsFilterOrigin | string Comma separated string of origins. Only photometry annotations from these origins are used when filtering with the photometryAnnotationsFilter. |
photometryAnnotationsFilterBefore | string Only return sources that have photometry annotations before this UTC datetime. |
photometryAnnotationsFilterAfter | string Only return sources that have photometry annotations after this UTC datetime. |
photometryAnnotationsFilterMinCount | string Only return sources that have at least this number of photometry annotations passing the photometry annotations filtering criteria. Defaults to 1. |
localizationDateobs | string Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include sources |
{- "status": "success",
- "message": "string",
- "data": {
- "candidates": [
- {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "is_source": true
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Create new candidate(s) (one per filter).
host | any Nullable The Galaxy associated with this source. |
comments | Array of any |
reminders | Array of any |
comments_on_spectra | Array of any |
reminders_on_spectra | Array of any |
annotations | Array of any |
annotations_on_spectra | Array of any |
annotations_on_photometry | Array of any |
classifications | Array of any |
photometry | Array of any |
photstats | Array of any |
photometric_series | Array of any |
spectra | Array of any |
thumbnails | Array of any |
followup_requests | Array of any |
assignments | Array of any |
obj_notifications | Array of any |
obj_analyses | Array of any |
sources_in_gcns | Array of any |
id required | string Name of the object. |
ra_dis | number Nullable J2000 Right Ascension at discovery time [deg]. |
dec_dis | number Nullable J2000 Declination at discovery time [deg]. |
ra_err | number Nullable Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number Nullable Error on J2000 Declination at discovery time [deg]. |
offset | number Nullable Offset from nearest static object [arcsec]. |
redshift | number Nullable Redshift. |
redshift_error | number Nullable Redshift error. |
redshift_origin | string Nullable Redshift source. |
host_id | integer Nullable The ID of the Galaxy to which this Obj is associated. |
summary | string Nullable Summary of the obj. |
summary_history | any Nullable Record of the summaries generated and written about this obj |
altdata | any Nullable Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number Nullable Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number Nullable Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number Nullable Error on magnitude of the nearest Obj [mag]. |
transient | boolean Nullable Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean Nullable Boolean indicating whether the object is a variable star. |
is_roid | boolean Nullable Boolean indicating whether the object is a moving object. |
mpc_name | string Nullable Minor planet center name. |
gcn_crossmatch | any Nullable List of GCN event dateobs for crossmatched events. |
tns_name | string Nullable Transient Name Server name. |
tns_info | any Nullable TNS info in JSON format |
score | number Nullable Machine learning score. |
origin | string Nullable Origin of the object. |
alias | any Nullable Alternative names for this object. |
healpix | integer Nullable |
detect_photometry_count | integer Nullable How many times the object was detected above :math: |
ra | number Nullable |
dec | number Nullable |
candidates | Array of any |
sources | Array of any |
users | Array of any |
filter_ids required | Array of integers List of associated filter IDs |
passing_alert_id | integer Nullable ID of associated filter that created candidate |
passed_at required | string Nullable Arrow-parseable datetime string indicating when passed filter. |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "healpix": 0,
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "filter_ids": [
- 0
], - "passing_alert_id": 0,
- "passed_at": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "ids": [
- 0
]
}
}
Create new candidate(s) (one per filter).
host | any Nullable The Galaxy associated with this source. |
comments | Array of any |
reminders | Array of any |
comments_on_spectra | Array of any |
reminders_on_spectra | Array of any |
annotations | Array of any |
annotations_on_spectra | Array of any |
annotations_on_photometry | Array of any |
classifications | Array of any |
photometry | Array of any |
photstats | Array of any |
photometric_series | Array of any |
spectra | Array of any |
thumbnails | Array of any |
followup_requests | Array of any |
assignments | Array of any |
obj_notifications | Array of any |
obj_analyses | Array of any |
sources_in_gcns | Array of any |
id required | string Name of the object. |
ra_dis | number Nullable J2000 Right Ascension at discovery time [deg]. |
dec_dis | number Nullable J2000 Declination at discovery time [deg]. |
ra_err | number Nullable Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number Nullable Error on J2000 Declination at discovery time [deg]. |
offset | number Nullable Offset from nearest static object [arcsec]. |
redshift | number Nullable Redshift. |
redshift_error | number Nullable Redshift error. |
redshift_origin | string Nullable Redshift source. |
host_id | integer Nullable The ID of the Galaxy to which this Obj is associated. |
summary | string Nullable Summary of the obj. |
summary_history | any Nullable Record of the summaries generated and written about this obj |
altdata | any Nullable Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number Nullable Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number Nullable Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number Nullable Error on magnitude of the nearest Obj [mag]. |
transient | boolean Nullable Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean Nullable Boolean indicating whether the object is a variable star. |
is_roid | boolean Nullable Boolean indicating whether the object is a moving object. |
mpc_name | string Nullable Minor planet center name. |
gcn_crossmatch | any Nullable List of GCN event dateobs for crossmatched events. |
tns_name | string Nullable Transient Name Server name. |
tns_info | any Nullable TNS info in JSON format |
score | number Nullable Machine learning score. |
origin | string Nullable Origin of the object. |
alias | any Nullable Alternative names for this object. |
healpix | integer Nullable |
detect_photometry_count | integer Nullable How many times the object was detected above :math: |
ra | number Nullable |
dec | number Nullable |
candidates | Array of any |
sources | Array of any |
users | Array of any |
filter_ids required | Array of integers List of associated filter IDs |
passing_alert_id | integer Nullable ID of associated filter that created candidate |
passed_at required | string Nullable Arrow-parseable datetime string indicating when passed filter. |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "healpix": 0,
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "filter_ids": [
- 0
], - "passing_alert_id": 0,
- "passed_at": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "ids": [
- 0
]
}
}
Delete candidate(s)
obj_id required | string |
filter_id required | integer |
{- "status": "success",
- "message": "string"
}
Submit catalog queries
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Catalog query request allocation ID. |
payload | any Content of the catalog query request. |
target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
{- "status": "pending submission",
- "allocation_id": 0,
- "payload": null,
- "target_group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Vote for a classification.
classification_id required | string ID of classification to indicate the vote for |
vote required | integer Upvote or downvote a classification |
{- "vote": 0
}
{- "status": "success",
- "message": "string"
}
Delete classification vote.
classification_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve a classification
classification_id required | integer |
includeTaxonomy | boolean Return associated taxonomy. |
{- "status": "success",
- "data": {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}, - "message": "string"
}
Update a classification
classification required | integer |
taxonomy | any Nullable Taxonomy in which this Classification was made. |
author | any Nullable The User that made this classification. |
obj | any Nullable The Classification's Obj. |
groups | Array of any |
votes | Array of any |
classification required | string The assigned class. |
origin | string Nullable String describing the source of this classification. |
taxonomy_id required | integer ID of the Taxonomy in which this Classification was made. |
probability | number Nullable User-assigned probability of belonging to this class |
author_id required | integer ID of the User that made this Classification |
author_name required | string User.username or Token.id of the Classification's author. |
obj_id required | string ID of the Classification's Obj. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view classification. |
{- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Delete a classification
classification_id required | integer |
label | boolean Nullable Add label associated with classification. |
{- "label": true
}
{- "status": "success",
- "message": "string"
}
Retrieve all classifications
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at >= startDate |
endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at <= endDate |
includeTaxonomy | boolean Return associated taxonomy. |
numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "sources": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
], - "totalMatches": 0
}
}
Post a classification
obj_id required | string |
classification required | string |
origin | string String describing the source of this classification. |
taxonomy_id required | integer |
probability | float [ 0 .. 1 ] Nullable User-assigned probability of this classification on this taxonomy. If multiple classifications are given for the same source by the same user, the sum of the classifications ought to equal unity. Only individual probabilities are checked. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view classification. Defaults to all of requesting user's groups. |
vote | boolean Nullable Add vote associated with classification. |
label | boolean Nullable Add label associated with classification. |
{- "obj_id": "string",
- "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": null,
- "group_ids": [
- 0
], - "vote": true,
- "label": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "classification_id": 0
}
}
Retrieve an object's classifications
obj_id required | string |
{- "status": "success",
- "data": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
], - "message": "string"
}
Delete all of an object's classifications
classification_id required | integer |
label | boolean Nullable Add label associated with classification. |
{- "label": true
}
{- "status": "success",
- "message": "string"
}
Vote for a classification.
classification_id required | string ID of classification to indicate the vote for |
vote required | integer Upvote or downvote a classification |
{- "vote": 0
}
{- "status": "success",
- "message": "string"
}
Delete classification vote.
classification_id required | string |
{- "status": "success",
- "message": "string"
}
find the sources with classifications
startDate | string Arrow-parseable date string (e.g. 2020-01-01) for when the classification was made. If provided, filter by created_at >= startDate |
endDate | string Arrow-parseable date string (e.g. 2020-01-01) for when the classification was made. If provided, filter by created_at <= endDate |
{- "status": "success",
- "message": "string",
- "data": [
- 0
]
}
find the number of sources with and without a Healpix value
{- "status": "success",
- "message": "string",
- "data": {
- "totalWithoutHealpix": 0,
- "totalWithHealpix": 0
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "ALLOWED_SPECTRUM_TYPES": [ ],
- "ALLOWED_MAGSYSTEMS": [ ],
- "ALLOWED_BANDPASSES": [ ],
- "THUMBNAIL_TYPES": [ ],
- "FOLLOWUP_PRIORITIES": [ ],
- "ALLOWED_API_CLASSNAMES": [ ],
- "ANALYSIS_TYPES": [ ],
- "ANALYSIS_INPUT_TYPES": [ ],
- "AUTHENTICATION_TYPES": [ ]
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "Number of candidates": 0,
- "Number of objs": 0,
- "Number of sources": 0,
- "Number of photometry": 0,
- "Number of spectra": 0,
- "Number of groups": 0,
- "Number of users": 0,
- "Number of tokens": 0,
- "Oldest candidate creation datetime": "string",
- "Newest candidate creation datetime": "string"
}
}
Retrieve a single default follow-up request
default_followup_request_id required | integer |
{- "status": "success",
- "data": {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "allocation_id": 0,
- "default_followup_name": "string",
- "source_filter": null,
- "id": 0
}, - "message": "string"
}
Delete a default follow-up request
default_followup_request_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "allocation_id": 0,
- "default_followup_name": "string",
- "source_filter": null,
- "id": 0
}
], - "message": "string"
}
{- "status": "success",
- "data": [
- {
- "requester": null,
- "requester_id": 0,
- "filters": null,
- "default_tag_name": "string",
- "id": 0
}
], - "message": "string"
}
Delete a default observation plan
default_observation_plan_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "default_survey_efficiencies": [
- null
], - "requester_id": 0,
- "payload": null,
- "filters": null,
- "allocation_id": 0,
- "default_plan_name": "string",
- "id": 0
}
], - "message": "string"
}
Delete a default survey efficiency
default_survey_efficiency_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "default_observationplan_request": null,
- "default_observationplan_request_id": 0,
- "payload": null,
- "id": 0
}
], - "message": "string"
}
{- "status": "success",
- "data": {
- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0,
- "id": 0
}, - "message": "string"
}
Update filter name
filter_id required | integer |
stream | any Nullable The Filter's Stream. |
group | any Nullable The Filter's Group. |
candidates | Array of any |
name required | string Filter name. |
stream_id required | integer ID of the Filter's Stream. |
group_id required | integer ID of the Filter's Group. |
{- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0,
- "id": 0
}
], - "message": "string"
}
POST a new filter.
stream | any Nullable The Filter's Stream. |
group | any Nullable The Filter's Group. |
candidates | Array of any |
name required | string Filter name. |
stream_id required | integer ID of the Filter's Stream. |
group_id required | integer ID of the Filter's Group. |
{- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a filter as stored on Kowalski
filter_id required | integer |
{- "status": "success",
- "message": "string",
- "data": { }
}
POST a new filter version.
stream | any Nullable The Filter's Stream. |
group | any Nullable The Filter's Group. |
candidates | Array of any |
name required | string Filter name. |
stream_id required | integer ID of the Filter's Stream. |
group_id required | integer ID of the Filter's Group. |
{- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "pipeline": [
- { }
]
}
}
Delete a filter on Kowalski
filter_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a filter on Kowalski
filter_id required | integer |
filter_id required | integer >= 1 [fritz] science program filter id for this user group id |
active | boolean activate or deactivate filter |
active_fid | string 6 characters set fid as active version |
autosave | boolean automatically save passing candidates to filter's group |
update_annotations | boolean update annotations for existing candidates |
{- "filter_id": 1,
- "active": true,
- "active_fid": "string",
- "autosave": true,
- "update_annotations": true
}
{- "status": "success",
- "message": "string"
}
Create default follow-up request.
allocation_id required | integer Follow-up request allocation ID. |
target_group_ids | Array of integers IDs of groups to share the results of the default follow-up request with. |
payload | any Content of the default follow-up request. |
{- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "payload": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a single default observation plan
default_observation_plan_id required | integer |
{- "status": "success",
- "data": {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "default_survey_efficiencies": [
- null
], - "requester_id": 0,
- "payload": null,
- "filters": null,
- "allocation_id": 0,
- "default_plan_name": "string",
- "id": 0
}, - "message": "string"
}
Create default observation plan requests.
allocation_id required | integer Observation plan request allocation ID. |
target_group_ids | Array of integers IDs of groups to share the results of the default observation plan request with. |
payload | any Content of the default observation plan request. |
{- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "payload": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a single default survey efficiency
default_survey_efficiency_id required | integer |
{- "status": "success",
- "data": {
- "default_observationplan_request": null,
- "default_observationplan_request_id": 0,
- "payload": null,
- "id": 0
}, - "message": "string"
}
Create default survey efficiency requests.
payload | any Content of the default survey efficiency analysis. |
default_observationplan_request_id required | integer Default observation plan request ID. |
{- "payload": null,
- "default_observationplan_request_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Post a message from a remote facility
new_status required | string |
followup_request_id required | integer |
{- "new_status": "string",
- "followup_request_id": 0
}
{- "status": "success",
- "message": "string"
}
Add follow-up request to watch list
followup_request_id required | integer |
{- "status": "success",
- "message": "string"
}
Delete follow-up request from watch list
followup_request_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve followup requests schedule
sourceID | string Portion of ID to filter on |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at >= startDate |
endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at <= endDate |
status | string String to match status of request against |
observationStartDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, start time of observation window, otherwise now. |
observationEndDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, end time of observation window, otherwise 12 hours from now. |
includeStandards | boolean Include standards in schedule. Defaults to False. |
standardsOnly | boolean Only request standards in schedule. Defaults to False. |
standardType | string Origin of the standard stars, defined in config.yaml. Defaults to ESO. |
magnitudeRange | list lowest and highest magnitude to return, e.g. "(12,9)" |
output_format | string Output format for schedule. Can be png, pdf, or csv |
A PDF/PNG schedule file
{- "status": "error",
- "data": { },
- "message": "string"
}
Reprioritize followup requests schedule automatically based on either magnitude or location within skymap.
{- "status": "success",
- "message": "string"
}
Update a follow-up request
request_id required | string |
target_group_ids | Array of integers IDs of groups to share the results of the followup request with. |
obj_id required | string ID of the target Obj. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Followup request allocation ID. |
payload | any Content of the followup request. |
{- "target_group_ids": [
- 0
], - "obj_id": "string",
- "status": "pending submission",
- "allocation_id": 0,
- "payload": null
}
{- "status": "success",
- "message": "string"
}
Delete follow-up request.
request_id required | string |
{- "status": "success",
- "message": "string"
}
Submit follow-up request.
target_group_ids | Array of integers IDs of groups to share the results of the followup request with. |
obj_id required | string ID of the target Obj. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Followup request allocation ID. |
payload | any Content of the followup request. |
{- "target_group_ids": [
- 0
], - "obj_id": "string",
- "status": "pending submission",
- "allocation_id": 0,
- "payload": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Get photometry request.
request_id required | string |
{- "status": "success",
- "message": "string"
}
Upload galaxies from GLADE+ catalog. If no file_name or file_url is provided, will look for the GLADE+ catalog in the data directory. If it can't be found, it will download it.
file_name | string Name of the file containing the galaxies (in the data directory) |
file_url | string URL of the file containing the galaxies |
{- "file_name": "string",
- "file_url": "string"
}
{- "status": "success",
- "message": "string"
}
Upload galaxies from ASCII file
catalogData | any Catalog data Ascii string |
catalogName | string Galaxy catalog name. |
{- "catalogData": null,
- "catalogName": "string"
}
{- "status": "success",
- "data": [
- {
- "objects": [
- null
], - "catalog_name": "string",
- "name": "string",
- "alt_name": "string",
- "distmpc": 0,
- "distmpc_unc": 0,
- "redshift": 0,
- "redshift_error": 0,
- "sfr_fuv": 0,
- "sfr_w4": 0,
- "mstar": 0,
- "magb": 0,
- "magk": 0,
- "mag_fuv": 0,
- "mag_nuv": 0,
- "mag_w1": 0,
- "mag_w2": 0,
- "mag_w3": 0,
- "mag_w4": 0,
- "a": 0,
- "b2a": 0,
- "pa": 0,
- "btc": 0,
- "id": 0,
- "ra": 0,
- "dec": 0
}
], - "message": "string"
}
Set an object's host galaxy
obj_id required | string |
galaxyName required | string Name of the galaxy to associate with the object |
{- "galaxyName": "string"
}
{- "status": "success",
- "message": "string"
}
Delete an object's host galaxy
obj_id required | string |
{- "status": "success",
- "message": "string"
}
Upload spatial catalog from ASCII file
catalogData | any Catalog data Ascii string |
catalogName | string Spatial catalog name. |
{- "catalogData": null,
- "catalogName": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve all galaxies
catalog_name | string Filter by catalog name (exact match) |
ra | number RA for spatial filtering (in decimal degrees) |
dec | number Declination for spatial filtering (in decimal degrees) |
radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
galaxyName | string Portion of name to filter on |
minDistance | number If provided, return only galaxies with a distance of at least this value |
maxDistance | number If provided, return only galaxies with a distance of at most this value |
minRedshift | number If provided, return only galaxies with a redshift of at least this value |
maxRedshift | number If provided, return only galaxies with a redshift of at most this value |
localizationDateobs | string Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endopoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include galaxies |
includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
numPerPage | integer Number of galaxies to return per paginated request. Defaults to 100. Can be no larger than {MAX_OBSERVATIONS}. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
catalogNamesOnly | boolean Boolean indicating whether to just return catalog names. Defaults to false. |
returnProbability | boolean Boolean indicating whether to return probability density. Defaults to false. |
{- "status": "success",
- "data": [
- {
- "objects": [
- null
], - "catalog_name": "string",
- "name": "string",
- "alt_name": "string",
- "distmpc": 0,
- "distmpc_unc": 0,
- "redshift": 0,
- "redshift_error": 0,
- "sfr_fuv": 0,
- "sfr_w4": 0,
- "mstar": 0,
- "magb": 0,
- "magk": 0,
- "mag_fuv": 0,
- "mag_nuv": 0,
- "mag_w1": 0,
- "mag_w2": 0,
- "mag_w3": 0,
- "mag_w4": 0,
- "a": 0,
- "b2a": 0,
- "pa": 0,
- "btc": 0,
- "id": 0,
- "ra": 0,
- "dec": 0
}
], - "message": "string"
}
Ingest a Galaxy catalog
catalog_name | string Galaxy catalog name. |
catalog_data | Array of any Galaxy catalog data |
{- "catalog_name": "string",
- "catalog_data": [
- null
]
}
{- "status": "success",
- "message": "string"
}
Ingest a Spatial Catalog
catalog_name | string Spatial catalog name. |
catalog_data | Array of any Spatial catalog data |
{- "catalog_name": "string",
- "catalog_data": [
- null
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Delete a galaxy catalog
catalog_name required | str |
{- "status": "success",
- "message": "string"
}
Compute instrument field probabilities for a skymap
dateobs required | string |
Instrument ID required | integer |
localization_name required | string Localization map name |
integrated_probability | float Cumulative integrated probability threshold |
{- "status": "success",
- "message": "string"
}
Delete fields associated with an instrument
instrument_id required | integer |
{- "status": "success",
- "message": "string"
}
Add log messages from an instrument
instrument_id required | integer The instrument ID to post logs for |
start_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
end_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
logs required | object Nested JSON containing the log messages. |
{- "start_date": "string",
- "end_date": "string",
- "logs": { }
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Update the status of an instrument
instrument_id required | integer The instrument ID to update the status for |
status required | string The status of the instrument |
{- "status": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve an instrument
instrument_id required | integer |
includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
includeGeoJSONSummary | boolean Boolean indicating whether to include associated GeoJSON summary bounding box. Defaults to false. |
includeRegion | boolean Boolean indicating whether to include associated DS9 region. Defaults to false. |
localizationDateobs | string Include fields within a given localization.
Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
{- "status": "success",
- "data": {
- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2023-07-10T21:32:35Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true,
- "id": 0
}, - "message": "string"
}
Update instrument
instrument_id required | integer |
telescope | any Nullable The Telescope that hosts the Instrument. |
photometry | Array of any |
photometric_series | Array of any |
spectra | Array of any |
allocations | Array of any |
observing_runs | Array of any |
observations | Array of any |
queued_observations | Array of any |
fields | Array of any |
tiles | Array of any |
plans | Array of any |
logs | Array of any |
name required | string Instrument name. |
type required | string <= 20 characters Enum: "imager" "spectrograph" "imaging spectrograph" Instrument type, one of Imager, Spectrograph, or Imaging Spectrograph. |
band | string Nullable The spectral band covered by the instrument (e.g., Optical, IR). |
telescope_id required | integer The ID of the Telescope that hosts the Instrument. |
filters | Array of any List of filters on the instrument (if any). |
sensitivity_data | any Nullable JSON describing the filters on the instrument and the filter's corresponding limiting magnitude and exposure time. |
configuration_data | any Nullable JSON describing instrument configuration properties such as instrument overhead, filter change time, readout, etc. |
status | any Nullable JSON describing the latest status of the instrument. |
last_status_update | string <date-time> Nullable The time at which the status was last updated. |
api_classname | string <= 17 characters Nullable Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's API class. |
api_classname_obsplan | string <= 17 characters Nullable Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's ObservationPlan API class. |
listener_classname | string <= 12 characters Nullable Value: "SEDMListener" Name of the instrument's listener class. |
treasuremap_id | integer Nullable treasuremap.space API ID for this instrument |
tns_id | integer Nullable TNS API ID for this instrument |
region | string Nullable Instrument astropy.regions representation. |
has_fields | boolean Whether the instrument has fields or not. |
has_region | boolean Whether the instrument has a region or not. |
{- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2023-07-10T21:32:35Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true
}
{- "status": "success",
- "message": "string"
}
Delete an instrument
instrument_id required | integer |
fieldsOnly | boolean Boolean indicating whether to just delete the associated fields. Defaults to false. |
{- "status": "success",
- "message": "string"
}
Retrieve all instruments
name | string Filter by name (exact match) |
includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
includeGeoJSONSummary | boolean Boolean indicating whether to include associated GeoJSON summary bounding box. Defaults to false. |
includeRegion | boolean Boolean indicating whether to include associated DS9 region. Defaults to false. |
localizationDateobs | string Include fields within a given localization.
Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
airmassTime | string Time to use for airmass calculation in
ISO 8601 format ( |
{- "status": "success",
- "data": [
- {
- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2023-07-10T21:32:35Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true,
- "id": 0
}
], - "message": "string"
}
Add a new instrument
telescope | any Nullable The Telescope that hosts the Instrument. |
photometry | Array of any |
photometric_series | Array of any |
spectra | Array of any |
allocations | Array of any |
observing_runs | Array of any |
observations | Array of any |
queued_observations | Array of any |
fields | Array of any |
tiles | Array of any |
plans | Array of any |
logs | Array of any |
name required | string Instrument name. |
type required | string <= 20 characters Enum: "imager" "spectrograph" "imaging spectrograph" Instrument type, one of Imager, Spectrograph, or Imaging Spectrograph. |
band | string Nullable The spectral band covered by the instrument (e.g., Optical, IR). |
telescope_id required | integer The ID of the Telescope that hosts the Instrument. |
filters | Array of strings Default: [] Items Enum: "bessellux" "bessellb" "bessellv" "bessellr" "besselli" "standard::u" "standard::b" "standard::v" "standard::r" "standard::i" "desu" "desg" "desr" "desi" "desz" "desy" "sdssu" "sdssg" "sdssr" "sdssi" "sdssz" "f435w" "f475w" "f555w" "f606w" "f625w" "f775w" "f850lp" "nicf110w" "nicf160w" "f098m" "f105w" "f110w" "f125w" "f127m" "f139m" "f140w" "f153m" "f160w" "f218w" "f225w" "f275w" "f300x" "f336w" "f350lp" "f390w" "f689m" "f763m" "f845m" "f438w" "uvf475w" "uvf555w" "uvf606w" "uvf625w" "uvf775w" "uvf814w" "uvf850lp" "kepler" "cspb" "csphs" "csphd" "cspjs" "cspjd" "cspv3009" "cspv3014" "cspv9844" "cspys" "cspyd" "cspg" "cspi" "cspk" "cspr" "cspu" "f070w" "f090w" "f115w" "f150w" "f200w" "f277w" "f356w" "f444w" "f140m" "f162m" "f182m" "f210m" "f250m" "f300m" "f335m" "f360m" "f410m" "f430m" "f460m" "f480m" "f560w" "f770w" "f1000w" "f1130w" "f1280w" "f1500w" "f1800w" "f2100w" "f2550w" "f1065c" "f1140c" "f1550c" "f2300c" "lsstu" "lsstg" "lsstr" "lssti" "lsstz" "lssty" "keplercam::us" "keplercam::b" "keplercam::v" "keplercam::r" "keplercam::i" "4shooter2::us" "4shooter2::b" "4shooter2::v" "4shooter2::r" "4shooter2::i" "f062" "f087" "f106" "f129" "f158" "f184" "f213" "f146" "ztfg" "ztfr" "ztfi" "uvot::b" "uvot::u" "uvot::uvm2" "uvot::uvw1" "uvot::uvw2" "uvot::v" "uvot::white" "ps1::open" "ps1::g" "ps1::r" "ps1::i" "ps1::z" "ps1::y" "ps1::w" "atlasc" "atlaso" "2massj" "2massh" "2massks" "gaia::gbp" "gaia::g" "gaia::grp" "gaia::grvs" "tess" "gotob" "gotog" "gotol" "gotor" List of filters on the instrument (if any). |
sensitivity_data | object Nullable JSON describing the filters on the instrument and the filter's corresponding limiting magnitude and exposure time. |
configuration_data | object Nullable JSON describing instrument configuration properties such as instrument overhead, filter change time, readout, etc. |
status | any Nullable JSON describing the latest status of the instrument. |
last_status_update | string <date-time> Nullable The time at which the status was last updated. |
api_classname | string <= 17 characters Nullable Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's API class. |
api_classname_obsplan | string <= 17 characters Nullable Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's ObservationPlan API class. |
listener_classname | string <= 12 characters Nullable Value: "SEDMListener" Name of the instrument's listener class. |
treasuremap_id | integer Nullable treasuremap.space API ID for this instrument |
tns_id | integer Nullable TNS API ID for this instrument |
region | string Nullable Instrument astropy.regions representation. |
has_fields | boolean Whether the instrument has fields or not. |
has_region | boolean Whether the instrument has a region or not. |
field_data | dict List of ID, RA, and Dec for each field. |
field_region | str Serialized version of a regions.Region describing the shape of the instrument field. Note: should only include field_region or field_fov_type. |
references | dict List of filter, and limiting magnitude for each reference. |
field_fov_type | str Option for instrument field shape. Must be either circle or rectangle. Note: should only include field_region or field_fov_type. |
field_fov_attributes | list Option for instrument field shape parameters. Single float radius in degrees in case of circle or list of two floats (height and width) in case of a rectangle. |
{- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": {
- "filter_name": "bessellux"
}, - "configuration_data": {
- "filter_name": {
- "filt_change_time": null,
- "readout": null,
- "overhead_per_exposure": null,
- "slew_rate": null
}
}, - "status": null,
- "last_status_update": "2023-07-10T21:32:35Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true,
- "field_data": null,
- "field_region": null,
- "references": null,
- "field_fov_type": null,
- "field_fov_attributes": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Delete a spatial catalog
catalog_id required | integer |
{- "status": "success",
- "message": "string"
}
Perform a prediction analysis for the earthquake.
earthquake_id required | string |
mma_detector_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve a ground velocity measurement for the earthquake.
earthquake_id required | string |
mma_detector_id required | string |
{- "status": "success",
- "data": {
- "event_id": 0,
- "detector_id": 0,
- "rfamp": 0,
- "lockloss": 0,
- "id": 0
}, - "message": "string"
}
Provide a ground velocity measurement for the earthquake.
earthquake_id required | string |
mma_detector_id required | string |
{- "status": "success",
- "message": "string"
}
Delete a ground velocity measurement for the earthquake.
earthquake_id required | string |
mma_detector_id required | string |
{- "status": "success",
- "message": "string"
}
Update a ground velocity measurement for the earthquake.
earthquake_id required | string |
mma_detector_id required | string |
{- "status": "success",
- "message": "string"
}
Delete an Earthquake event
event_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve multiple Earthquake events
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by date >= startDate |
endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by date <= endDate |
statusKeep | string Earthquake Status to match against |
statusRemove | string Earthquake Status to filter out |
numPerPage | integer Number of earthquakes. Defaults to 100. |
pageNumber | integer Page number for iterating through all earthquakes. Defaults to 1 |
Ingest EarthquakeEvent
sent_by | any Nullable The user that saved this EarthquakeEvent |
notices | Array of any |
predictions | Array of any |
measurements | Array of any |
comments | Array of any |
reminders | Array of any |
sent_by_id required | integer The ID of the User who created this GcnTag. |
event_id required | string |
event_uri | string Nullable |
status | string The status of the earthquake event. |
{- "sent_by": null,
- "notices": [
- null
], - "predictions": [
- null
], - "measurements": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "sent_by_id": 0,
- "event_id": "string",
- "event_uri": "string",
- "status": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all comments associated with specified resource
associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
], - "message": "string"
}
Update a comment
associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" "shift" What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" "shift" The ID of the source or spectrum that the comment is posted to. This would be a string for an object ID or an integer for a spectrum, gcn_event or shift. |
comment_id required | integer |
obj | any Nullable The Comment's Obj. |
author | any Nullable Comment's author. |
groups | Array of any |
obj_id required | string ID of the Comment's Obj. |
text required | string Comment body. |
attachment_name | string Nullable Filename of the attachment. |
_attachment_path | string Nullable file path where the data of the attachment is saved. |
origin | string Nullable Comment origin. |
bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
attachment_bytes | string Nullable Binary representation of the attachment. |
author_id required | integer ID of the Comment author's User instance. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. |
{- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Post a comment
associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" "earthquake" "shift" What underlying data the comment is on: "source" or "spectrum" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" "earthquake" "shift" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
text required | string |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. Defaults to all of requesting user's groups. |
attachment | object |
{- "text": "string",
- "group_ids": [
- 0
], - "attachment": {
- "body": "string",
- "name": "string"
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "comment_id": 0
}
}
Delete a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event. |
comment_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
comment_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}, - "message": "string"
}
Update a comment
associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" "shift" What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" "shift" The ID of the source or spectrum that the comment is posted to. This would be a string for an object ID or an integer for a spectrum, gcn_event or shift. |
comment_id required | integer |
obj | any Nullable The Comment's Obj. |
author | any Nullable Comment's author. |
groups | Array of any |
obj_id required | string ID of the Comment's Obj. |
text required | string Comment body. |
attachment_name | string Nullable Filename of the attachment. |
_attachment_path | string Nullable file path where the data of the attachment is saved. |
origin | string Nullable Comment origin. |
bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
attachment_bytes | string Nullable Binary representation of the attachment. |
author_id required | integer ID of the Comment author's User instance. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. |
{- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Delete a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event. |
comment_id required | integer |
{- "status": "success",
- "message": "string"
}
Download comment attachment
associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" What underlying data the comment is on: "sources" or "spectra". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum. |
comment_id required | integer |
download | boolean If true, download the attachment; else return file data as text. True by default. |
preview | boolean If true, return an attachment preview. False by default. |
Download comment attachment
associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" What underlying data the comment is on: "sources" or "spectra". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum. |
comment_id required | integer |
download | boolean If true, download the attachment; else return file data as text. True by default. |
preview | boolean If true, return an attachment preview. False by default. |
find the number of comments with and without attachment_bytes
{- "status": "success",
- "message": "string",
- "data": {
- "totalWithoutAttachmentBytes": 0,
- "totalWithAttachmentBytes": 0
}
}
create attachments for a batch of comments with attachment_bytes
numPerPage | integer Number of comments to check for updates. Defaults to 100. Max 500. |
pageNumber | integer Page number for iterating through all comments. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Retrieve all comments associated with specified resource
associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
], - "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Retrieve a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
comment_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}, - "message": "string"
}
Retrieve a reminder
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" "earthquake" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake" |
resource_id required | string The ID of the source, spectrum, gcn_event or shift that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event |
reminder_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:35Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}, - "message": "string"
}
Retrieve all reminders associated with specified resource
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:35Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
], - "message": "string"
}
Retrieve all spectra associated with an Object
obj_id required | string ID of the object to retrieve spectra for |
normalization | string what normalization is needed for the spectra (e.g., "median"). If omitted, returns the original spectrum. Options for normalization are:
|
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
]
}
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Retrieve an annotation
associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
annotation_id required | integer |
{- "status": "success",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}, - "message": "string"
}
Retrieve a spectrum
spectrum_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}, - "message": "string"
}
Update spectrum
spectrum_id required | integer |
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
external_observer | string Nullable Default: null Free text provided as an external observer |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
obj_id required | string ID of this Spectrum's Obj. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
origin | string Origin of the spectrum. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
external_reducer | string Nullable Default: null Free text provided as an external reducer |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
altdata | any Miscellaneous alternative metadata. |
instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
{- "group_ids": [ ],
- "followup_request_id": 0,
- "fluxes": [
- 0
], - "external_observer": null,
- "type": "source",
- "wavelengths": [
- 0
], - "reduced_by": [ ],
- "obj_id": "string",
- "assignment_id": 0,
- "origin": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "external_reducer": null,
- "errors": [
- 0
], - "label": "string",
- "altdata": null,
- "instrument_id": 0,
- "units": "string",
- "observed_by": [ ]
}
{- "status": "success",
- "message": "string"
}
Retrieve multiple spectra with given criteria
minimalPayload | boolean If true, return only the minimal metadata about each spectrum, instead of returning the potentially large payload that includes wavelength/flux and also comments and annotations. The metadata that is always included is: id, obj_id, owner_id, origin, type, label, observed_at, created_at, modified, instrument_id, instrument_name, original_file_name, followup_request_id, assignment_id, and altdata. |
observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed before this time. |
observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed after this time. |
objID | string Return any spectra on an object with ID that has a (partial) match to this argument (i.e., the given argument is "in" the object's ID). |
instrumentIDs | any If provided, filter only spectra observed with one of these instrument IDs. |
groupIDs | list If provided, filter only spectra saved to one of these group IDs. |
followupRequestIDs | list If provided, filter only spectra associate with these followup request IDs. |
assignmentIDs | list If provided, filter only spectra associate with these assignment request IDs. |
origin | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
label | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
type | string Return spectra of the given type or types (match multiple values using a comma separated list). Types of spectra are defined in the config, e.g., source, host or host_center. |
commentsFilter | Array of strings Comma-separated string of comment text to filter for spectra matching. |
commentsFilterAuthor | string Comma separated string of authors. Only comments from these authors are used when filtering with the commentsFilter. |
commentsFilterBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments before this time. |
commentsFilterAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments after this time. |
Upload spectrum
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
external_observer | string Nullable Default: null Free text provided as an external observer |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
obj_id required | string ID of this Spectrum's Obj. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
origin | string Origin of the spectrum. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
external_reducer | string Nullable Default: null Free text provided as an external reducer |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
altdata | any Miscellaneous alternative metadata. |
instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
{- "group_ids": [ ],
- "followup_request_id": 0,
- "fluxes": [
- 0
], - "external_observer": null,
- "type": "source",
- "wavelengths": [
- 0
], - "reduced_by": [ ],
- "obj_id": "string",
- "assignment_id": 0,
- "origin": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "external_reducer": null,
- "errors": [
- 0
], - "label": "string",
- "altdata": null,
- "instrument_id": 0,
- "units": "string",
- "observed_by": [ ]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Parse spectrum from ASCII file
wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
fluxerr_column | integer Nullable Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
{- "wave_column": 0,
- "flux_column": 1,
- "ascii": "string",
- "fluxerr_column": null
}
{- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string"
}
Upload spectrum from ASCII file
group_ids | Array of integers The IDs of the groups to share this spectrum with. |
wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
external_observer | string Nullable Default: null Free text provided as an external observer |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source', 'host', 'host_center'. Defaults to 'fsource'. |
obj_id required | string The ID of the object that the spectrum is of. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
filename required | string The original filename (for bookkeeping purposes). |
flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
external_reducer | string Nullable Default: null Free text provided as an external reducer |
label | string User defined label to be placed in plot legends, instead of the default |
instrument_id required | integer The ID of the instrument that took the spectrum. |
reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
fluxerr_column | integer Nullable Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
{- "group_ids": [
- 0
], - "wave_column": 0,
- "followup_request_id": 0,
- "external_observer": null,
- "type": "source",
- "obj_id": "string",
- "assignment_id": 0,
- "ascii": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "filename": "string",
- "flux_column": 1,
- "external_reducer": null,
- "label": "string",
- "instrument_id": 0,
- "reduced_by": [ ],
- "observed_by": [ ],
- "fluxerr_column": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Create synthetic photometry from a spectrum
spectrum_id required | integer |
filters required | list List of filters |
{- "status": "success",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}, - "message": "string"
}
Retrieve spectra for given instrument within date range
instrument_ids | list of integers Instrument id numbers of spectrum. If None, retrieve for all instruments. |
min_date | ISO UTC date string Minimum UTC date of range in ISOT format. If None, open ended range. |
max_date | ISO UTC date string Maximum UTC date of range in ISOT format. If None, open ended range. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
]
}
}
Retrieve a spectrum
spectrum_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}, - "message": "string"
}
Update spectrum
spectrum_id required | integer |
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
external_observer | string Nullable Default: null Free text provided as an external observer |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
obj_id required | string ID of this Spectrum's Obj. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
origin | string Origin of the spectrum. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
external_reducer | string Nullable Default: null Free text provided as an external reducer |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
altdata | any Miscellaneous alternative metadata. |
instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
{- "group_ids": [ ],
- "followup_request_id": 0,
- "fluxes": [
- 0
], - "external_observer": null,
- "type": "source",
- "wavelengths": [
- 0
], - "reduced_by": [ ],
- "obj_id": "string",
- "assignment_id": 0,
- "origin": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "external_reducer": null,
- "errors": [
- 0
], - "label": "string",
- "altdata": null,
- "instrument_id": 0,
- "units": "string",
- "observed_by": [ ]
}
{- "status": "success",
- "message": "string"
}
Retrieve multiple spectra with given criteria
minimalPayload | boolean If true, return only the minimal metadata about each spectrum, instead of returning the potentially large payload that includes wavelength/flux and also comments and annotations. The metadata that is always included is: id, obj_id, owner_id, origin, type, label, observed_at, created_at, modified, instrument_id, instrument_name, original_file_name, followup_request_id, assignment_id, and altdata. |
observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed before this time. |
observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed after this time. |
objID | string Return any spectra on an object with ID that has a (partial) match to this argument (i.e., the given argument is "in" the object's ID). |
instrumentIDs | any If provided, filter only spectra observed with one of these instrument IDs. |
groupIDs | list If provided, filter only spectra saved to one of these group IDs. |
followupRequestIDs | list If provided, filter only spectra associate with these followup request IDs. |
assignmentIDs | list If provided, filter only spectra associate with these assignment request IDs. |
origin | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
label | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
type | string Return spectra of the given type or types (match multiple values using a comma separated list). Types of spectra are defined in the config, e.g., source, host or host_center. |
commentsFilter | Array of strings Comma-separated string of comment text to filter for spectra matching. |
commentsFilterAuthor | string Comma separated string of authors. Only comments from these authors are used when filtering with the commentsFilter. |
commentsFilterBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments before this time. |
commentsFilterAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments after this time. |
Upload spectrum
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
external_observer | string Nullable Default: null Free text provided as an external observer |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
obj_id required | string ID of this Spectrum's Obj. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
origin | string Origin of the spectrum. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
external_reducer | string Nullable Default: null Free text provided as an external reducer |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
altdata | any Miscellaneous alternative metadata. |
instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
{- "group_ids": [ ],
- "followup_request_id": 0,
- "fluxes": [
- 0
], - "external_observer": null,
- "type": "source",
- "wavelengths": [
- 0
], - "reduced_by": [ ],
- "obj_id": "string",
- "assignment_id": 0,
- "origin": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "external_reducer": null,
- "errors": [
- 0
], - "label": "string",
- "altdata": null,
- "instrument_id": 0,
- "units": "string",
- "observed_by": [ ]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Parse spectrum from ASCII file
wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
fluxerr_column | integer Nullable Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
{- "wave_column": 0,
- "flux_column": 1,
- "ascii": "string",
- "fluxerr_column": null
}
{- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string"
}
Upload spectrum from ASCII file
group_ids | Array of integers The IDs of the groups to share this spectrum with. |
wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
external_observer | string Nullable Default: null Free text provided as an external observer |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source', 'host', 'host_center'. Defaults to 'fsource'. |
obj_id required | string The ID of the object that the spectrum is of. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
filename required | string The original filename (for bookkeeping purposes). |
flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
external_reducer | string Nullable Default: null Free text provided as an external reducer |
label | string User defined label to be placed in plot legends, instead of the default |
instrument_id required | integer The ID of the instrument that took the spectrum. |
reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
fluxerr_column | integer Nullable Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
{- "group_ids": [
- 0
], - "wave_column": 0,
- "followup_request_id": 0,
- "external_observer": null,
- "type": "source",
- "obj_id": "string",
- "assignment_id": 0,
- "ascii": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "filename": "string",
- "flux_column": 1,
- "external_reducer": null,
- "label": "string",
- "instrument_id": 0,
- "reduced_by": [ ],
- "observed_by": [ ],
- "fluxerr_column": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve spectra for given instrument within date range
instrument_ids | list of integers Instrument id numbers of spectrum. If None, retrieve for all instruments. |
min_date | ISO UTC date string Minimum UTC date of range in ISOT format. If None, open ended range. |
max_date | ISO UTC date string Maximum UTC date of range in ISOT format. If None, open ended range. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
]
}
}
Submit a (classification) spectrum to TNS
spectrum_id required | integer |
tnsrobotID required | int SkyPortal TNS Robot ID |
classificationID | string Classification ID (see TNS documentation at https://www.wis-tns.org/content/tns-getting-started for options) |
classifiers | string List of those performing classification. |
spectrumType | string Type of spectrum that this is. Valid options are: ['object', 'host', 'sky', 'arcs', 'synthetic'] |
spectrumComment | string Comment on the spectrum. |
classificationComment | string Comment on the classification. |
{- "status": "success",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2023-07-10T21:32:35Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}, - "message": "string"
}
Retrieve all comments associated with specified resource
associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
], - "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Retrieve a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
comment_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}, - "message": "string"
}
Retrieve a reminder
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" "earthquake" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake" |
resource_id required | string The ID of the source, spectrum, gcn_event or shift that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event |
reminder_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:35Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}, - "message": "string"
}
Retrieve all reminders associated with specified resource
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:35Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
], - "message": "string"
}
calculate healpix values for a batch of sources without a Healpix value
numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Get a summary of all the activity of shift users on skyportal for a given period
shift_id required | integer |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}
Copy all photometry points from one source to another
target_id required | string The obj_id of the target Source (to which the photometry is being copied to) |
group_ids required | Array of integers List of IDs of groups to give photometry access to |
origin_id required | string The ID of the Source's Obj the photometry is being copied from |
{- "group_ids": [
- 0
], - "origin_id": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve offset stars to aid in spectroscopy
obj_id required | string |
facility | string Enum: "Keck" "Shane" "P200" Which facility to generate the starlist for |
num_offset_stars | integer [ 0 .. 10 ] Requested number of offset stars (set to zero to get starlist of just the source itself) |
obstime | string datetime of observation in isoformat (e.g. 2020-12-30T12:34:10) |
use_ztfref | boolean Use ZTFref catalog for offset star positions, otherwise Gaia DR3 |
{- "status": "success",
- "message": "string",
- "data": {
- "facility": "Keck",
- "starlist_str": "string",
- "starlist_info": [
- {
- "str": "string",
- "ra": 0,
- "dec": 0,
- "name": "string",
- "dras": "string",
- "ddecs": "string",
- "mag": 0
}
], - "ra": 0,
- "dec": 0,
- "queries_issued": 0,
- "noffsets": 0,
- "query": "string"
}
}
Generate a PDF/PNG finding chart to aid in spectroscopy
obj_id required | string |
imsize | float [ 2 .. 15 ] Image size in arcmin (square) |
facility | string Enum: "Keck" "Shane" "P200" |
image_source | string Enum: "desi" "dss" "ztfref" "ps1" Source of the image used in the finding chart. Defaults to ps1 |
use_ztfref | boolean Use ZTFref catalog for offset star positions, otherwise DR3 |
obstime | string datetime of observation in isoformat (e.g. 2020-12-30T12:34:10) |
type | string Enum: "png" "pdf" output type |
num_offset_stars | integer [ 0 .. 4 ] output desired number of offset stars [0,5] (default: 3) |
A PDF/PNG finding chart file
{- "status": "error",
- "data": { },
- "message": "string"
}
Retrieve an object's classifications
obj_id required | string |
{- "status": "success",
- "data": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
], - "message": "string"
}
Delete all of an object's classifications
classification_id required | integer |
label | boolean Nullable Add label associated with classification. |
{- "label": true
}
{- "status": "success",
- "message": "string"
}
Retrieve basic info on Groups that an Obj is saved to
obj_id required | integer |
{- "status": "success",
- "data": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
], - "message": "string"
}
Note that a source has been labelled.
obj_id required | string ID of object to indicate source labelling for |
groupIds required | Array of integers List of IDs of groups to indicate labelling for |
{- "groupIds": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Delete source labels
obj_id required | string |
groupIds required | Array of integers List of IDs of groups to indicate scanning for |
{- "groupIds": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Retrieve an annotation
associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
annotation_id required | integer |
{- "status": "success",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}, - "message": "string"
}
Retrieve a source
obj_id required | string |
includePhotometry | boolean Boolean indicating whether to include associated photometry. Defaults to false. |
includeComments | boolean Boolean indicating whether to include comment metadata in response. Defaults to false. |
includeAnalyses | boolean Boolean indicating whether to include associated analyses. Defaults to false. |
includePhotometryExists | boolean Boolean indicating whether to return if a source has any photometry points. Defaults to false. |
includeSpectrumExists | boolean Boolean indicating whether to return if a source has a spectra. Defaults to false. |
includeCommentExists | boolean Boolean indicating whether to return if a source has a comment. Defaults to false. |
includePeriodExists | boolean Boolean indicating whether to return if a source has a period set. Defaults to false. |
includeThumbnails | boolean Boolean indicating whether to include associated thumbnails. Defaults to false. |
{- "status": "success",
- "data": {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}, - "message": "string"
}
Update a source
obj_id required | string |
host | any Nullable The Galaxy associated with this source. |
comments | Array of any |
reminders | Array of any |
comments_on_spectra | Array of any |
reminders_on_spectra | Array of any |
annotations | Array of any |
annotations_on_spectra | Array of any |
annotations_on_photometry | Array of any |
classifications | Array of any |
photometry | Array of any |
photstats | Array of any |
photometric_series | Array of any |
spectra | Array of any |
thumbnails | Array of any |
followup_requests | Array of any |
assignments | Array of any |
obj_notifications | Array of any |
obj_analyses | Array of any |
sources_in_gcns | Array of any |
ra_dis | number Nullable J2000 Right Ascension at discovery time [deg]. |
dec_dis | number Nullable J2000 Declination at discovery time [deg]. |
ra_err | number Nullable Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number Nullable Error on J2000 Declination at discovery time [deg]. |
offset | number Nullable Offset from nearest static object [arcsec]. |
redshift | number Nullable Redshift. |
redshift_error | number Nullable Redshift error. |
redshift_origin | string Nullable Redshift source. |
redshift_history | any Nullable Record of who set which redshift values and when. |
host_id | integer Nullable The ID of the Galaxy to which this Obj is associated. |
summary | string Nullable Summary of the obj. |
summary_history | any Nullable Record of the summaries generated and written about this obj |
altdata | any Nullable Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number Nullable Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number Nullable Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number Nullable Error on magnitude of the nearest Obj [mag]. |
transient | boolean Nullable Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean Nullable Boolean indicating whether the object is a variable star. |
is_roid | boolean Nullable Boolean indicating whether the object is a moving object. |
mpc_name | string Nullable Minor planet center name. |
gcn_crossmatch | any Nullable List of GCN event dateobs for crossmatched events. |
tns_name | string Nullable Transient Name Server name. |
tns_info | any Nullable TNS info in JSON format |
score | number Nullable Machine learning score. |
origin | string Nullable Origin of the object. |
alias | any Nullable Alternative names for this object. |
internal_key | string Internal key used for secure websocket messaging. |
detect_photometry_count | integer Nullable How many times the object was detected above :math: |
ra | number Nullable |
dec | number Nullable |
candidates | Array of any |
sources | Array of any |
users | Array of any |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
{- "status": "success",
- "message": "string"
}
Retrieve all sources
ra | number RA for spatial filtering (in decimal degrees) |
dec | number Declination for spatial filtering (in decimal degrees) |
radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
sourceID | string Portion of ID to filter on |
rejectedSourceIDs | str Comma-separated string of object IDs not to be returned, useful in cases where you are looking for new sources passing a query. |
simbadClass | string Simbad class to filter on |
alias | Array of any additional name for the same object |
origin | string who posted/discovered this source |
hasTNSname | boolean If true, return only those matches with TNS names |
hasBeenLabelled | boolean If true, return only those objects which have been labelled |
hasNotBeenLabelled | boolean If true, return only those objects which have not been labelled |
currentUserLabeller | boolean If true and one of hasBeenLabeller or hasNotBeenLabelled is true, return only those objects which have been labelled/not labelled by the current user. Otherwise, return results for all users. |
numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
totalMatches | integer Used only in the case of paginating query results - if provided, this allows for avoiding a potentially expensive query.count() call. |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by PhotStat.first_detected_mjd >= startDate |
endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by PhotStat.last_detected_mjd <= endDate |
listName | string Get only sources saved to the querying user's list, e.g., "favorites". |
group_ids | list If provided, filter only sources saved to one of these group IDs. |
includeColorMagnitude | boolean Boolean indicating whether to include the color-magnitude data from Gaia. This will only include data for objects that have an annotation with the appropriate format: an annotation that contains a dictionary with keys named Mag_G, Mag_Bp, Mag_Rp, and Plx (underscores and case are ignored when matching all the above keys). The result is saved in a field named 'color_magnitude'. If no data is available, returns an empty array. Defaults to false (do not search for nor include this info). |
includeRequested | boolean Boolean indicating whether to include requested saves. Defaults to false. |
pendingOnly | boolean Boolean indicating whether to only include requested/pending saves. Defaults to false. |
savedBefore | string Only return sources that were saved before this UTC datetime. |
savedAfter | string Only return sources that were saved after this UTC datetime. |
hasSpectrumAfter | string Only return sources with a spectrum saved after this UTC datetime |
hasSpectrumBefore | string Only return sources with a spectrum saved before this UTC datetime |
saveSummary | boolean Boolean indicating whether to only return the source save
information in the response (defaults to false). If true,
the response will contain a list of dicts with the following
schema under
|
sortBy | string The field to sort by. Currently allowed options are ["id", "ra", "dec", "redshift", "saved_at"] |
sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
includeComments | boolean Boolean indicating whether to include comment metadata in response. Defaults to false. |
includePhotometryExists | boolean Boolean indicating whether to return if a source has any photometry points. Defaults to false. |
includeSpectrumExists | boolean Boolean indicating whether to return if a source has a spectra. Defaults to false. |
includeLabellers | boolean Boolean indicating whether to return list of users who have labelled this source. Defaults to false. |
includeHosts | boolean Boolean indicating whether to return source host galaxies. Defaults to false. |
includeCommentExists | boolean Boolean indicating whether to return if a source has a comment. Defaults to false. |
removeNested | boolean Boolean indicating whether to remove nested output. Defaults to false. |
includeThumbnails | boolean Boolean indicating whether to include associated thumbnails. Defaults to false. |
includeDetectionStats | boolean Boolean indicating whether to include photometry detection statistics for each source (last detection and peak detection). Defaults to false. |
classifications | Array of strings Comma-separated string of "taxonomy: classification" pair(s) to filter for sources matching that/those classification(s), i.e. "Sitewide Taxonomy: Type II, Sitewide Taxonomy: AGN" |
classifications_simul | boolean Boolean indicating whether object must satisfy all classifications if query (i.e. an AND rather than an OR). Defaults to false. |
nonclassifications | Array of strings Comma-separated string of "taxonomy: classification" pair(s) to filter for sources NOT matching that/those classification(s), i.e. "Sitewide Taxonomy: Type II, Sitewide Taxonomy: AGN" |
unclassified | boolean Boolean indicating whether to reject any sources with classifications. Defaults to false. |
annotationsFilter | Array of strings Comma-separated string of "annotation: value: operator" triplet(s) to filter for sources matching that/those annotation(s), i.e. "redshift: 0.5: lt" |
annotationsFilterOrigin | string Comma separated string of origins. Only annotations from these origins are used when filtering with the annotationsFilter. |
annotationsFilterBefore | string Only return sources that have annotations before this UTC datetime. |
annotationsFilterAfter | string Only return sources that have annotations after this UTC datetime. |
commentsFilter | Array of strings Comma-separated string of comment text to filter for sources matching. |
commentsFilterAuthor | string Comma separated string of authors. Only comments from these authors are used when filtering with the commentsFilter. |
commentsFilterBefore | string Only return sources that have comments before this UTC datetime. |
commentsFilterAfter | string Only return sources that have comments after this UTC datetime. |
minRedshift | number If provided, return only sources with a redshift of at least this value |
maxRedshift | number If provided, return only sources with a redshift of at most this value |
minPeakMagnitude | number If provided, return only sources with a peak photometry magnitude of at least this value |
maxPeakMagnitude | number If provided, return only sources with a peak photometry magnitude of at most this value |
minLatestMagnitude | number If provided, return only sources whose latest photometry magnitude is at least this value |
maxLatestMagnitude | number If provided, return only sources whose latest photometry magnitude is at most this value |
numberDetections | number If provided, return only sources who have at least numberDetections detections. |
hasSpectrum | boolean If true, return only those matches with at least one associated spectrum |
hasFollowupRequest | boolean If true, return only those matches with at least one associated followup request |
followupRequestStatus | string If provided, string to match status of followup_request against |
createdOrModifiedAfter | string Arrow-parseable date-time string (e.g. 2020-01-01 or 2020-01-01T00:00:00 or 2020-01-01T00:00:00+00:00). If provided, filter by created_at or modified > createdOrModifiedAfter |
localizationDateobs | string Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include sources |
localizationRejectSources | bool Remove sources rejected in localization. Defaults to false. |
spatialCatalogName | string Name of spatial catalog to use. spatialCatalogEntryName must also be defined for use. |
spatialCatalogEntryName | string Name of spatial catalog entry to use. spatialCatalogName must also be defined for use. |
includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "sources": [
- {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Add a new source
host | any Nullable The Galaxy associated with this source. |
comments | Array of any |
reminders | Array of any |
comments_on_spectra | Array of any |
reminders_on_spectra | Array of any |
annotations | Array of any |
annotations_on_spectra | Array of any |
annotations_on_photometry | Array of any |
classifications | Array of any |
photometry | Array of any |
photstats | Array of any |
photometric_series | Array of any |
spectra | Array of any |
thumbnails | Array of any |
followup_requests | Array of any |
assignments | Array of any |
obj_notifications | Array of any |
obj_analyses | Array of any |
sources_in_gcns | Array of any |
id required | string Name of the object. |
ra_dis | number Nullable J2000 Right Ascension at discovery time [deg]. |
dec_dis | number Nullable J2000 Declination at discovery time [deg]. |
ra_err | number Nullable Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number Nullable Error on J2000 Declination at discovery time [deg]. |
offset | number Nullable Offset from nearest static object [arcsec]. |
redshift | number Nullable Redshift. |
redshift_error | number Nullable Redshift error. |
redshift_origin | string Nullable Redshift source. |
host_id | integer Nullable The ID of the Galaxy to which this Obj is associated. |
summary | string Nullable Summary of the obj. |
summary_history | any Nullable Record of the summaries generated and written about this obj |
altdata | any Nullable Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number Nullable Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number Nullable Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number Nullable Error on magnitude of the nearest Obj [mag]. |
transient | boolean Nullable Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean Nullable Boolean indicating whether the object is a variable star. |
is_roid | boolean Nullable Boolean indicating whether the object is a moving object. |
mpc_name | string Nullable Minor planet center name. |
gcn_crossmatch | any Nullable List of GCN event dateobs for crossmatched events. |
tns_name | string Nullable Transient Name Server name. |
tns_info | any Nullable TNS info in JSON format |
score | number Nullable Machine learning score. |
origin | string Nullable Origin of the object. |
alias | any Nullable Alternative names for this object. |
healpix | integer Nullable |
detect_photometry_count | integer Nullable How many times the object was detected above :math: |
ra | number Nullable |
dec | number Nullable |
candidates | Array of any |
sources | Array of any |
users | Array of any |
group_ids | Array of integers List of associated group IDs. If not specified, all of the user or token's groups will be used. |
refresh_source | bool Refresh source upon post. Defaults to True. |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "healpix": 0,
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "group_ids": [
- 0
], - "refresh_source": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": "string"
}
}
Retrieve all sources
ra | number RA for spatial filtering (in decimal degrees) |
dec | number Declination for spatial filtering (in decimal degrees) |
radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
Save or request group(s) to save source, and optionally unsave from group(s).
objId required | string ID of the object in question. |
inviteGroupIds required | Array of integers List of group IDs to save or invite to save specified source. |
unsaveGroupIds | Array of integers List of group IDs from which specified source is to be unsaved. |
{- "objId": "string",
- "inviteGroupIds": [
- 0
], - "unsaveGroupIds": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Update a Source table row
obj_id required | integer |
groupID required | integer |
active required | boolean |
requested required | boolean |
{- "groupID": 0,
- "active": true,
- "requested": true
}
{- "status": "success",
- "message": "string"
}
Retrieve all comments associated with specified resource
associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
], - "message": "string"
}
Retrieve all comments associated with specified resource
associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
], - "message": "string"
}
Retrieve a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
comment_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}, - "message": "string"
}
Retrieve all comments associated with specified resource
associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
], - "message": "string"
}
Retrieve a comment
associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
comment_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}, - "message": "string"
}
Get a summary of all the activity of shift users on skyportal for a given period
shift_id required | integer |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}
Retrieve shifts
shift_id required | integer |
group_id | integer |
{- "status": "success",
- "data": [
- {
- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2023-07-10T21:32:36Z",
- "end_date": "2023-07-10T21:32:36Z",
- "group_id": 0,
- "required_users_number": 0,
- "id": 0,
- "shift_users_ids": null
}
], - "message": "string"
}
Update a shift
shift_id required | integer |
group | any Nullable The Shift's Group. |
users | Array of any |
shift_users | Array of any |
comments | Array of any |
reminders | Array of any |
name | string Nullable Name of the shift. |
description | string Nullable Longer description of the shift. |
start_date required | string <date-time> The start time of this shift. |
end_date required | string <date-time> The end time of this shift. |
group_id required | integer ID of the Shift's Group. |
required_users_number | integer Nullable The number of users required to join this shift for it to be considered full |
{- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2023-07-10T21:32:36Z",
- "end_date": "2023-07-10T21:32:36Z",
- "group_id": 0,
- "required_users_number": 0
}
{- "status": "success",
- "message": "string"
}
Add a new shift
group | any Nullable The Shift's Group. |
users | Array of any |
shift_users | Array of any |
comments | Array of any |
reminders | Array of any |
name | string Nullable Name of the shift. |
description | string Nullable Longer description of the shift. |
start_date required | string <date-time> The start time of this shift. |
end_date required | string <date-time> The end time of this shift. |
group_id required | integer ID of the Shift's Group. |
required_users_number | integer Nullable The number of users required to join this shift for it to be considered full |
shift_admins | Array of integers List of IDs of users to be shift admins. Current user will automatically be added as a shift admin. |
{- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2023-07-10T21:32:36Z",
- "end_date": "2023-07-10T21:32:36Z",
- "group_id": 0,
- "required_users_number": 0,
- "shift_admins": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0,
- "name": "string",
- "start_date": "string",
- "end_date": "string",
- "shift_admins": [ ],
- "description": "string",
- "required_users_number": 0
}
}
Add a shift user
shift_id required | integer |
userID required | integer |
admin required | boolean |
{- "userID": 0,
- "admin": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "shift_id": 0,
- "user_id": 0,
- "admin": true,
- "needs_replacement": true
}
}
Delete a shift user
shift_id required | integer |
user_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a shift user's admin status, or needs_replacement status
shift_id required | integer |
userID required | integer |
admin | boolean Boolean indicating whether user is shift admin. |
needs_replacement | boolean Boolean indicating whether user needs replacement or not |
{- "userID": 0,
- "admin": true,
- "needs_replacement": true
}
{- "status": "success",
- "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Update an annotation
associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum. |
annotation_id required | integer |
author | any Nullable Annotation's author. |
obj | any Nullable The Annotation's Obj. |
groups | Array of any |
data required | any Searchable data in JSON format |
origin required | string What generated the annotation. This should generally map to a filter/group name. But since an annotation can be made accessible to multiple groups, the origin name does not necessarily have to map to a single group name. The important thing is to make the origin distinct and descriptive such that annotations from the same origin generally have the same metrics. One annotation with multiple fields from each origin is allowed. |
author_id required | integer ID of the Annotation author's User instance. |
obj_id required | string ID of the Annotation's Obj. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the annotation. |
{- "author": null,
- "obj": null,
- "groups": [
- null
], - "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string",
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Post an annotation
associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for an object ID, or an integer for other data types, e.g., a spectrum. |
origin required | string String describing the source of this information. Only one Annotation per origin is allowed, although each Annotation can have multiple fields. To add/change data, use the update method instead of trying to post another Annotation from this origin. Origin must be a non-empty string starting with an alphanumeric character or underscore. (it must match the regex: /^\w+/) |
data required | object |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "origin": "string",
- "data": { },
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "annotation_id": 0
}
}
Delete an annotation
associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for a spectrum. |
annotation_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve an annotation
associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
annotation_id required | integer |
{- "status": "success",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}, - "message": "string"
}
Update an annotation
associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum. |
annotation_id required | integer |
author | any Nullable Annotation's author. |
obj | any Nullable The Annotation's Obj. |
groups | Array of any |
data required | any Searchable data in JSON format |
origin required | string What generated the annotation. This should generally map to a filter/group name. But since an annotation can be made accessible to multiple groups, the origin name does not necessarily have to map to a single group name. The important thing is to make the origin distinct and descriptive such that annotations from the same origin generally have the same metrics. One annotation with multiple fields from each origin is allowed. |
author_id required | integer ID of the Annotation author's User instance. |
obj_id required | string ID of the Annotation's Obj. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the annotation. |
{- "author": null,
- "obj": null,
- "groups": [
- null
], - "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string",
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Delete an annotation
associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for a spectrum. |
annotation_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
retrieve the PhotStat associated with the obj_id.
obj_id required | string object ID to get statistics on |
{- "obj": null,
- "last_update": "2023-07-10T21:32:36Z",
- "last_full_update": "2023-07-10T21:32:36Z",
- "obj_id": "string",
- "num_obs_global": 0,
- "num_obs_per_filter": null,
- "num_det_global": 0,
- "num_det_no_forced_phot_global": 0,
- "num_det_per_filter": null,
- "first_detected_mjd": 0,
- "first_detected_mag": 0,
- "first_detected_filter": "string",
- "last_detected_mjd": 0,
- "last_detected_mag": 0,
- "last_detected_filter": "string",
- "first_detected_no_forced_phot_mjd": 0,
- "first_detected_no_forced_phot_mag": 0,
- "first_detected_no_forced_phot_filter": "string",
- "last_detected_no_forced_phot_mjd": 0,
- "last_detected_no_forced_phot_mag": 0,
- "last_detected_no_forced_phot_filter": "string",
- "recent_obs_mjd": 0,
- "predetection_mjds": null,
- "last_non_detection_mjd": 0,
- "time_to_non_detection": 0,
- "mean_mag_global": 0,
- "mean_mag_per_filter": null,
- "mean_color": null,
- "peak_mjd_global": 0,
- "peak_mjd_per_filter": null,
- "peak_mag_global": 0,
- "peak_mag_per_filter": null,
- "faintest_mag_global": 0,
- "faintest_mag_per_filter": null,
- "deepest_limit_global": 0,
- "deepest_limit_per_filter": null,
- "rise_rate": 0,
- "decay_rate": 0,
- "mag_rms_global": 0,
- "mag_rms_per_filter": null,
- "id": 0
}
create or update the PhotStat associated with the obj_id.
obj_id required | string object ID to get statistics on |
{- "status": "success",
- "message": "string"
}
create a new PhotStat to be associated with the obj_id.
obj_id required | string object ID to get statistics on |
{- "status": "success",
- "message": "string"
}
delete the PhotStat associated with the obj_id.
obj_id required | string object ID to get statistics on |
{- "status": "success",
- "message": "string"
}
find the number of sources with and without a PhotStat object
createdAtStartTime | string arrow parseable string, only objects that have been created after this time will be checked for missing/existing PhotStats. |
createdAtEndTime | string arrow parseable string, only objects that have been created before this time will be checked for missing/existing PhotStats. |
quickUpdateStartTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) after this time will be recalculated. |
quickUpdateEndTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) before this time will be recalculated. |
fullUpdateStartTime | string arrow parseable string, any object's PhotStat that has been fully updated after this time will be counted. |
fullUpdateEndTime | string arrow parseable string, any object's PhotStat that has been fully updated before this time will be counted. |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
calculate photometric stats for a batch of sources without a PhotStat
numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
createdAtStartTime | string arrow parseable string, only objects that have been created after this time will be checked for missing PhotStats. |
createdAtEndTime | string arrow parseable string, only objects that have been created before this time will be checked for missing PhotStats. |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
manually recalculate the photometric stats for a batch of sources
numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
createdAtStartTime | string arrow parseable string, only objects that have been created after this time will be checked for missing/existing PhotStats. |
createdAtEndTime | string arrow parseable string, only objects that have been created before this time will be checked for missing/existing PhotStats. |
quickUpdateStartTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) after this time will be recalculated. |
quickUpdateEndTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) before this time will be recalculated. |
fullUpdateStartTime | string arrow parseable string, any object's PhotStat that has been fully updated after this time will be recalculated. |
fullUpdateEndTime | string arrow parseable string, any object's PhotStat that has been fully updated before this time will be recalculated. |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Retrieve photometry
photometry_id required | integer |
format | string Enum: "mag" "flux" Return the photometry in flux or magnitude space? If a value for this query parameter is not provided, the result will be returned in magnitude space. |
magsys | string Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude or zeropoint system of the output. (Default AB) |
{- "status": "success",
- "data": {
- "dec_unc": null,
- "ra_unc": null,
- "altdata": null,
- "ref_flux": null,
- "alert_id": null,
- "flux": null,
- "zp": 0,
- "filter": "bessellux",
- "mjd": 0,
- "obj_id": "string",
- "assignment_id": null,
- "origin": null,
- "ref_fluxerr": null,
- "fluxerr": 0,
- "instrument_id": 0,
- "dec": null,
- "magsys": "jla1",
- "ra": null,
- "ref_zp": null
}, - "message": "string"
}
{- "status": "success",
- "message": "string"
}
Update photometry
photometry_id required | integer |
dec | number Nullable Default: null ICRS Declination of the centroid of the photometric aperture [deg]. |
dec_unc | number Nullable Default: null Uncertainty on dec [arcsec]. |
filter required | any Enum: "bessellux" "bessellb" "bessellv" "bessellr" "besselli" "standard::u" "standard::b" "standard::v" "standard::r" "standard::i" "desu" "desg" "desr" "desi" "desz" "desy" "sdssu" "sdssg" "sdssr" "sdssi" "sdssz" "f435w" "f475w" "f555w" "f606w" "f625w" "f775w" "f850lp" "nicf110w" "nicf160w" "f098m" "f105w" "f110w" "f125w" "f127m" "f139m" "f140w" "f153m" "f160w" "f218w" "f225w" "f275w" "f300x" "f336w" "f350lp" "f390w" "f689m" "f763m" "f845m" "f438w" "uvf475w" "uvf555w" "uvf606w" "uvf625w" "uvf775w" "uvf814w" "uvf850lp" "kepler" "cspb" "csphs" "csphd" "cspjs" "cspjd" "cspv3009" "cspv3014" "cspv9844" "cspys" "cspyd" "cspg" "cspi" "cspk" "cspr" "cspu" "f070w" "f090w" "f115w" "f150w" "f200w" "f277w" "f356w" "f444w" "f140m" "f162m" "f182m" "f210m" "f250m" "f300m" "f335m" "f360m" "f410m" "f430m" "f460m" "f480m" "f560w" "f770w" "f1000w" "f1130w" "f1280w" "f1500w" "f1800w" "f2100w" "f2550w" "f1065c" "f1140c" "f1550c" "f2300c" "lsstu" "lsstg" "lsstr" "lssti" "lsstz" "lssty" "keplercam::us" "keplercam::b" "keplercam::v" "keplercam::r" "keplercam::i" "4shooter2::us" "4shooter2::b" "4shooter2::v" "4shooter2::r" "4shooter2::i" "f062" "f087" "f106" "f129" "f158" "f184" "f213" "f146" "ztfg" "ztfr" "ztfi" "uvot::b" "uvot::u" "uvot::uvm2" "uvot::uvw1" "uvot::uvw2" "uvot::v" "uvot::white" "ps1::open" "ps1::g" "ps1::r" "ps1::i" "ps1::z" "ps1::y" "ps1::w" "atlasc" "atlaso" "2massj" "2massh" "2massks" "gaia::gbp" "gaia::g" "gaia::grp" "gaia::grvs" "tess" "gotob" "gotog" "gotol" "gotor" The bandpass of the observation. |
mjd required | number MJD of the observation. |
obj_id required | string ID of the Object to which the photometry will be attached. |
assignment_id | integer Nullable Default: null ID of the classical assignment which generated the photometry |
ra_unc | number Nullable Default: null Uncertainty on RA [arcsec]. |
origin | any Nullable Default: null Provenance of the Photometry. If a record is already present with identical origin, only the groups or streams list will be updated (other data assumed identical). Defaults to None. |
alert_id | integer Nullable Default: null Corresponding alert ID. If a record is already present with identical alert ID, only the groups list will be updated (other alert data assumed identical). Defaults to None. |
magerr | number Nullable Default: null Magnitude error of the observation in the magnitude system |
magsys required | any Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude system to which the flux and the zeropoint are tied. |
limiting_mag required | number Limiting magnitude of the image in the magnitude system |
magref | any Nullable Default: null Magnitude of the reference image. in the magnitude system |
ra | number Nullable Default: null ICRS Right Ascension of the centroid of the photometric aperture [deg]. |
altdata | object Nullable Default: null Misc. alternative metadata stored in JSON format, e.g. |
e_magref | any Nullable Default: null Gaussian error on the reference magnitude. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
instrument_id required | integer ID of the instrument with which the observation was carried out. |
mag | number Nullable Default: null Magnitude of the observation in the magnitude system |
{- "dec": null,
- "dec_unc": null,
- "filter": "bessellux",
- "mjd": 0,
- "obj_id": "string",
- "assignment_id": null,
- "ra_unc": null,
- "origin": null,
- "alert_id": null,
- "magerr": null,
- "magsys": "jla1",
- "limiting_mag": 0,
- "magref": null,
- "ra": null,
- "altdata": null,
- "e_magref": null,
- "instrument_id": 0,
- "mag": null
}
{- "status": "success",
- "message": "string"
}
Update and/or upload photometry, resolving potential duplicates
dec_unc | any Nullable Default: null Uncertainty on dec [arcsec]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
ra_unc | any Nullable Default: null Uncertainty on RA [arcsec]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
limiting_mag required | any Limiting magnitude of the image in the magnitude system |
limiting_mag_nsigma | any Default: 3 Number of standard deviations above the background that the limiting magnitudes correspond to. Null values not allowed. Default = 3.0. |
altdata | any Nullable Default: null Misc. alternative metadata stored in JSON format, e.g. |
e_magref | any Nullable Default: null Gaussian error on the reference magnitude. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
stream_ids | any Default: [] List of stream IDs to which photometry points will be visible. |
magerr | any Nullable Default: null Error on the magnitude in the magnitude system |
magref | any Nullable Default: null Magnitude of the reference image. in the magnitude system |
filter required | any The bandpass of the observation(s). Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values not allowed. Allowed values: |
mjd required | any MJD of the observation(s). Can be a given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values not allowed. |
obj_id required | any ID of the |
assignment_id | integer Nullable Default: null ID of the classical assignment which generated the photometry |
origin | any Nullable Default: null Provenance of the Photometry. If a record is already present with identical origin, only the groups or streams list will be updated (other data assumed identical). Defaults to None. |
instrument_id required | any ID of the |
dec | any Nullable Default: null ICRS Declination of the centroid of the photometric aperture [deg]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
group_ids | any Default: [] List of group IDs to which photometry points will be visible. If 'all', will be shared with site-wide public group (visible to all users who can view associated source). |
magsys required | any The magnitude system to which the magnitude, magnitude error, and limiting magnitude are tied. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values not allowed. Allowed values: |
ra | any Nullable Default: null ICRS Right Ascension of the centroid of the photometric aperture [deg]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
mag | any Nullable Default: null Magnitude of the observation in the magnitude system |
{- "dec_unc": null,
- "ra_unc": null,
- "limiting_mag": null,
- "limiting_mag_nsigma": 3,
- "altdata": null,
- "e_magref": null,
- "stream_ids": [ ],
- "magerr": null,
- "magref": null,
- "filter": null,
- "mjd": null,
- "obj_id": null,
- "assignment_id": null,
- "origin": null,
- "instrument_id": null,
- "dec": null,
- "group_ids": [ ],
- "magsys": null,
- "ra": null,
- "mag": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "ids": [
- 0
], - "upload_id": "string"
}
}
Retrieve a photometric series
photometric_series_id required | integer |
dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
{- "status": "success",
- "data": {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}, - "message": "string"
}
Delete a photometric series
photometric_series_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve all photometric series, based on various cuts.
dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
ra | number RA for spatial filtering (in decimal degrees) |
dec | number Declination for spatial filtering (in decimal degrees) |
radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
objectID | string Portion of ID to filter on |
rejectedObjectIDs | str Comma-separated string of object IDs not to be returned, useful in cases where you are looking for new objects passing a query. |
seriesName | string Get series that match this name. The match must be exact. This is useful when getting photometry for multiple objects taken at the same time (e.g., for calibrating against each other). The series name can be, e.g., a TESS sector, or a date/field name identifier. Generally a series name is shared only by data taken over that same time period. |
seriesObjID | string Get only photometry for the objects named by this object id. This is the internal naming used inside each photometric series, i.e., the index used for each source in the images that were used to create the photometric series. Not the same as the SkyPortal object ID. E.g., this could be a TESS TIC ID, or some internal numbering used in the specific field that was observed. |
filter | string Retrieve only series matching this filter, e.g., "ztfg". |
channel | string The channel name/id to filter on. |
origin | string The origin can be anything that gives an idea of the provenance of the photometric series. This can be, e.g., the name of the pipeline that produced the photometry from the images, or the level of calibration, or any other pre-defined string that identifies where the data came from that isn't covered by the other fields (like channel or filter or instrument). |
filename | string Portion of filename to filter on. If the filename is a relative path, will append the data directory from the config file to the beginning of the filename. (by default that is 'persistentdata/phot_series'). |
startBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started before this time. |
startAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started after this time. |
midTimeBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed before this time. |
midTimeAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed after this time. |
endBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended before this time. |
endAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended after this time. |
detected | boolean If true, get only series with one or more detections. If false, get only series with no detections. If left out, do not filter at all on detection status. |
expTime | number Get only series with this exact exposure time (seconds). |
minExpTime | number Get only series with an exposure time above/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
maxExpTime | number Get only series with an exposure time under/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
minFrameRate | number Get only series with a frame rate higher/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
maxFrameRate | number Get only series with a frame rate lower/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
minNumExposures | number Get only series with this many exposures, or more. |
maxNumExposures | number Get only series with this many exposures, or less. |
instrumentID | number get only series taken with this instrument. |
followupRequestID | number get only series taken with this followup request. |
assignmentID | number get only series taken with this assignment. |
ownerID | number get only series uploaded by this user. |
magBrighterThan | number get only series with mean_mag brighter or equal to this value. |
magFainterThan | number get only series with mean_mag fainter or equal to this value. |
limitingMagBrighterThan | number Retrieve only series with limiting mags brighter or equal to this value. |
limitingMagFainterThan | number Retrieve only series with limiting mags fainter or equal to this value. |
limitingMagIsNone | boolean Retrieve only series that do not have limiting mag. |
magrefBrighterThan | number Get only series that have a magref, and that the magref is brighter or equal to this value. |
magrefFainterThan | number Get only series that have a magref, and that the magref is fainter or equal to this value. |
maxRMS | number get only series with rms_mag less than this. |
minRMS | number get only series with rms_mag more than this. |
useRobustMagAndRMS | boolean If true, will use the robust_mag and robust_rms values instead of mean_mag and rms_mag when filtering on mean magnitude or RMS. Does not affect the magref query. |
maxMedianSNR | number Get only series where the median S/N is less than this. The S/N is calculated using the robust RMS. |
minMedianSNR | number Get only series where the median S/N is more than this. The S/N is calculated using the robust RMS. |
maxBestSNR | number Get only series where the maximum S/N is less than this. The S/N is calculated using the robust RMS. |
minBestSNR | number Get only series where the maximum S/N is more than this. The S/N is calculated using the robust RMS. |
maxWorstSNR | number Get only series where the lowest S/N is less than this. The S/N is calculated using the robust RMS. |
minWorstSNR | number Get only series where the lowest S/N is more than this. The S/N is calculated using the robust RMS. |
hash | string Get only a series that matches this file hash. This is useful if you have an HDF5 file downloaded from the SkyPortal backend, and want to associate it with a PhotometrySeries object. We use an MD5 hash of the file contents. |
sortBy | string The field to sort by. Currently allowed options are ["id", "ra", "dec", "redshift", "saved_at"] |
sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "series": [
- {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Delete bulk-uploaded photometry set
upload_id required | string |
{- "status": "success",
- "message": "string"
}
Get photometry taken by specific instruments over a date range
format | string Enum: "mag" "flux" Return the photometry in flux or magnitude space? If a value for this query parameter is not provided, the result will be returned in magnitude space. |
magsys | string Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude or zeropoint system of the output. (Default AB) |
max_date | string <date-time> Nullable Default: null Query for photometry taken before this UT |
instrument_ids | Array of integers Nullable Default: null IDs of the instruments to query for photometry from. If |
min_date | string <date-time> Nullable Default: null Query for photometry taken after this UT |
{- "max_date": null,
- "instrument_ids": null,
- "min_date": null
}
{- "status": "success",
- "data": [
- {
- "dec_unc": null,
- "ra_unc": null,
- "altdata": null,
- "ref_flux": null,
- "alert_id": null,
- "flux": null,
- "zp": 0,
- "filter": "bessellux",
- "mjd": 0,
- "obj_id": "string",
- "assignment_id": null,
- "origin": null,
- "ref_fluxerr": null,
- "fluxerr": 0,
- "instrument_id": 0,
- "dec": null,
- "magsys": "jla1",
- "ra": null,
- "ref_zp": null
}
], - "message": "string"
}
Copy all photometry points from one source to another
target_id required | string The obj_id of the target Source (to which the photometry is being copied to) |
group_ids required | Array of integers List of IDs of groups to give photometry access to |
origin_id required | string The ID of the Source's Obj the photometry is being copied from |
{- "group_ids": [
- 0
], - "origin_id": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all photometry associated with an Object
obj_id required | string ID of the object to retrieve photometry for |
format | string Enum: "mag" "flux" Return the photometry in flux or magnitude space? If a value for this query parameter is not provided, the result will be returned in magnitude space. |
magsys | string Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude or zeropoint system of the output. (Default AB) |
individualOrSeries | string Enum: "individual" "series" "both" Whether to return individual photometry points, photometric series, or both (Default). |
phaseFoldData | boolean Boolean indicating whether to phase fold the light curve. Defaults to false. |
{- "status": "success",
- "data": [
- {
- "dec_unc": null,
- "ra_unc": null,
- "altdata": null,
- "ref_flux": null,
- "alert_id": null,
- "flux": null,
- "zp": 0,
- "filter": "bessellux",
- "mjd": 0,
- "obj_id": "string",
- "assignment_id": null,
- "origin": null,
- "ref_fluxerr": null,
- "fluxerr": 0,
- "instrument_id": 0,
- "dec": null,
- "magsys": "jla1",
- "ra": null,
- "ref_zp": null
}
], - "message": "string"
}
Delete object photometry
obj_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve all annotations associated with specified resource
associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
], - "message": "string"
}
Retrieve an annotation
associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
annotation_id required | integer |
{- "status": "success",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}, - "message": "string"
}
Get observation plan requests of the GcnEvent.
gcnevent_id required | string |
{- "status": "success",
- "data": [
- {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "default_plan": true,
- "id": 0
}
], - "message": "string"
}
Get survey efficiency analyses of the GcnEvent.
gcnevent_id required | string |
{- "status": "success",
- "data": [
- {
- "gcnevent": null,
- "localization": null,
- "instrument": null,
- "requester": null,
- "groups": [
- null
], - "gcnevent_id": 0,
- "localization_id": 0,
- "instrument_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
], - "message": "string"
}
Get catalog queries of the GcnEvent.
gcnevent_id required | string |
{- "status": "success",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "id": 0
}
], - "message": "string"
}
Post a GCN Event alias
dateobs required | string The dateobs of the event, as an arrow parseable string |
alias required | string Alias to add to the event |
{- "alias": "string"
}
{- "status": "success",
- "message": "string"
}
Delete a GCN event alias
dateobs required | dateobs |
alias required | string Alias to remove from the event |
{- "alias": "string"
}
{- "status": "success",
- "message": "string"
}
Ingest GCN xml file
xml | string VOEvent XML content. |
{- "xml": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve a reminder
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" "earthquake" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake" |
resource_id required | string The ID of the source, spectrum, gcn_event or shift that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event |
reminder_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:36Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}, - "message": "string"
}
Post a reminder
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift". |
resource_id required | string The ID of the source or spectrum that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum. |
text required | string |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view reminder. Defaults to all of requesting user's groups. |
{- "text": "string",
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "reminder_id": 0
}
}
Delete a reminder
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift". |
resource_id required | string The ID of the source or spectrum that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event. |
reminder_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a reminder
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift". |
resource_id required | string The ID of the source or spectrum that the reminder is posted to. This would be a string for an object ID or an integer for a spectrum, gcn_event or shift. |
reminder_id required | integer |
obj | any Nullable The Reminder's Obj. |
user | any Nullable Reminder's user. |
groups | Array of any |
obj_id required | string ID of the Reminder's Obj. |
text required | string Reminder body. |
origin | string Nullable Reminder origin. |
bot | boolean Boolean indicating whether reminder was posted via a bot (token-based request). |
next_reminder required | string <date-time> Next reminder. |
reminder_delay required | number Delay until next reminder in days. |
number_of_reminders required | integer Number of remaining requests. |
user_id required | integer ID of the Reminder User instance. |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view reminder. |
{- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:36Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve all reminders associated with specified resource
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:36Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
], - "message": "string"
}
Retrieve all reminders associated with specified resource
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:36Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
], - "message": "string"
}
Scrape data of a GCN Event from GraceDB
dateobs required | string The dateobs of the event, as an arrow parseable string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Scrape aliases of a GCN Event from GCNs notice/circulars
dateobs required | string The dateobs of the event, as an arrow parseable string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Retrieve all reminders associated with specified resource
associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2023-07-10T21:32:36Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
], - "message": "string"
}
Ingest EarthquakeEvent
sent_by | any Nullable The user that saved this EarthquakeEvent |
notices | Array of any |
predictions | Array of any |
measurements | Array of any |
comments | Array of any |
reminders | Array of any |
sent_by_id required | integer The ID of the User who created this GcnTag. |
event_id required | string |
event_uri | string Nullable |
status | string The status of the earthquake event. |
{- "sent_by": null,
- "notices": [
- null
], - "predictions": [
- null
], - "measurements": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "sent_by_id": 0,
- "event_id": "string",
- "event_uri": "string",
- "status": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve a GCN summary
dateobs required | string |
summary_id required | integer |
{- "status": "success",
- "data": {
- "sent_by": null,
- "group": null,
- "sent_by_id": 0,
- "dateobs": "2023-07-10T21:32:36Z",
- "group_id": 0,
- "title": "string",
- "text": "string",
- "id": 0
}, - "message": "string"
}
Delete a GCN summary
summary_id required | integer |
{- "status": "success",
- "message": "string"
}
Get a summary of all the activity of shift users on skyportal for a given period
shift_id required | integer |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string",
- "data": "string"
}
Compute instrument field probabilities for a skymap
dateobs required | string |
Instrument ID required | integer |
localization_name required | string Localization map name |
integrated_probability | float Cumulative integrated probability threshold |
{- "status": "success",
- "message": "string"
}
Ingest GCN xml file
xml | string VOEvent XML content. |
{- "xml": "string"
}
{- "status": "success",
- "message": "string"
}
Create a summary plot for the observability for a given event.
localization_id required | integer ID of localization to generate observability plot for |
maximumAirmass | number Maximum airmass to consider. Defaults to 2.5. |
twilight | string Twilight definition. Choices are astronomical (-18 degrees), nautical (-12 degrees), and civil (-6 degrees). |
{- "status": "success",
- "message": "string"
}
Create a summary plot for the observability for a given event.
localization_id required | integer ID of localization to generate map for |
maximumAirmass | number Maximum airmass to consider. Defaults to 2.5. |
twilight | string Twilight definition. Choices are astronomical (-18 degrees), nautical (-12 degrees), and civil (-6 degrees). |
{- "status": "success",
- "message": "string"
}
Download a GCN localization skymap
dateobs required | string |
localization_name required | string |
{- "localization_name": "string",
- "flat_2d": [
- 0
], - "dateobs": "string",
- "contour": null
}
Retrieve a GCN localization
dateobs required | dateobs |
localization_name required | localization_name |
include2DMap | boolean Boolean indicating whether to include flatted skymap. Defaults to false. |
{- "localization_name": "string",
- "flat_2d": [
- 0
], - "dateobs": "string",
- "contour": null
}
Delete a GCN localization
dateobs required | string |
localization_name required | string |
{- "status": "success",
- "message": "string"
}
A fits file corresponding to the intersection of the input fits files.
dateobs required | dateobs |
localization_name required | localization_name |
{- "status": "error",
- "data": { },
- "message": "string"
}
Post a skymap-based trigger
allocation_id required | integer Followup request allocation ID. |
localization_id required | integer Localization ID. |
integrated_probability | number Integrated probability within skymap. |
{- "allocation_id": 0,
- "localization_id": 0,
- "integrated_probability": 0
}
{- "status": "success",
- "message": "string"
}
Create a summary plot for the observability for a given source.
obj_id required | string ID of object to generate observability plot for |
maximumAirmass | number Maximum airmass to consider. Defaults to 2.5. |
twilight | string Twilight definition. Choices are astronomical (-18 degrees), nautical (-12 degrees), and civil (-6 degrees). |
{- "status": "success",
- "message": "string"
}
Ingest GCN xml file
xml | string VOEvent XML content. |
{- "xml": "string"
}
{- "status": "success",
- "message": "string"
}
Post sources that have been confirmed in a GCN to TNS
dateobs required | string The dateobs of the event, as an arrow parseable string |
tnsrobotID required | int TNS Robot ID. |
reporters | string Reporters for the TNS report. |
archival | boolean Report sources as archival (i.e. no upperlimit). Defaults to False. |
archivalComment | string Comment on archival source. Required if archival is True. |
sourcesIDList | string A comma-separated list of source_id's to post. If not provided, all sources confirmed in GCN will be posted. |
confirmed | boolean Only post sources noted as confirmed / highlighted. Defaults to True. |
{- "tnsrobotID": null,
- "reporters": "string",
- "archival": true,
- "archivalComment": "string",
- "sourcesIDList": "string",
- "confirmed": true
}
{- "status": "success",
- "message": "string"
}
Retrieve sources that have been confirmed/rejected in a GCN
dateobs required | string The dateobs of the event, as an arrow parseable string |
sourcesIDList | string A comma-separated list of source_id's to retrieve. If not provided, all sources confirmed or rejected in GCN will be returned. |
{- "status": "success",
- "message": "string",
- "data": [
- null
]
}
Retrieve a source that has been confirmed or rejected in a GCN
dateobs required | string The dateobs of the event, as an arrow parseable string |
source_id required | string The source_id of the source to retrieve |
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0,
- "obj_id": "string",
- "dateobs": "string",
- "confirmed": true
}
}
Deletes the confirmed or rejected status of source in a GCN. Its status can be considered as 'undefined'.
dateobs required | string |
source_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Update the confirmed or rejected status of a source in a GCN
dateobs required | string |
source_id required | string |
confirmed required | boolean Whether the source is confirmed (True) or rejected (False) |
{- "confirmed": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Retrieve a source that has been confirmed or rejected in a GCN
dateobs required | string The dateobs of the event, as an arrow parseable string |
source_id required | string The source_id of the source to retrieve |
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0,
- "obj_id": "string",
- "dateobs": "string",
- "confirmed": true
}
}
Confirm or reject a source in a gcn
dateobs required | string The dateobs of the event, as an arrow parseable string |
localization_name required | string The name of the localization of the event |
localization_cumprob required | string The cumprob of the localization of the event |
source_id required | string The source_id of the source to confirm or reject |
confirmed required | boolean Whether the source is confirmed (True) or rejected (False) |
start_date required | string Choose sources with a first detection after start_date, as an arrow parseable string |
end_date required | string Choose sources with a last detection before end_date, as an arrow parseable string |
{- "localization_name": "string",
- "localization_cumprob": "string",
- "source_id": "string",
- "confirmed": true,
- "start_date": "string",
- "end_date": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Deletes the confirmed or rejected status of source in a GCN. Its status can be considered as 'undefined'.
dateobs required | string |
source_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Update the confirmed or rejected status of a source in a GCN
dateobs required | string |
source_id required | string |
confirmed required | boolean Whether the source is confirmed (True) or rejected (False) |
{- "confirmed": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Get the GCNs associated with a source (GCNs for which the source has been confirmed)
source_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "gcns": [
- "string"
]
}
}
Get an airmass chart for the GcnEvent
localization_id required | integer ID of localization to generate airmass chart for |
telescope_id required | integer ID of telescope to generate airmass chart for |
{- "status": "success",
- "message": "string"
}
Submit the executed observations to treasuremap.space
instrument_id required | string ID for the instrument to submit |
startDate required | string Filter by start date |
endDate required | string Filter by end date |
localizationDateobs | string Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
numberObservations | number Minimum number of observations of a field required to include. Defaults to 1. |
{- "status": "success",
- "message": "string"
}
Submit manual observation plan.
target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
gcnevent_id required | integer ID of the GcnEvent. |
localization_id required | integer Localization ID. |
status | string Default: "pending submission" The status of the request. |
observation_plan_data | any Observation plan data json |
allocation_id required | integer Observation plan request allocation ID. |
{- "target_group_ids": [
- 0
], - "gcnevent_id": 0,
- "localization_id": 0,
- "status": "pending submission",
- "observation_plan_data": null,
- "allocation_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Submit observation plan request.
target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
gcnevent_id required | integer ID of the GcnEvent. |
localization_id required | integer Localization ID. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Observation plan request allocation ID. |
payload | any Content of the observation plan request. |
{- "target_group_ids": [
- 0
], - "gcnevent_id": 0,
- "localization_id": 0,
- "status": "pending submission",
- "allocation_id": 0,
- "payload": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Delete observation plan.
observation_plan_id required | string |
{- "status": "success",
- "message": "string"
}
Submit the observation plan to treasuremap.space
observation_plan_id required | string |
{- "status": "success",
- "message": "string"
}
Get a GCN-izable summary of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "default_plan": true,
- "id": 0
}, - "message": "string"
}
Submit an observation plan.
observation_plan_id required | string |
{- "status": "success",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "default_plan": true,
- "id": 0
}, - "message": "string"
}
Remove an observation plan from the queue.
observation_plan_id required | string |
{- "status": "success",
- "message": "string"
}
Get a movie summary of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "default_plan": true,
- "id": 0
}, - "message": "string"
}
Perform an efficiency analysis of the observation plan.
observation_plan_id required | string |
numberInjections | number Number of simulations to evaluate efficiency with. Defaults to 1000. |
numberDetections | number Number of detections required for detection. Defaults to 1. |
detectionThreshold | number Threshold (in sigmas) required for detection. Defaults to 5. |
minimumPhase | number Minimum phase (in days) post event time to consider detections. Defaults to 0. |
maximumPhase | number Maximum phase (in days) post event time to consider detections. Defaults to 3. |
model_name | string Model to simulate efficiency for. Must be one of kilonova, afterglow, or linear. Defaults to kilonova. |
optionalInjectionParameters | any |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the analyses. Defaults to all of requesting user's groups. |
{- "status": "success",
- "message": "string"
}
Get GeoJSON summary of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "default_plan": true,
- "id": 0
}, - "message": "string"
}
Get survey efficiency analyses of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "data": [
- {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
], - "message": "string"
}
Submit the fields in the observation plan to an observing run
observation_plan_id required | integer ID of observation plan request to create observing run for |
{- "status": "success",
- "message": "string"
}
Delete selected fields from the observation plan.
observation_plan_id required | string |
fieldIds | Array of integers List of field IDs to remove from the plan |
{- "fieldIds": [
- 0
]
}
{- "status": "success",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "default_plan": true,
- "id": 0
}, - "message": "string"
}
{- "status": "success",
- "data": {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}, - "message": "string"
}
Add alert stream access to group
group_id required | integer |
stream_id required | integer |
{- "stream_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "stream_id": 0
}
}
Delete an alert stream from group
group_id required | integer |
stream_id required | integer |
{- "status": "success",
- "message": "string"
}
Add a group user
group_id required | integer |
userID required | integer |
admin required | boolean |
canSave | boolean Boolean indicating whether user can save sources to group. Defaults to true. |
{- "userID": 0,
- "admin": true,
- "canSave": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "user_id": 0,
- "admin": true
}
}
Update a group user's admin or save access status
group_id required | integer |
userID required | integer |
admin | boolean Boolean indicating whether user is group admin. Either this
or |
canSave | boolean Boolean indicating whether user can save sources to group. Either
this or |
{- "userID": 0,
- "admin": true,
- "canSave": true
}
{- "status": "success",
- "message": "string"
}
Delete a group user
group_id required | integer |
user_id required | integer |
{- "status": "success",
- "message": "string"
}
Add users from other group(s) to specified group
group_id required | integer |
fromGroupIDs required | boolean |
{- "fromGroupIDs": true
}
{- "status": "success",
- "message": "string"
}
Retrieve a group
group_id required | integer |
includeGroupUsers | boolean Boolean indicating whether to include group users. Defaults to true. |
{- "status": "success",
- "message": "string",
- "data": {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "expiration_date": "2023-07-10T21:32:37Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "comments_on_gcns": [
- null
], - "reminders_on_gcns": [
- null
], - "comments_on_earthquakes": [
- null
], - "reminders_on_earthquakes": [
- null
], - "default_observationplan_requests": [
- null
], - "default_gcntags": [
- null
], - "catalog_queries": [
- null
], - "comments_on_shifts": [
- null
], - "reminders_on_shifts": [
- null
], - "followup_requests": [
- null
], - "default_followup_requests": [
- null
], - "observationplan_requests": [
- null
], - "survey_efficiency_for_observations": [
- null
], - "survey_efficiency_for_observation_plan": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "assignments": [
- null
], - "recurring_apis": [
- null
], - "gcnevents": [
- null
], - "gcnnotices": [
- null
], - "gcnsummaries": [
- null
], - "gcntags": [
- null
], - "gcnproperties": [
- null
], - "earthquakeevents": [
- null
], - "earthquakenotices": [
- null
], - "listings": [
- null
], - "localizations": [
- null
], - "localizationtags": [
- null
], - "localizationproperties": [
- null
], - "notifications": [
- null
], - "observing_runs": [
- null
], - "sources_in_gcn": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
}
Update a group
group_id required | integer |
streams | Array of any |
filters | Array of any |
shifts | Array of any |
users | Array of any |
group_users | Array of any |
observing_runs | Array of any |
photometry | Array of any |
photometric_series | Array of any |
spectra | Array of any |
mmadetector_spectra | Array of any |
mmadetector_time_intervals | Array of any |
allocations | Array of any |
source_labels | Array of any |
admission_requests | Array of any |
tnsrobots | Array of any |
gcnsummaries | Array of any |
name required | string Name of the group. |
nickname | string Nullable Short group nickname. |
description | string Nullable Longer description of the group. |
private | boolean Boolean indicating whether group is invisible to non-members. |
single_user_group | boolean Nullable Flag indicating whether this group is a singleton group for one user only. |
{- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true
}
{- "status": "success",
- "message": "string"
}
Retrieve all groups
name | string Fetch by name (exact match) |
includeSingleUserGroups | boolean Bool indicating whether to include single user groups. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "user_groups": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
], - "user_accessible_groups": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
], - "all_groups": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
]
}
}
Create a new group
streams | Array of any |
filters | Array of any |
shifts | Array of any |
users | Array of any |
group_users | Array of any |
observing_runs | Array of any |
photometry | Array of any |
photometric_series | Array of any |
spectra | Array of any |
mmadetector_spectra | Array of any |
mmadetector_time_intervals | Array of any |
allocations | Array of any |
source_labels | Array of any |
admission_requests | Array of any |
tnsrobots | Array of any |
gcnsummaries | Array of any |
name required | string Name of the group. |
nickname | string Nullable Short group nickname. |
description | string Nullable Longer description of the group. |
private | boolean Boolean indicating whether group is invisible to non-members. |
single_user_group | boolean Nullable Flag indicating whether this group is a singleton group for one user only. |
group_admins | Array of integers List of IDs of users to be group admins. Current user will automatically be added as a group admin. |
{- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "group_admins": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a group admission request
admission_request_id required | integer |
{- "status": "success",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}, - "message": "string"
}
Delete a group admission request
admission_request_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a group admission request's status
admission_request_id required | integer |
status required | string One of either 'accepted', 'declined', or 'pending'. |
{- "status": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all group admission requests
groupID | integer ID of group for which admission requests are desired |
{- "status": "success",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
], - "message": "string"
}
Create a new group admission request
groupID required | integer |
userID required | integer |
{- "groupID": 0,
- "userID": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve basic info on Groups that an Obj is saved to
obj_id required | integer |
{- "status": "success",
- "data": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
], - "message": "string"
}
Save or request group(s) to save source, and optionally unsave from group(s).
objId required | string ID of the object in question. |
inviteGroupIds required | Array of integers List of group IDs to save or invite to save specified source. |
unsaveGroupIds | Array of integers List of group IDs from which specified source is to be unsaved. |
{- "objId": "string",
- "inviteGroupIds": [
- 0
], - "unsaveGroupIds": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Update a Source table row
obj_id required | integer |
groupID required | integer |
active required | boolean |
requested required | boolean |
{- "groupID": 0,
- "active": true,
- "requested": true
}
{- "status": "success",
- "message": "string"
}
Add alert stream access to group
group_id required | integer |
stream_id required | integer |
{- "stream_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "stream_id": 0
}
}
Delete an alert stream from group
group_id required | integer |
stream_id required | integer |
{- "status": "success",
- "message": "string"
}
Grant stream access to a user
stream_id required | integer |
user_id required | integer |
{- "user_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "stream_id": 0,
- "user_id": 0
}
}
Delete a stream user (revoke stream access for user)
stream_id required | integer |
user_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": {
- "groups": [
- null
], - "users": [
- null
], - "filters": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "name": "string",
- "altdata": null,
- "id": 0
}, - "message": "string"
}
Update a stream
stream_id required | integer |
name | string |
altdata | object |
{- "name": "string",
- "altdata": { }
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "groups": [
- null
], - "users": [
- null
], - "filters": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "name": "string",
- "altdata": null,
- "id": 0
}
], - "message": "string"
}
POST a new stream.
name required | string |
altdata | object |
{- "name": "string",
- "altdata": { }
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Add a group user
group_id required | integer |
userID required | integer |
admin required | boolean |
canSave | boolean Boolean indicating whether user can save sources to group. Defaults to true. |
{- "userID": 0,
- "admin": true,
- "canSave": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "user_id": 0,
- "admin": true
}
}
Update a group user's admin or save access status
group_id required | integer |
userID required | integer |
admin | boolean Boolean indicating whether user is group admin. Either this
or |
canSave | boolean Boolean indicating whether user can save sources to group. Either
this or |
{- "userID": 0,
- "admin": true,
- "canSave": true
}
{- "status": "success",
- "message": "string"
}
Delete a group user
group_id required | integer |
user_id required | integer |
{- "status": "success",
- "message": "string"
}
Add users from other group(s) to specified group
group_id required | integer |
fromGroupIDs required | boolean |
{- "fromGroupIDs": true
}
{- "status": "success",
- "message": "string"
}
Retrieve a group admission request
admission_request_id required | integer |
{- "status": "success",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}, - "message": "string"
}
Delete a group admission request
admission_request_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a group admission request's status
admission_request_id required | integer |
status required | string One of either 'accepted', 'declined', or 'pending'. |
{- "status": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all group admission requests
groupID | integer ID of group for which admission requests are desired |
{- "status": "success",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
], - "message": "string"
}
Create a new group admission request
groupID required | integer |
userID required | integer |
{- "groupID": 0,
- "userID": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Get a summary of all the activity of shift users on skyportal for a given period
shift_id required | integer |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}
Add a shift user
shift_id required | integer |
userID required | integer |
admin required | boolean |
{- "userID": 0,
- "admin": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "shift_id": 0,
- "user_id": 0,
- "admin": true,
- "needs_replacement": true
}
}
Delete a shift user
shift_id required | integer |
user_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a shift user's admin status, or needs_replacement status
shift_id required | integer |
userID required | integer |
admin | boolean Boolean indicating whether user is shift admin. |
needs_replacement | boolean Boolean indicating whether user needs replacement or not |
{- "userID": 0,
- "admin": true,
- "needs_replacement": true
}
{- "status": "success",
- "message": "string"
}
Grant stream access to a user
stream_id required | integer |
user_id required | integer |
{- "user_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "stream_id": 0,
- "user_id": 0
}
}
Delete a stream user (revoke stream access for user)
stream_id required | integer |
user_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "expiration_date": "2023-07-10T21:32:37Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "comments_on_gcns": [
- null
], - "reminders_on_gcns": [
- null
], - "comments_on_earthquakes": [
- null
], - "reminders_on_earthquakes": [
- null
], - "default_observationplan_requests": [
- null
], - "default_gcntags": [
- null
], - "catalog_queries": [
- null
], - "comments_on_shifts": [
- null
], - "reminders_on_shifts": [
- null
], - "followup_requests": [
- null
], - "default_followup_requests": [
- null
], - "observationplan_requests": [
- null
], - "survey_efficiency_for_observations": [
- null
], - "survey_efficiency_for_observation_plan": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "assignments": [
- null
], - "recurring_apis": [
- null
], - "gcnevents": [
- null
], - "gcnnotices": [
- null
], - "gcnsummaries": [
- null
], - "gcntags": [
- null
], - "gcnproperties": [
- null
], - "earthquakeevents": [
- null
], - "earthquakenotices": [
- null
], - "listings": [
- null
], - "localizations": [
- null
], - "localizationtags": [
- null
], - "localizationproperties": [
- null
], - "notifications": [
- null
], - "observing_runs": [
- null
], - "sources_in_gcn": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}, - "message": "string"
}
Update a User record
user_id required | integer |
expirationDate | string Arrow-parseable date string (e.g. 2020-01-01). Set a user's expiration date, after which the user's account will be deactivated and will be unable to access the application. |
{- "expirationDate": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all users
numPerPage | integer Number of candidates to return per paginated request. Defaults to all users |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
firstName | string Get users whose first name contains this string. |
lastName | string Get users whose last name contains this string. |
username | string Get users whose username contains this string. |
string Get users whose email contains this string. | |
role | string Get users with the role. |
acl | string Get users with this ACL. |
group | string Get users part of the group with name given by this parameter. |
stream | string Get users with access to the stream with name given by this parameter. |
{- "status": "success",
- "message": "string",
- "data": {
- "users": [
- {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "expiration_date": "2023-07-10T21:32:37Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "comments_on_gcns": [
- null
], - "reminders_on_gcns": [
- null
], - "comments_on_earthquakes": [
- null
], - "reminders_on_earthquakes": [
- null
], - "default_observationplan_requests": [
- null
], - "default_gcntags": [
- null
], - "catalog_queries": [
- null
], - "comments_on_shifts": [
- null
], - "reminders_on_shifts": [
- null
], - "followup_requests": [
- null
], - "default_followup_requests": [
- null
], - "observationplan_requests": [
- null
], - "survey_efficiency_for_observations": [
- null
], - "survey_efficiency_for_observation_plan": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "assignments": [
- null
], - "recurring_apis": [
- null
], - "gcnevents": [
- null
], - "gcnnotices": [
- null
], - "gcnsummaries": [
- null
], - "gcntags": [
- null
], - "gcnproperties": [
- null
], - "earthquakeevents": [
- null
], - "earthquakenotices": [
- null
], - "listings": [
- null
], - "localizations": [
- null
], - "localizationtags": [
- null
], - "localizationproperties": [
- null
], - "notifications": [
- null
], - "observing_runs": [
- null
], - "sources_in_gcn": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}
], - "totalMatches": 0
}
}
Add a new user
username required | string |
first_name | string |
last_name | string |
affiliations | Array of strings |
contact_email | string |
oauth_uid | string |
contact_phone | string |
roles | Array of strings List of user roles. Defaults to |
groupIDsAndAdmin | Array of arrays Array of 2-element arrays |
{- "username": "string",
- "first_name": "string",
- "last_name": "string",
- "affiliations": [
- "string"
], - "contact_email": "string",
- "oauth_uid": "string",
- "contact_phone": "string",
- "roles": [
- "string"
], - "groupIDsAndAdmin": [
- [ ]
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a Multimessenger Astronomical Detector (MMADetector)
mmadetector_id required | integer |
{- "status": "success",
- "data": {
- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true,
- "id": 0
}, - "message": "string"
}
Delete a Multimessenger Astronomical Detector (MMADetector)
mmadetector_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a Multimessenger Astronomical Detector (MMADetector)
mmadetector_id required | integer |
events | Array of any |
spectra | Array of any |
time_intervals | Array of any |
name required | string Unabbreviated facility name (e.g., LIGO Hanford Observatory. |
nickname required | string Abbreviated facility name (e.g., H1). |
type required | string <= 18 characters Enum: "gravitational-wave" "neutrino" "gamma-ray-burst" MMA detector type, one of gravitational wave, neutrino, or gamma-ray burst. |
lat | number Nullable Latitude in deg. |
lon | number Nullable Longitude in deg. |
elevation | number Nullable Elevation in meters. |
fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true
}
{- "status": "success",
- "message": "string"
}
Retrieve all Multimessenger Astronomical Detectors (MMADetectors)
name | string Filter by name |
{- "status": "success",
- "data": [
- {
- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true,
- "id": 0
}
], - "message": "string"
}
Create a Multimessenger Astronomical Detector (MMADetector)
events | Array of any |
spectra | Array of any |
time_intervals | Array of any |
name required | string Unabbreviated facility name (e.g., LIGO Hanford Observatory. |
nickname required | string Abbreviated facility name (e.g., H1). |
type required | string <= 18 characters Enum: "gravitational-wave" "neutrino" "gamma-ray-burst" MMA detector type, one of gravitational wave, neutrino, or gamma-ray burst. |
lat | number Nullable Latitude in deg. |
lon | number Nullable Longitude in deg. |
elevation | number Nullable Elevation in meters. |
fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve an mmadetector spectrum
spectrum_id required | integer |
{- "status": "success",
- "data": {
- "detector": null,
- "groups": [
- null
], - "owner": null,
- "frequencies": [
- 0
], - "amplitudes": [
- 0
], - "start_time": "2023-07-10T21:32:37Z",
- "end_time": "2023-07-10T21:32:37Z",
- "detector_id": 0,
- "owner_id": 0,
- "original_file_string": "string",
- "original_file_filename": "string",
- "id": 0
}, - "message": "string"
}
Delete an mmadetector spectrum
spectrum_id required | integer |
{- "status": "success",
- "message": "string"
}
Update mmadetector spectrum
spectrum_id required | integer |
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
start_time required | string <date-time> The ISO UTC start time the spectrum was taken. |
end_time required | string <date-time> The ISO UTC end time the spectrum was taken. |
detector_id required | integer ID of the MMADetector that acquired the Spectrum. |
amplitudes required | Array of numbers Amplitude of the Spectrum [1/sqrt(Hz). |
frequencies required | Array of numbers Frequencies of the spectrum [Hz]. |
{- "group_ids": [ ],
- "start_time": "2023-07-10T21:32:37Z",
- "end_time": "2023-07-10T21:32:37Z",
- "detector_id": 0,
- "amplitudes": [
- 0
], - "frequencies": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve multiple spectra with given criteria
observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed before this time. |
observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed after this time. |
detectorIDs | any If provided, filter only spectra observed with one of these mmadetector IDs. |
groupIDs | list If provided, filter only spectra saved to one of these group IDs. |
Upload a Multimessenger Astronomical Detector (MMADetector) spectrum
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
start_time required | string <date-time> The ISO UTC start time the spectrum was taken. |
end_time required | string <date-time> The ISO UTC end time the spectrum was taken. |
detector_id required | integer ID of the MMADetector that acquired the Spectrum. |
amplitudes required | Array of numbers Amplitude of the Spectrum [1/sqrt(Hz). |
frequencies required | Array of numbers Frequencies of the spectrum [Hz]. |
{- "group_ids": [ ],
- "start_time": "2023-07-10T21:32:37Z",
- "end_time": "2023-07-10T21:32:37Z",
- "detector_id": 0,
- "amplitudes": [
- 0
], - "frequencies": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve an mmadetector time_interval
time_interval_id required | integer |
{- "status": "success",
- "data": {
- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0,
- "owner_id": 0,
- "id": 0
}, - "message": "string"
}
Delete an mmadetector time_interval
time_interval_id required | integer |
{- "status": "success",
- "message": "string"
}
Update mmadetector time_interval
time_interval_id required | integer |
detector | any Nullable The MMADetector that acquired the Time Interval. |
groups | Array of any |
owner | any Nullable The User who uploaded the detector time interval. |
detector_id required | integer ID of the MMADetector that acquired the Time Interval. |
{- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0
}
{- "status": "success",
- "message": "string"
}
Retrieve multiple time_intervals with given criteria
observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only time_interval observed before this time. |
observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only time_interval observed after this time. |
detectorIDs | any If provided, filter only time_intervals observed with one of these mmadetector IDs. |
groupIDs | list If provided, filter only time_interval saved to one of these group IDs. |
Upload a Multimessenger Astronomical Detector (MMADetector) time_interval(s)
detector | any Nullable The MMADetector that acquired the Time Interval. |
groups | Array of any |
owner | any Nullable The User who uploaded the detector time interval. |
detector_id required | integer ID of the MMADetector that acquired the Time Interval. |
{- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve sources from a user's lists
user_id required | string |
listName | string name of the list to retrieve objects from. If not given will return all objects saved by the user to all lists. |
{- "status": "success",
- "data": [
- {
- "user": null,
- "obj": null,
- "user_id": 0,
- "obj_id": "string",
- "list_name": "string",
- "params": null,
- "id": 0
}
], - "message": "string"
}
Add a listing.
user_id | integer ID of user that you want to add the listing to. If not given, will default to the associated user object that is posting. |
obj_id | string |
list_name | string Listing name for this item, e.g., "favorites". Multiple objects can be saved by the same user to different lists, where the list names are user-defined. List name must be a non-empty string starting with an alphanumeric character or underscore. (it must match the regex: /^\w+/) |
params | object Optional parameters for "watchlist" type listings, when searching for new candidates around a given object. For example, if you want to search for new candidates around a given object, you can specify the search radius and the number of candidates to return. The parameters are passed to the microservice that is responsible for processing the listing. The microservice will return a list of candidates that match the given parameters, and ingest them. |
{- "user_id": 0,
- "obj_id": "string",
- "list_name": "string",
- "params": { }
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Remove an existing listing
listing_id required | integer ID of the listing object. If not given, must supply the listing's obj_id and list_name (and user_id) to find the correct listing id from that info. |
user_id | integer ID of user that you want to add the listing to. If not given, will default to the associated user object that is posting. |
obj_id | string |
list_name | string Listing name for this item, e.g., "favorites". |
{- "user_id": 0,
- "obj_id": "string",
- "list_name": "string"
}
{- "status": "success",
- "message": "string"
}
Update an existing listing
listing_id required | integer |
user_id | integer |
obj_id | string |
list_name | string Listing name for this item, e.g., "favorites". Multiple objects can be saved by the same user to different lists, where the list names are user-defined. List name must be a non-empty string starting with an alphanumeric character or underscore. (it must match the regex: /^\w+/) |
{- "user_id": 0,
- "obj_id": "string",
- "list_name": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve a group admission request
admission_request_id required | integer |
{- "status": "success",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}, - "message": "string"
}
Delete a group admission request
admission_request_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a group admission request's status
admission_request_id required | integer |
status required | string One of either 'accepted', 'declined', or 'pending'. |
{- "status": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all group admission requests
groupID | integer ID of group for which admission requests are desired |
{- "status": "success",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
], - "message": "string"
}
Create a new group admission request
groupID required | integer |
userID required | integer |
{- "groupID": 0,
- "userID": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Add log messages from an instrument
instrument_id required | integer The instrument ID to post logs for |
start_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
end_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
logs required | object Nested JSON containing the log messages. |
{- "start_date": "string",
- "end_date": "string",
- "logs": { }
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Retrieve queued observations from external API
allocation_id required | string ID for the allocation to retrieve |
startDate required | string Arrow-parseable date string (e.g. 2020-01-01). Defaults to now. |
endDate required | string Arrow-parseable date string (e.g. 2020-01-01). Defaults to 72 hours ago. |
{- "status": "success",
- "message": "string"
}
Retrieve all observations
telescopeName | string Filter by telescope name |
instrumentName | string Filter by instrument name |
startDate required | string Filter by start date |
endDate required | string Filter by end date |
localizationDateobs | string Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
returnStatistics | boolean Boolean indicating whether to include integrated probability and area. Defaults to false. |
statsMethod | string Method to use for computing integrated probability and area. Defaults to 'python'. To use the database/postgres based method, use 'db'. |
statsLogging | boolean Boolean indicating whether to log the stats computation time. Defaults to false. |
includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
observationStatus | str Whether to include queued or executed observations. Defaults to executed. |
numberObservations | number Minimum number of observations of a field required to include. Defaults to 1. |
numPerPage | integer Number of followup requests to return per paginated request. Defaults to 100. Can be no larger than {MAX_OBSERVATIONS}. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
sortBy | string The field to sort by. |
sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
{- "status": "success",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2023-07-10T21:32:37Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
], - "message": "string"
}
Ingest a set of ExecutedObservations
instrumentName required | string The instrument name associated with the fields |
observationData | any Observation data dictionary list |
telescopeName required | string The telescope name associated with the fields |
{- "instrumentName": "string",
- "observationData": null,
- "telescopeName": "string"
}
{- "status": "success",
- "message": "string"
}
Delete an observation
observation_id required | integer |
{- "status": "success",
- "message": "string"
}
Upload observation from ASCII file
instrumentID required | string The instrument ID associated with the fields |
observationData | any Observation data Ascii string |
{- "instrumentID": "string",
- "observationData": null
}
{- "status": "success",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2023-07-10T21:32:37Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
], - "message": "string"
}
Perform simsurvey efficiency calculation
instrument_id required | string ID for the instrument to submit |
startDate required | string Filter by start date |
endDate required | string Filter by end date |
localizationDateobs required | string Event time in ISO 8601 format ( |
localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
numberInjections | number Number of simulations to evaluate efficiency with. Defaults to 1000. |
numberDetections | number Number of detections required for detection. Defaults to 1. |
detectionThreshold | number Threshold (in sigmas) required for detection. Defaults to 5. |
minimumPhase | number Minimum phase (in days) post event time to consider detections. Defaults to 0. |
maximumPhase | number Maximum phase (in days) post event time to consider detections. Defaults to 3. |
model_name | string Model to simulate efficiency for. Must be one of kilonova, afterglow, or linear. Defaults to kilonova. |
optionalInjectionParameters | any |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the analyses. Defaults to all of requesting user's groups. |
{- "status": "success",
- "message": "string"
}
Retrieve queued observations from external API
allocation_id required | string ID for the allocation to retrieve |
startDate | string Filter by start date |
endDate | string Filter by end date |
queuesOnly | bool Return queue only (do not commit observations) |
{- "status": "success",
- "data": [
- {
- "observation_plan": null,
- "instrument": null,
- "field": null,
- "observation_plan_id": 0,
- "instrument_id": 0,
- "dateobs": "2023-07-10T21:32:37Z",
- "field_id": 0,
- "exposure_time": 0,
- "weight": 0,
- "filt": "string",
- "obstime": "2023-07-10T21:32:37Z",
- "overhead_per_exposure": 0,
- "planned_observation_id": 0,
- "id": 0
}
], - "message": "string"
}
Retrieve queued observations from external API
allocation_id required | string ID for the allocation to delete queue |
queueName required | string Queue name to remove |
{- "status": "success",
- "message": "string"
}
Retrieve observations from external API
allocation_id required | integer Followup request allocation ID. |
start_date required | any start date of the request. |
end_date required | any end date of the request. |
{- "allocation_id": 0,
- "start_date": null,
- "end_date": null
}
{- "status": "success",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2023-07-10T21:32:37Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
], - "message": "string"
}
Retrieve skymap-based trigger from external API
allocation_id required | string ID for the allocation to retrieve |
{- "status": "success",
- "data": [
- {
- "observation_plan": null,
- "instrument": null,
- "field": null,
- "observation_plan_id": 0,
- "instrument_id": 0,
- "dateobs": "2023-07-10T21:32:37Z",
- "field_id": 0,
- "exposure_time": 0,
- "weight": 0,
- "filt": "string",
- "obstime": "2023-07-10T21:32:37Z",
- "overhead_per_exposure": 0,
- "planned_observation_id": 0,
- "id": 0
}
], - "message": "string"
}
Delete skymap-based trigger from external API
allocation_id required | string ID for the allocation to delete queue |
queueName required | string Queue name to remove |
{- "status": "success",
- "message": "string"
}
Retrieve invitations
includeUsed | boolean Bool indicating whether to include used invitations. Defaults to false. |
numPerPage | integer Number of candidates to return per paginated request. Defaults to 25 |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
string Get invitations whose email contains this string. | |
group | string Get invitations part of the group with name given by this parameter. |
stream | string Get invitations with access to the stream with name given by this parameter. |
invitedBy | string Get invitations invited by users whose username contains this string. |
{- "status": "success",
- "message": "string",
- "data": {
- "invitations": [
- {
- "role": null,
- "groups": [
- null
], - "streams": [
- null
], - "invited_by": null,
- "token": "string",
- "role_id": "string",
- "admin_for_groups": [
- true
], - "can_save_to_groups": [
- true
], - "user_email": "string",
- "used": true,
- "user_expiration_date": "2023-07-10T21:32:37Z",
- "id": 0
}
], - "totalMatches": 0
}
}
Invite a new user
userEmail required | string |
role | string The role the new user will have in the system. If provided, must be one of either "Full user" or "View only". Defaults to "Full user". |
streamIDs | Array of integers List of IDs of streams invited user will be given access to. If
not provided, user will be granted access to all streams associated
with the groups specified by |
groupIDs required | Array of integers List of IDs of groups invited user will be added to. If |
groupAdmin | Array of booleans List of booleans indicating whether user should be granted admin status for respective specified group(s). Defaults to all false. |
canSave | Array of booleans List of booleans indicating whether user should be able to save sources to respective specified group(s). Defaults to all true. |
userExpirationDate | string Arrow-parseable date string (e.g. 2020-01-01). Set a user's expiration date, after which the user's account will be deactivated and will be unable to access the application. |
{- "userEmail": "string",
- "role": "string",
- "streamIDs": [
- 0
], - "groupIDs": [
- 0
], - "groupAdmin": [
- true
], - "canSave": [
- true
], - "userExpirationDate": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": "string"
}
}
Delete an invitation
invitation_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a pending invitation
groupIDs | Array of integers |
streamIDs | Array of integers |
role | string |
userExpirationDate | string Arrow-parseable date string (e.g. 2020-01-01). Set a user's expiration date, after which the user's account will be deactivated and will be unable to access the application. |
{- "groupIDs": [
- 0
], - "streamIDs": [
- 0
], - "role": "string",
- "userExpirationDate": "string"
}
{- "status": "success",
- "message": "string"
}
Create a summary plot for a simsurvey efficiency calculation.
survey_efficiency_analysis_id required | string |
{- "status": "success",
- "message": "string"
}
Create a summary plot for a simsurvey efficiency calculation.
survey_efficiency_analysis_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve an observation efficiency analysis
survey_efficiency_analysis_id required | integer |
{- "status": "success",
- "data": {
- "gcnevent": null,
- "localization": null,
- "instrument": null,
- "requester": null,
- "groups": [
- null
], - "gcnevent_id": 0,
- "localization_id": 0,
- "instrument_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}, - "message": "string"
}
Remove observations from treasuremap.space.
instrument_id required | string ID for the instrument to submit |
localizationDateobs | string Event time in ISO 8601 format ( |
{- "status": "success",
- "message": "string"
}
Remove observation plan from treasuremap.space.
observation_plan_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve an observing run
run_id required | integer |
{- "status": "success",
- "data": {
- "calendar_date": "2023-07-10",
- "assignments": [
- null
], - "instrument": null,
- "ephemeris": null,
- "pi": "string",
- "owner_id": 0,
- "observers": "string",
- "group_id": 0,
- "instrument_id": 0,
- "id": 0
}, - "message": "string"
}
Update observing run
run_id required | integer |
calendar_date required | string <date> The local calendar date of the run. |
pi | string The PI of the observing run. |
observers | string The names of the observers |
group_id | integer The ID of the group this run is associated with. |
instrument_id required | integer The ID of the instrument to be used in this run. |
{- "calendar_date": "2023-07-10",
- "pi": "string",
- "observers": "string",
- "group_id": 0,
- "instrument_id": 0
}
{- "status": "success",
- "message": "string"
}
Delete an observing run
run_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "instrument": null,
- "sources": [
- null
], - "group": null,
- "owner": null,
- "assignments": [
- null
], - "instrument_id": 0,
- "pi": "string",
- "observers": "string",
- "group_id": 0,
- "owner_id": 0,
- "calendar_date": "2023-07-10",
- "id": 0
}
], - "message": "string"
}
Add a new observing run
calendar_date required | string <date> The local calendar date of the run. |
pi | string The PI of the observing run. |
observers | string The names of the observers |
group_id | integer The ID of the group this run is associated with. |
instrument_id required | integer The ID of the instrument to be used in this run. |
{- "calendar_date": "2023-07-10",
- "pi": "string",
- "observers": "string",
- "group_id": 0,
- "instrument_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Set an object's host galaxy
obj_id required | string |
galaxyName required | string Name of the galaxy to associate with the object |
{- "galaxyName": "string"
}
{- "status": "success",
- "message": "string"
}
Delete an object's host galaxy
obj_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve an object's in-out critera for GcnEvents
obj_id required | string |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by GcnEvent.dateobs >= startDate. |
endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by GcnEvent.dateobs <= startDate. |
{- "startDate": "string",
- "endDate": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve an object's status from Minor Planet Center
obj_id required | string |
obscode | string Minor planet center observatory code. Defaults to 500, corresponds to geocentric. |
date | string Time to check MPC for. Defaults to current time. |
limiting_magnitude | float Limiting magnitude down which to search. Defaults to 24.0. |
search_radius | float Search radius for MPC [in arcmin]. Defaults to 1 arcminute. |
{- "obscode": "string",
- "date": "string",
- "limiting_magnitude": null,
- "search_radius": null
}
{- "status": "success",
- "message": "string"
}
Retrieve objects from TNS
tnsrobotID required | int TNS Robot ID. |
startDate | string Arrow-parseable date string (e.g. 2020-01-01). Filter by public_timestamp >= startDate. Defaults to one day ago. |
groupIds required | Array of integers List of IDs of groups to indicate labelling for |
{- "tnsrobotID": null,
- "startDate": "string",
- "groupIds": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve a photometric series
photometric_series_id required | integer |
dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
{- "status": "success",
- "data": {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}, - "message": "string"
}
Delete a photometric series
photometric_series_id required | integer |
{- "status": "success",
- "message": "string"
}
Retrieve all photometric series, based on various cuts.
dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
ra | number RA for spatial filtering (in decimal degrees) |
dec | number Declination for spatial filtering (in decimal degrees) |
radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
objectID | string Portion of ID to filter on |
rejectedObjectIDs | str Comma-separated string of object IDs not to be returned, useful in cases where you are looking for new objects passing a query. |
seriesName | string Get series that match this name. The match must be exact. This is useful when getting photometry for multiple objects taken at the same time (e.g., for calibrating against each other). The series name can be, e.g., a TESS sector, or a date/field name identifier. Generally a series name is shared only by data taken over that same time period. |
seriesObjID | string Get only photometry for the objects named by this object id. This is the internal naming used inside each photometric series, i.e., the index used for each source in the images that were used to create the photometric series. Not the same as the SkyPortal object ID. E.g., this could be a TESS TIC ID, or some internal numbering used in the specific field that was observed. |
filter | string Retrieve only series matching this filter, e.g., "ztfg". |
channel | string The channel name/id to filter on. |
origin | string The origin can be anything that gives an idea of the provenance of the photometric series. This can be, e.g., the name of the pipeline that produced the photometry from the images, or the level of calibration, or any other pre-defined string that identifies where the data came from that isn't covered by the other fields (like channel or filter or instrument). |
filename | string Portion of filename to filter on. If the filename is a relative path, will append the data directory from the config file to the beginning of the filename. (by default that is 'persistentdata/phot_series'). |
startBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started before this time. |
startAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started after this time. |
midTimeBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed before this time. |
midTimeAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed after this time. |
endBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended before this time. |
endAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended after this time. |
detected | boolean If true, get only series with one or more detections. If false, get only series with no detections. If left out, do not filter at all on detection status. |
expTime | number Get only series with this exact exposure time (seconds). |
minExpTime | number Get only series with an exposure time above/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
maxExpTime | number Get only series with an exposure time under/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
minFrameRate | number Get only series with a frame rate higher/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
maxFrameRate | number Get only series with a frame rate lower/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
minNumExposures | number Get only series with this many exposures, or more. |
maxNumExposures | number Get only series with this many exposures, or less. |
instrumentID | number get only series taken with this instrument. |
followupRequestID | number get only series taken with this followup request. |
assignmentID | number get only series taken with this assignment. |
ownerID | number get only series uploaded by this user. |
magBrighterThan | number get only series with mean_mag brighter or equal to this value. |
magFainterThan | number get only series with mean_mag fainter or equal to this value. |
limitingMagBrighterThan | number Retrieve only series with limiting mags brighter or equal to this value. |
limitingMagFainterThan | number Retrieve only series with limiting mags fainter or equal to this value. |
limitingMagIsNone | boolean Retrieve only series that do not have limiting mag. |
magrefBrighterThan | number Get only series that have a magref, and that the magref is brighter or equal to this value. |
magrefFainterThan | number Get only series that have a magref, and that the magref is fainter or equal to this value. |
maxRMS | number get only series with rms_mag less than this. |
minRMS | number get only series with rms_mag more than this. |
useRobustMagAndRMS | boolean If true, will use the robust_mag and robust_rms values instead of mean_mag and rms_mag when filtering on mean magnitude or RMS. Does not affect the magref query. |
maxMedianSNR | number Get only series where the median S/N is less than this. The S/N is calculated using the robust RMS. |
minMedianSNR | number Get only series where the median S/N is more than this. The S/N is calculated using the robust RMS. |
maxBestSNR | number Get only series where the maximum S/N is less than this. The S/N is calculated using the robust RMS. |
minBestSNR | number Get only series where the maximum S/N is more than this. The S/N is calculated using the robust RMS. |
maxWorstSNR | number Get only series where the lowest S/N is less than this. The S/N is calculated using the robust RMS. |
minWorstSNR | number Get only series where the lowest S/N is more than this. The S/N is calculated using the robust RMS. |
hash | string Get only a series that matches this file hash. This is useful if you have an HDF5 file downloaded from the SkyPortal backend, and want to associate it with a PhotometrySeries object. We use an MD5 hash of the file contents. |
sortBy | string The field to sort by. Currently allowed options are ["id", "ra", "dec", "redshift", "saved_at"] |
sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "series": [
- {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}
Get a list of sources with summaries matching the query
q | string The query string. E.g. "What sources are associated with an NGC galaxy?" |
objID | string The objID of the source which has a summary to be used as the query. That is, return the list of sources most similar to the summary of this source. Ignored if q is provided. |
k | int Max number of sources to return. Default 5. |
z_min | float Minimum redshift to consider of queries sources. If None or missing, then no lower limit is applied. |
z_max | float Maximum redshift to consider of queries sources. If None or missing, then no upper limit is applied. |
classificationTypes | Array of strings List of classification types to consider. If [] or missing, then all classification types are considered. |
{- "status": "success",
- "message": "string",
- "data": {
- "sources": [
- {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
]
}
}
Share data with additional groups/users
photometryIDs | Array of integers IDs of the photometry data to be shared. If |
spectrumIDs | Array of integers IDs of the spectra to be shared. If |
groupIDs required | Array of integers List of IDs of groups data will be shared with. To share data with a single user, specify their single user group ID here. |
{- "photometryIDs": [
- 0
], - "spectrumIDs": [
- 0
], - "groupIDs": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve an Recurring API by id
recurring_api_id required | integer |
{- "status": "success",
- "data": {
- "owner": null,
- "owner_id": 0,
- "endpoint": "string",
- "payload": null,
- "method": "string",
- "next_call": "2023-07-10T21:32:37Z",
- "call_delay": 0,
- "number_of_retries": 0,
- "active": true,
- "id": 0
}, - "message": "string"
}
Delete an Recurring API.
recurring_api_id required | integer |
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "owner": null,
- "owner_id": 0,
- "endpoint": "string",
- "payload": null,
- "method": "string",
- "next_call": "2023-07-10T21:32:37Z",
- "call_delay": 0,
- "number_of_retries": 0,
- "active": true,
- "id": 0
}
], - "message": "string"
}
POST a new Recurring APIs.
endpoint required | string Endpoint of the API call. |
method required | string HTTP method of the API call. |
next_call required | datetime Time of the next API call. |
call_delay required | number Delay until next API call in days. |
number_of_retries | integer Number of retries before service is deactivated. |
payload required | object Payload of the API call. |
{- "endpoint": "string",
- "method": "string",
- "next_call": null,
- "call_delay": 0,
- "number_of_retries": 0,
- "payload": { }
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "acls": [
- null
], - "users": [
- null
], - "id": "string"
}
]
}
Grant new Role(s) to a user
user_id required | integer |
roleIds required | Array of strings Array of Role IDs (strings) to be granted to user |
{- "roleIds": [
- "string"
]
}
{- "status": "success",
- "message": "string"
}
Delete user role
user_id required | integer |
role_id required | string |
{- "status": "success",
- "message": "string"
}
Note that a source has been labelled.
obj_id required | string ID of object to indicate source labelling for |
groupIds required | Array of integers List of IDs of groups to indicate labelling for |
{- "groupIds": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Send out a new source notification
additionalNotes | string Notes to append to the message sent out |
groupIds required | Array of integers List of IDs of groups whose members should get the notification (if they've opted in) |
sourceId required | string The ID of the Source's Obj the notification is being sent about |
level required | string Either 'soft' or 'hard', determines whether to send an email or email+SMS notification |
{- "additionalNotes": "string",
- "groupIds": [
- 0
], - "sourceId": "string",
- "level": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": "string"
}
}
Retrieve an observation plan efficiency analysis
survey_efficiency_analysis_id required | integer |
{- "status": "success",
- "data": {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}, - "message": "string"
}
Retrieve parts of the config file that are exposed to the user/browser
{- "status": "success",
- "message": "string",
- "data": {
- "invitationsEnabled": true,
- "slackPreamble": "string",
- "cosmology": "string",
- "cosmoref": "string",
- "allowedSpectrumTypes": [ ],
- "defaultSpectrumType": "string",
- "classificationsClasses": { }
}
}
Retrieve a taxonomy
taxonomy_id required | integer |
{- "status": "success",
- "data": {
- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true,
- "id": 0
}, - "message": "string"
}
Update taxonomy
taxonomy_id required | integer |
groups | Array of any |
classifications | Array of any |
name required | string Short string to make this taxonomy memorable to end users. |
hierarchy required | any Nested JSON describing the taxonomy which should be validated against a schema before entry. |
provenance | string Nullable Identifier (e.g., URL or git hash) that uniquely ties this taxonomy back to an origin or place of record. |
version required | string Semantic version of this taxonomy |
isLatest | boolean Consider this the latest version of the taxonomy with this name? Defaults to True. |
{- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true,
- "id": 0
}
], - "message": "string"
}
Post new taxonomy
name required | string Short string to make this taxonomy memorable to end users. |
hierarchy required | object Nested JSON describing the taxonomy which should be validated against a schema before entry |
group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. Defaults to all of requesting user's groups. |
version required | string Semantic version of this taxonomy name |
provenance | string Identifier (e.g., URL or git hash) that uniquely ties this taxonomy back to an origin or place of record |
isLatest | boolean Consider this version of the taxonomy with this name the latest? Defaults to True. |
{- "name": "string",
- "hierarchy": { },
- "group_ids": [
- 0
], - "version": "string",
- "provenance": "string",
- "isLatest": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "taxonomy_id": 0
}
}
Retrieve a telescope
telescope_id required | integer |
{- "status": "success",
- "data": {
- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true,
- "id": 0
}, - "message": "string"
}
Update telescope
telescope_id required | integer |
instruments | Array of any |
name required | string Unabbreviated facility name (e.g., Palomar 200-inch Hale Telescope). |
nickname required | string Abbreviated facility name (e.g., P200). |
lat | number Nullable Latitude in deg. |
lon | number Nullable Longitude in deg. |
elevation | number Nullable Elevation in meters. |
diameter required | number Diameter in meters. |
skycam_link | string Nullable Link to the telescope's sky camera. |
weather_link | string Nullable Link to the preferred weather site |
robotic | boolean Is this telescope robotic? |
fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all telescopes
name | string Filter by name (exact match) |
latitudeMin | number Filter by latitude >= latitudeMin |
latitudeMax | number Filter by latitude <= latitudeMax |
longitudeMin | number Filter by longitude >= longitudeMin |
longitudeMax | number Filter by longitude <= longitudeMax |
{- "status": "success",
- "data": [
- {
- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true,
- "id": 0
}
], - "message": "string"
}
Create telescopes
instruments | Array of any |
name required | string Unabbreviated facility name (e.g., Palomar 200-inch Hale Telescope). |
nickname required | string Abbreviated facility name (e.g., P200). |
lat | number Nullable Latitude in deg. |
lon | number Nullable Longitude in deg. |
elevation | number Nullable Elevation in meters. |
diameter required | number Diameter in meters. |
skycam_link | string Nullable Link to the telescope's sky camera. |
weather_link | string Nullable Link to the preferred weather site |
robotic | boolean Is this telescope robotic? |
fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve weather info at the telescope site saved by user or telescope specified by telescope_id
parameter
telescope_id | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "weather": { },
- "weather_retrieved_at": "string",
- "weather_link": "string",
- "telescope_name": "string",
- "telescope_nickname": "string",
- "telescope_id": 0,
- "message": "string"
}
}
Retrieve a thumbnail
thumbnail_id required | integer |
{- "status": "success",
- "data": {
- "obj": null,
- "type": "new",
- "file_uri": "string",
- "public_url": "string",
- "origin": "string",
- "obj_id": "string",
- "is_grayscale": true,
- "id": 0
}, - "message": "string"
}
Update thumbnail
thumbnail_id required | integer |
obj | any Nullable The Thumbnail's Obj. |
type | string <= 6 characters Nullable Enum: "new" "ref" "sub" "sdss" "dr8" "ls" "ps1" "new_gz" "ref_gz" "sub_gz" Thumbnail type (e.g., ref, new, sub, ls, ps1, ...) |
file_uri | string Nullable Path of the Thumbnail on the machine running SkyPortal. |
public_url | string Nullable Publically accessible URL of the thumbnail. |
origin | string Nullable Origin of the Thumbnail. |
obj_id required | string ID of the thumbnail's obj. |
is_grayscale | boolean Boolean indicating whether the thumbnail is (mostly) grayscale or not. |
{- "obj": null,
- "type": "new",
- "file_uri": "string",
- "public_url": "string",
- "origin": "string",
- "obj_id": "string",
- "is_grayscale": true
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string"
}
Upload thumbnails
obj_id | string ID of object associated with thumbnails. |
data required | string <byte> base64-encoded PNG image file contents. Image size must be between 16px and 500px on a side. |
ttype required | string Thumbnail type. Must be one of 'new', 'ref', 'sub', 'sdss', 'dr8', 'new_gz', 'ref_gz', 'sub_gz' |
{- "obj_id": "string",
- "data": "string",
- "ttype": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Get information on thumbnails that are or are not in the correct folder/path.
types | Array of strings types of thumbnails to check The default is ['new', 'ref', 'sub'] which are all the thumbnail types stored locally. |
requiredDepth | integer number of subdirectories that are desired for
thumbnails. For example if requiredDepth is 2,
then thumbnails will be stored in a folder like
/skyportal/static/thumbnails/ab/cd/ |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "inCorrectFolder": 0,
- "inWrongFolder": 0
}
}
Delete all empty subfolders under "thumbnails". These can be left over if moving thumbnails to a different folder structure.
{- "status": "success",
- "message": "string"
}
Update the file path and file_uri of the database rows of thumbnails that are not in the correct folder/path.
types | Array of strings types of thumbnails to check The default is ['new', 'ref', 'sub'] which are all the thumbnail types stored locally. |
requiredDepth | integer number of subdirectories that are desired for
thumbnails. For example if requiredDepth is 2,
then thumbnails will be stored in a folder like
/skyportal/static/thumbnails/ab/cd/ |
numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "inCorrectFolder": 0,
- "inWrongFolder": 0
}
}
Retrieve a TNS robot
tnsrobot_id required | integer |
groupID | integer Filter by group ID |
{- "status": "success",
- "data": {
- "group": null,
- "group_id": 0,
- "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "auto_report_group_ids": [
- 0
], - "auto_reporters": "string",
- "id": 0
}, - "message": "string"
}
Update TNS robot
tnsrobot_id required | integer |
group | any Nullable The Group the TNS robot is associated with. |
group_id required | integer The ID of the Group the TNS robot is associated with. |
bot_name required | string Name of the TNS bot. |
bot_id required | integer ID of the TNS bot. |
source_group_id required | integer Source group ID of the TNS bot. |
_altdata | string Nullable |
auto_report_group_ids | Array of integers Nullable |
auto_reporters | string Nullable Auto report reporters. |
id | integer Unique object identifier. |
{- "group": null,
- "group_id": 0,
- "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "auto_report_group_ids": [
- 0
], - "auto_reporters": "string",
- "id": 0
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "data": [
- {
- "group": null,
- "group_id": 0,
- "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "auto_report_group_ids": [
- 0
], - "auto_reporters": "string",
- "id": 0
}
], - "message": "string"
}
Post new TNS robot
group | any Nullable The Group the TNS robot is associated with. |
group_id required | integer The ID of the Group the TNS robot is associated with. |
bot_name required | string Name of the TNS bot. |
bot_id required | integer ID of the TNS bot. |
source_group_id required | integer Source group ID of the TNS bot. |
_altdata | string Nullable |
auto_report_group_ids | Array of integers Nullable |
auto_reporters | string Nullable Auto report reporters. |
{- "group": null,
- "group_id": 0,
- "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "auto_report_group_ids": [
- 0
], - "auto_reporters": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Grant new ACL(s) to a user
user_id required | integer |
aclIds required | Array of strings Array of ACL IDs (strings) to be granted to user |
{- "aclIds": [
- "string"
]
}
{- "status": "success",
- "message": "string"
}
Remove ACL from user permissions
user_id required | integer |
acl_id required | string |
{- "status": "success",
- "message": "string"
}
Retrieve weather info at the telescope site saved by user or telescope specified by telescope_id
parameter
telescope_id | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "weather": { },
- "weather_retrieved_at": "string",
- "weather_link": "string",
- "telescope_name": "string",
- "telescope_nickname": "string",
- "telescope_id": 0,
- "message": "string"
}
}
Return the results of an analysis
analysis_resource_type required | string What underlying data the analysis was performed on: must be "obj" (more to be added in the future) |
token required | string The unique token for this analysis. |
results | object Results data of this analysis |
{- "results": { }
}
{- "status": "success",
- "message": "string"
}
Retrieve an object from Kowalski by objectId
object_id required | str |
instrument | str |
candid | int |
includeAllFields | boolean |
retrieved alert(s)
{- "status": "success",
- "message": "string"
}
Retrieve objects from Kowalski by objectId and or position
objectId | str can be a single objectId or a comma-separated list of objectIds |
ra | float RA in degrees |
dec | float Dec. in degrees |
radius | float Max distance from specified (RA, Dec) (capped at 1 deg) |
radius_units | string Distance units (either "deg", "arcmin", or "arcsec") |
includeAllFields | boolean |
retrieved alert(s)
{- "status": "success",
- "message": "string",
- "data": [
- { }
]
}
Save ZTF objectId from Kowalski as source in SkyPortal
candid | integer >= 1 Alert candid to use to pull thumbnails. Defaults to latest alert |
thumbnailsOnly | bool Default: false Only post thumbnails (no photometry) |
group_ids required | Array of integers non-empty Group IDs to save source to. Can alternatively be the string 'all' to save to all of requesting user's groups. |
{- "candid": 1,
- "thumbnailsOnly": false,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve aux data for an objectId from Kowalski
object_id required | string |
includePrvCandidates | boolean |
includeAllFields | boolean |
retrieved aux data
{- "status": "success",
- "message": "string",
- "data": { }
}
candid required | integer ZTF alert candid |
cutout required | string Enum: "science" "template" "difference" retrieve science, template, or difference cutout image? |
file_format required | string Enum: "fits" "png" response file format: original loss-less FITS or rendered png |
interval | string Enum: "min_max" "zscale" Interval to use when rendering png |
stretch | string Enum: "linear" "log" "asinh" "sqrt" Stretch to use when rendering png |
cmap | string Enum: "bone" "gray" "cividis" "viridis" "magma" Color map to use when rendering png |
retrieved cutout
retrieval failed
{- "status": "error",
- "data": { },
- "message": "string"
}
candid required | integer ZTF alert candid |
normalizeImage | boolean |
retrieved aux data
retrieval failed
{- "status": "success",
- "message": "string",
- "data": { }
}
Retrieve an object from Kowalski by objectId
object_id required | str |
instrument | str |
candid | int |
includeAllFields | boolean |
retrieved alert(s)
{- "status": "success",
- "message": "string"
}
Retrieve objects from Kowalski by objectId and or position
objectId | str can be a single objectId or a comma-separated list of objectIds |
ra | float RA in degrees |
dec | float Dec. in degrees |
radius | float Max distance from specified (RA, Dec) (capped at 1 deg) |
radius_units | string Distance units (either "deg", "arcmin", or "arcsec") |
includeAllFields | boolean |
retrieved alert(s)
{- "status": "success",
- "message": "string",
- "data": [
- { }
]
}
Save ZTF objectId from Kowalski as source in SkyPortal
candid | integer >= 1 Alert candid to use to pull thumbnails. Defaults to latest alert |
thumbnailsOnly | bool Default: false Only post thumbnails (no photometry) |
group_ids required | Array of integers non-empty Group IDs to save source to. Can alternatively be the string 'all' to save to all of requesting user's groups. |
{- "candid": 1,
- "thumbnailsOnly": false,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Retrieve aux data for an objectId from Kowalski
object_id required | string |
includePrvCandidates | boolean |
includeAllFields | boolean |
retrieved aux data
{- "status": "success",
- "message": "string",
- "data": { }
}
candid required | integer ZTF alert candid |
cutout required | string Enum: "science" "template" "difference" retrieve science, template, or difference cutout image? |
file_format required | string Enum: "fits" "png" response file format: original loss-less FITS or rendered png |
interval | string Enum: "min_max" "zscale" Interval to use when rendering png |
stretch | string Enum: "linear" "log" "asinh" "sqrt" Stretch to use when rendering png |
cmap | string Enum: "bone" "gray" "cividis" "viridis" "magma" Color map to use when rendering png |
retrieved cutout
retrieval failed
{- "status": "error",
- "data": { },
- "message": "string"
}
candid required | integer ZTF alert candid |
normalizeImage | boolean |
retrieved aux data
retrieval failed
{- "status": "success",
- "message": "string",
- "data": { }
}
catalog required | str |
ra required | float RA in degrees |
dec required | float Dec. in degrees |
radius required | float Max distance from specified (RA, Dec) (capped at 1 deg) |
radius_units required | string Distance units (either "deg", "arcmin", or "arcsec") |
retrieved light curve data
{- "status": "success",
- "message": "string",
- "data": [
- { }
]
}
Post ZTF light curve data from a Kowalski instance to SkyPortal
obj_id | str target obj_id to save photometry to. create new if None. |
catalog | str Kowalski catalog name to pull light curves from. |
light_curve_ids | Array of integers non-empty Light curves IDs in catalog on Kowalski. |
group_ids | Array of integers non-empty group ids to save source to. defaults to all user groups |
{- "obj_id": null,
- "catalog": null,
- "light_curve_ids": [
- 0
], - "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string"
}
}
retrieved catalog names
{- "status": "success",
- "message": "string",
- "data": [
- null
]
}
ra required | float RA in degrees |
dec required | float Dec. in degrees |
radius required | float Maximum distance in |
radius_units required | string Enum: "deg" "arcmin" "arcsec" Distance units (either "deg", "arcmin", or "arcsec") |
retrieved source data
{- "status": "success",
- "message": "string",
- "data": { }
}
id required | str object ID |
ra required | float RA in degrees |
dec required | float Dec. in degrees |
catalog | str default is ZTF_source_features_DR5 |
radius | float Max distance from specified (RA, Dec) (capped at 1 deg). Default is 2 |
radius_units | string Distance units (either "deg", "arcmin", or "arcsec"). Default is arcsec |
{- "status": "success",
- "message": "string"
}
Retrieve a filter as stored on Kowalski
filter_id required | integer |
{- "status": "success",
- "message": "string",
- "data": { }
}
POST a new filter version.
stream | any Nullable The Filter's Stream. |
group | any Nullable The Filter's Group. |
candidates | Array of any |
name required | string Filter name. |
stream_id required | integer ID of the Filter's Stream. |
group_id required | integer ID of the Filter's Group. |
{- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0
}
{- "status": "success",
- "message": "string",
- "data": {
- "pipeline": [
- { }
]
}
}
Delete a filter on Kowalski
filter_id required | integer |
{- "status": "success",
- "message": "string"
}
Update a filter on Kowalski
filter_id required | integer |
filter_id required | integer >= 1 [fritz] science program filter id for this user group id |
active | boolean activate or deactivate filter |
active_fid | string 6 characters set fid as active version |
autosave | boolean automatically save passing candidates to filter's group |
update_annotations | boolean update annotations for existing candidates |
{- "filter_id": 1,
- "active": true,
- "active_fid": "string",
- "autosave": true,
- "update_annotations": true
}
{- "status": "success",
- "message": "string"
}
catalog required | str |
ra required | float RA in degrees |
dec required | float Dec. in degrees |
radius required | float Max distance from specified (RA, Dec) (capped at 1 deg) |
radius_units required | string Distance units (either "deg", "arcmin", or "arcsec") |
retrieved light curve data
{- "status": "success",
- "message": "string",
- "data": [
- { }
]
}
Post ZTF light curve data from a Kowalski instance to SkyPortal
obj_id | str target obj_id to save photometry to. create new if None. |
catalog | str Kowalski catalog name to pull light curves from. |
light_curve_ids | Array of integers non-empty Light curves IDs in catalog on Kowalski. |
group_ids | Array of integers non-empty group ids to save source to. defaults to all user groups |
{- "obj_id": null,
- "catalog": null,
- "light_curve_ids": [
- 0
], - "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string"
}
}
retrieved catalog names
{- "status": "success",
- "message": "string",
- "data": [
- null
]
}
ra required | float RA in degrees |
dec required | float Dec. in degrees |
radius required | float Maximum distance in |
radius_units required | string Enum: "deg" "arcmin" "arcsec" Distance units (either "deg", "arcmin", or "arcsec") |
retrieved source data
{- "status": "success",
- "message": "string",
- "data": { }
}
id required | str object ID |
ra required | float RA in degrees |
dec required | float Dec. in degrees |
catalog | str default is ZTF_source_features_DR5 |
radius | float Max distance from specified (RA, Dec) (capped at 1 deg). Default is 2 |
radius_units | string Distance units (either "deg", "arcmin", or "arcsec"). Default is arcsec |
{- "status": "success",
- "message": "string"
}