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 observation plans associated with an allocation
allocation_id required | integer |
numPerPage | integer Number of observation plans to return per paginated request. Defaults to 10. Can be no larger than {MAX_OBSERVATION_PLANS}. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
]
}
Retrieve an allocation
allocation_id required | integer |
numPerPage | integer Number of followup requests to return per paginated request. Defaults to 10. Can be no larger than {MAX_FOLLOWUP_REQUESTS}. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "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": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string",
- "id": 0
}
}
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 or null The Group the allocation is associated with. |
instrument | any or null The Instrument the allocation is associated with. |
allocation_users | Array of any |
gcn_triggers | Array of any |
pi | string or null The PI of the allocation's proposal. |
proposal_id | string or null The ID of the proposal associated with this allocation. |
start_date | string or null <date-time> The UTC start date of the allocation. |
end_date | string or null <date-time> The UTC end date of the allocation. |
hours_allocated required | number The number of hours allocated. |
default_share_group_ids | any or null |
types | Array of any The type of allocation. |
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 or null |
{- "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": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string"
}
{- "status": "success",
- "message": "string"
}
Retrieve all allocations
instrument_id | number Instrument ID to retrieve allocations for |
{- "status": "success",
- "message": "string",
- "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": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string",
- "id": 0
}
]
}
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 or null The Group the allocation is associated with. |
instrument | any or null The Instrument the allocation is associated with. |
allocation_users | Array of any |
gcn_triggers | Array of any |
pi | string or null The PI of the allocation's proposal. |
proposal_id | string or null The ID of the proposal associated with this allocation. |
start_date | string or null <date-time> The UTC start date of the allocation. |
end_date | string or null <date-time> The UTC end date of the allocation. |
hours_allocated required | number The number of hours allocated. |
default_share_group_ids | any or null |
types | Array of any The type of allocation. |
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 or null |
{- "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": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- 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",
- "message": "string",
- "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
}
]
}
Retrieve all observation plan efficiency analyses
observation_plan_id | number EventObservationPlan ID to retrieve observation plan efficiency analyses for |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
]
}
Retrieve observation plans associated with an allocation
allocation_id required | integer |
numPerPage | integer Number of observation plans to return per paginated request. Defaults to 10. Can be no larger than {MAX_OBSERVATION_PLANS}. |
pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
]
}
Retrieve a default analysis
analysis_service_id required | any Analysis service ID |
default_analysis_id required | any Default analysis ID |
{- "status": "success",
- "message": "string",
- "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
}
}
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",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "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
}
]
}
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"
}
get PS1 sources and post them as an annotation
obj_id required | string ID of the object to retrieve PS1 sources for |
catalog | string The name of the catalog key, used when posting annotations. Default is ps1.dr2. This is not used for the query, which will always query DR2. |
crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve PS1 sources Default is 2. |
crossmatchMinDetections | number Crossmatch minimum number of detections to retrieve PS1 sources Default is 1. |
crossmatchNumber | number Crossmatch number of sources (maximum) to retrieve from PS1 Default is 1, max is 5. |
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,
- "crossmatchMinDetections": 0,
- "crossmatchNumber": 0,
- "group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Add autoreporter(s) to a TNSRobotGroup
tnsrobot_id required | string The ID of the TNSRobot |
group_id required | string The ID of the group to add autoreporter(s) to |
user_id | string The ID of the user to add as an autoreporter |
user_ids | Array of strings An array of user IDs to add as autoreporters. If a string is provided, it will be split by commas. |
{- "user_ids": [
- "string"
]
}
{- "status": "success",
- "message": "string"
}
Retrieve a TNSRobotSubmission
tnsrobot_id required | integer The ID of the TNSRobot |
id required | integer The ID of the TNSRobotSubmission |
{- "tnsrobot": null,
- "obj": null,
- "user": null,
- "tnsrobot_id": 0,
- "obj_id": "string",
- "user_id": 0,
- "custom_reporting_string": "string",
- "custom_remarks_string": "string",
- "status": "string",
- "archival": true,
- "archival_comment": "string",
- "submission_id": 0,
- "auto_submission": true,
- "instrument_ids": null,
- "stream_ids": null,
- "photometry_options": null,
- "payload": null,
- "response": null,
- "id": 0
}
Retrieve all TNSRobotSubmissions
tnsrobot_id required | integer The ID of the TNSRobot |
pageNumber | integer The page number to retrieve, starting at 1 |
numPerPage | integer The number of results per page, defaults to 100 |
include_payload | boolean Whether to include the payload in the response |
include_response | boolean Whether to include the response in the response |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "tnsrobot": null,
- "obj": null,
- "user": null,
- "tnsrobot_id": 0,
- "obj_id": "string",
- "user_id": 0,
- "custom_reporting_string": "string",
- "custom_remarks_string": "string",
- "status": "string",
- "archival": true,
- "archival_comment": "string",
- "submission_id": 0,
- "auto_submission": true,
- "instrument_ids": null,
- "stream_ids": null,
- "photometry_options": null,
- "payload": null,
- "response": null,
- "id": 0
}
]
}
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) |
{- "status": "error",
- "message": "string",
- "data": { }
}
Retrieve an Analysis Service by id
analysis_service_id required | integer |
{- "status": "success",
- "message": "string",
- "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
}
}
{- "status": "success",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "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",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_message": "string"
}
}
{- "status": "success",
- "message": "string",
- "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",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_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 |
input_filters | Array of arrays Filters to apply to the input data |
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,
- "input_filters": [ ],
- "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",
- "message": "string",
- "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",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_message": "string"
}
}
{- "status": "success",
- "message": "string",
- "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",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_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 |
input_filters | Array of arrays Filters to apply to the input data |
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,
- "input_filters": [ ],
- "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 |
object Extra parameters to pass to the plotting functions if new plots are to be generated (e.g. with corner plots) |
{- "download": null,
- "plot_kwargs": {
- "property1": { },
- "property2": { }
}
}
{ }
Retrieve an observing run assignment
assignment_id required | integer |
{- "status": "success",
- "message": "string",
- "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
}
}
Update an assignment
assignment_id required | integer |
requester | any or null The User who created this assignment. |
last_modified_by | any or null |
obj | any or null The assigned Obj. |
spectra | Array of any |
photometry | Array of any |
photometric_series | Array of any |
run | any or null 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 or null 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",
- "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
}
]
}
Post new target assignment to observing run
run_id required | integer |
obj_id required | string The ID of the object to observe. |
priority required | any Enum: "1" "2" "3" "4" "5" Priority of the request, (lowest = 1, highest = 5). |
status | string The status of the request |
comment | string An optional comment describing the request. |
{- "run_id": 0,
- "obj_id": "string",
- "priority": "1",
- "status": "string",
- "comment": "string"
}
{- "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",
- "message": "string",
- "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
], - "tns_submissions": [
- 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
]
}
}
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). |
classificationsReject | Array of strings Comma-separated string of classification(s) to filter OUT candidates matching with any of 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 |
firstDetectionAfter | string Only return sources that were first detected after this UTC datetime. |
lastDetectionBefore | string Only return sources that were last detected before this UTC datetime. |
numberDetections | integer Only return sources that have been detected at least this many times. |
requireDetections | boolean Require firstDetectionAfter, lastDetectionBefore, and numberDetections to be set when querying candidates in a localization. Defaults to True. |
ignoreForcedPhotometry | boolean If true, ignore forced photometry when applying firstDetectionAfter, lastDetectionBefore, and numberDetections. Defaults to False. |
{- "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
], - "tns_submissions": [
- 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 or null 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 |
tns_submissions | Array of any |
id required | string Name of the object. |
ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
dec_dis | number or null J2000 Declination at discovery time [deg]. |
ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
offset | number or null Offset from nearest static object [arcsec]. |
redshift | number or null Redshift. |
redshift_error | number or null Redshift error. |
redshift_origin | string or null Redshift source. |
host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
summary | string or null Summary of the obj. |
summary_history | any or null Record of the summaries generated and written about this obj |
altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean or null Boolean indicating whether the object is a variable star. |
is_roid | boolean or null Boolean indicating whether the object is a moving object. |
mpc_name | string or null Minor planet center name. |
gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
tns_name | string or null Transient Name Server name. |
tns_info | any or null TNS info in JSON format |
score | number or null Machine learning score. |
origin | string or null Origin of the object. |
alias | any or null Alternative names for this object. |
healpix | integer or null |
detect_photometry_count | integer or null How many times the object was detected above :math: |
ra | number or null |
dec | number or null |
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 or null ID of associated filter that created candidate |
passed_at required | string or null 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
], - "tns_submissions": [
- 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 or null 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 |
tns_submissions | Array of any |
id required | string Name of the object. |
ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
dec_dis | number or null J2000 Declination at discovery time [deg]. |
ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
offset | number or null Offset from nearest static object [arcsec]. |
redshift | number or null Redshift. |
redshift_error | number or null Redshift error. |
redshift_origin | string or null Redshift source. |
host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
summary | string or null Summary of the obj. |
summary_history | any or null Record of the summaries generated and written about this obj |
altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean or null Boolean indicating whether the object is a variable star. |
is_roid | boolean or null Boolean indicating whether the object is a moving object. |
mpc_name | string or null Minor planet center name. |
gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
tns_name | string or null Transient Name Server name. |
tns_info | any or null TNS info in JSON format |
score | number or null Machine learning score. |
origin | string or null Origin of the object. |
alias | any or null Alternative names for this object. |
healpix | integer or null |
detect_photometry_count | integer or null How many times the object was detected above :math: |
ra | number or null |
dec | number or null |
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 or null ID of associated filter that created candidate |
passed_at required | string or null 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
], - "tns_submissions": [
- 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
]
}
}
Submit catalog queries
payload | any Content of the catalog query request. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Catalog query request allocation ID. |
target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
{- "payload": null,
- "status": "pending submission",
- "allocation_id": 0,
- "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"
}
Retrieve a classification
classification_id required | integer |
includeTaxonomy | boolean Return associated taxonomy. |
{- "status": "success",
- "message": "string",
- "data": {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
}
Update a classification
classification required | integer |
taxonomy | any or null Taxonomy in which this Classification was made. |
author | any or null The User that made this classification. |
obj | any or null The Classification's Obj. |
groups | Array of any |
votes | Array of any |
classification required | string The assigned class. |
origin | string or null String describing the source of this classification. |
taxonomy_id required | integer ID of the Taxonomy in which this Classification was made. |
probability | number or null User-assigned probability of belonging to this class |
ml | boolean Whether this classification was made by a machine learning algorithm, or a human |
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,
- "ml": true,
- "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 or null 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,
- "ml": true,
- "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 or null [ 0 .. 1 ] 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 the public group. |
vote | boolean or null Add vote associated with classification. |
label | boolean or null 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",
- "message": "string",
- "data": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
]
}
Delete all of an object's classifications
classification_id required | integer |
label | boolean or null 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"
}
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
]
}
{- "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",
- "message": "string",
- "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
}
}
{- "status": "success",
- "message": "string",
- "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
}
]
}
{- "status": "success",
- "message": "string",
- "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",
- "auto_send": true,
- "id": 0
}
]
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "default_observationplan_request": null,
- "default_observationplan_request_id": 0,
- "payload": null,
- "id": 0
}
]
}
Update filter name
filter_id required | integer |
stream | any or null The Filter's Stream. |
group | any or null 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"
}
POST a new filter.
stream | any or null The Filter's Stream. |
group | any or null 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
}
}
POST a new filter version.
stream | any or null The Filter's Stream. |
group | any or null 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": [
- { }
]
}
}
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 | dict automatically save passing candidates to filter's group |
update_annotations | boolean update annotations for existing candidates |
auto_followup | boolean | dict automatically create follow-up requests for passing and autosaved candidates |
{- "filter_id": 1,
- "active": true,
- "active_fid": "string",
- "autosave": null,
- "update_annotations": true,
- "auto_followup": null
}
{- "status": "success",
- "message": "string"
}
Create default follow-up request.
payload | any Content of the 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": null,
- "allocation_id": 0,
- "target_group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a single default observation plan
default_observation_plan_id required | integer |
{- "status": "success",
- "message": "string",
- "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",
- "auto_send": true,
- "id": 0
}
}
Create default observation plan requests.
payload | any Content of the default observation plan request. |
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": null,
- "allocation_id": 0,
- "target_group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a single default survey efficiency
default_survey_efficiency_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "default_observationplan_request": null,
- "default_observationplan_request_id": 0,
- "payload": null,
- "id": 0
}
}
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"
}
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 |
priorityThreshold | number Threshold on request priority to include. If provided, filter by payload.priority >= priorityThreshold |
timeResolution | number Time resolution for scheduler creation in seconds. Defaults to 20. |
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 |
{- "status": "error",
- "message": "string",
- "data": { }
}
Update a follow-up request
request_id required | string |
obj_id required | string ID of the target Obj. |
payload | any Content of the followup request. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Followup request allocation ID. |
target_group_ids | Array of integers IDs of groups to share the results of the followup request with. |
not_if_duplicates | boolean If true, the followup request will not be executed if the object already has a pending or completed request of the same allocation. |
source_group_ids | Array of integers IDs of groups to which there must be a source for the object associated with the followup request. |
not_if_classified | boolean If true, the followup request will not be executed if there are any sources within radius with (human-only) classifications. |
not_if_spectra_exist | boolean If true, the followup request will not be executed if there are any sources within radius that have spectra. |
not_if_tns_classified | boolean If true, the followup request will not be executed if any object within radius is already classified as SN in TNS. |
ignore_source_group_ids | Array of integers If there are any sources within radius saved to any of these groups, the followup request will not be executed. |
radius | number Radius of to use when checking constraints. |
ignore_allocation_ids | Array of integers If there are any existing requests from the allocations that are pending or completed, the followup request will not be executed. |
{- "obj_id": "string",
- "payload": null,
- "status": "pending submission",
- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "not_if_duplicates": true,
- "source_group_ids": [
- 0
], - "not_if_classified": true,
- "not_if_spectra_exist": true,
- "not_if_tns_classified": true,
- "ignore_source_group_ids": [
- 0
], - "radius": 0,
- "ignore_allocation_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Submit follow-up request.
obj_id required | string ID of the target Obj. |
payload | any Content of the followup request. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Followup request allocation ID. |
target_group_ids | Array of integers IDs of groups to share the results of the followup request with. |
not_if_duplicates | boolean If true, the followup request will not be executed if the object already has a pending or completed request of the same allocation. |
source_group_ids | Array of integers IDs of groups to which there must be a source for the object associated with the followup request. |
not_if_classified | boolean If true, the followup request will not be executed if there are any sources within radius with (human-only) classifications. |
not_if_spectra_exist | boolean If true, the followup request will not be executed if there are any sources within radius that have spectra. |
not_if_tns_classified | boolean If true, the followup request will not be executed if any object within radius is already classified as SN in TNS. |
ignore_source_group_ids | Array of integers If there are any sources within radius saved to any of these groups, the followup request will not be executed. |
radius | number Radius of to use when checking constraints. |
ignore_allocation_ids | Array of integers If there are any existing requests from the allocations that are pending or completed, the followup request will not be executed. |
{- "obj_id": "string",
- "payload": null,
- "status": "pending submission",
- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "not_if_duplicates": true,
- "source_group_ids": [
- 0
], - "not_if_classified": true,
- "not_if_spectra_exist": true,
- "not_if_tns_classified": true,
- "ignore_source_group_ids": [
- 0
], - "radius": 0,
- "ignore_allocation_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
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
catalogName required | string Galaxy catalog name. |
catalogDescription | string or null Default: null Galaxy catalog description. |
catalogURL | string or null Default: null Galaxy catalog URL. |
catalogData required | any Catalog data Ascii string |
{- "catalogName": "string",
- "catalogDescription": null,
- "catalogURL": null,
- "catalogData": null
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "objects": [
- null
], - "catalog_id": 0,
- "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
}
]
}
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"
}
Upload spatial catalog from ASCII file
catalogName | string Spatial catalog name. |
catalogData | any Catalog data Ascii string |
{- "catalogName": "string",
- "catalogData": null
}
{- "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 |
minMstar | number If provided, return only galaxies with a stellar mass of at least this value |
maxMstar | number If provided, return only galaxies with a stellar mass 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_GALAXIES}. |
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. |
sortBy | string Column to sort by. Can be one of the following: distmpc, redshift, name, mstar, prob, mstar_prob_weighted, sfr_fuv, magb, magk. Defaults to no sorting unless a localization and catalog are provided, then defaults to mstar_prob_weighted. |
sortOrder | string Sort order. Can be one of the following: asc, desc. Defaults to None unless a localization and catalog are provided, then defaults to desc. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "objects": [
- null
], - "catalog_id": 0,
- "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
}
]
}
Ingest a Galaxy catalog
catalog_name required | string Galaxy catalog name. |
catalog_description | string or null Default: null Galaxy catalog description. |
catalog_url | string or null Default: null Galaxy catalog URL. |
catalog_data required | Array of any Galaxy catalog data |
{- "catalog_name": "string",
- "catalog_description": null,
- "catalog_url": null,
- "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
}
}
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"
}
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",
- "message": "string",
- "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
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "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
}
}
Update instrument
instrument_id required | integer |
telescope | any or null 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 |
tnsrobots | 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 or null 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 or null JSON describing the filters on the instrument and the filter's corresponding limiting magnitude and exposure time. |
configuration_data | any or null JSON describing instrument configuration properties such as instrument overhead, filter change time, readout, etc. |
status | any or null JSON describing the latest status of the instrument. |
last_status_update | string or null <date-time> The time at which the status was last updated. |
api_classname | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "COLIBRIAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TAROTAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's API class. |
api_classname_obsplan | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "COLIBRIAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TAROTAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's ObservationPlan API class. |
listener_classname | string or null <= 12 characters Value: "SEDMListener" Name of the instrument's listener class. |
treasuremap_id | integer or null treasuremap.space API ID for this instrument |
tns_id | integer or null TNS API ID for this instrument |
region | string or null 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
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "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. |
ignoreCache | boolean Boolean indicating whether to ignore field caching. 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",
- "message": "string",
- "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
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "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
}
]
}
Add a new instrument
telescope | any or null 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 |
tnsrobots | 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 or null 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). |
object or null JSON describing the filters on the instrument and the filter's corresponding limiting magnitude and exposure time. | |
object or null JSON describing instrument configuration properties such as instrument overhead, filter change time, readout, etc. | |
status | any or null JSON describing the latest status of the instrument. |
last_status_update | string or null <date-time> The time at which the status was last updated. |
api_classname | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "COLIBRIAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TAROTAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's API class. |
api_classname_obsplan | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "COLIBRIAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TAROTAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's ObservationPlan API class. |
listener_classname | string or null <= 12 characters Value: "SEDMListener" Name of the instrument's listener class. |
treasuremap_id | integer or null treasuremap.space API ID for this instrument |
tns_id | integer or null TNS API ID for this instrument |
region | string or null 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
], - "tnsrobots": [
- 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": "2019-08-24T14:15:22Z",
- "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
}
}
Retrieve a ground velocity measurement for the earthquake.
earthquake_id required | string |
mma_detector_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "event_id": 0,
- "detector_id": 0,
- "rfamp": 0,
- "lockloss": 0,
- "id": 0
}
}
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 or null 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 or null |
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 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",
- "message": "string",
- "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
}
}
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 or null The Comment's Obj. |
author | any or null 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 or null Filename of the attachment. |
_attachment_path | string or null file path where the data of the attachment is saved. |
origin | string or null Comment origin. |
bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
attachment_bytes | string or null 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 the public group. |
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 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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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 or null The Comment's Obj. |
author | any or null 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 or null Filename of the attachment. |
_attachment_path | string or null file path where the data of the attachment is saved. |
origin | string or null Comment origin. |
bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
attachment_bytes | string or null 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 the public group. |
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",
- "message": "string",
- "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
}
}
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 or null The Comment's Obj. |
author | any or null 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 or null Filename of the attachment. |
_attachment_path | string or null file path where the data of the attachment is saved. |
origin | string or null Comment origin. |
bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
attachment_bytes | string or null 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. |
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 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",
- "message": "string",
- "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
}
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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",
- "message": "string",
- "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
}
}
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",
- "message": "string",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
}
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",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}
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) |
{- "status": "error",
- "message": "string",
- "data": { }
}
Retrieve an object's classifications
obj_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
]
}
Delete all of an object's classifications
classification_id required | integer |
label | boolean or null 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",
- "message": "string",
- "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
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
]
}
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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}
Retrieve a source
obj_id required | string Source ID |
TNSname | string TNS name for the source |
includePhotometry | boolean Boolean indicating whether to include associated photometry. Defaults to false. |
deduplicatePhotometry | boolean Boolean indicating whether to deduplicate 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",
- "message": "string",
- "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
], - "tns_submissions": [
- 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
]
}
}
Update a source
obj_id required | string |
host | any or null 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 |
tns_submissions | Array of any |
ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
dec_dis | number or null J2000 Declination at discovery time [deg]. |
ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
offset | number or null Offset from nearest static object [arcsec]. |
redshift | number or null Redshift. |
redshift_error | number or null Redshift error. |
redshift_origin | string or null Redshift source. |
redshift_history | any or null Record of who set which redshift values and when. |
host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
summary | string or null Summary of the obj. |
summary_history | any or null Record of the summaries generated and written about this obj |
altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean or null Boolean indicating whether the object is a variable star. |
is_roid | boolean or null Boolean indicating whether the object is a moving object. |
mpc_name | string or null Minor planet center name. |
gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
tns_name | string or null Transient Name Server name. |
tns_info | any or null TNS info in JSON format |
score | number or null Machine learning score. |
origin | string or null Origin of the object. |
alias | any or null Alternative names for this object. |
internal_key | string Internal key used for secure websocket messaging. |
detect_photometry_count | integer or null How many times the object was detected above :math: |
ra | number or null |
dec | number or null |
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
], - "tns_submissions": [
- 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 or TNS name 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 |
requireDetections | boolean Require startDate, endDate, and numberDetections to be set when querying sources in a localization. Defaults to True. |
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. |
useCache | boolean Boolean indicating whether to use cached results. Defaults to false. |
queryID | string String to identify query. If provided, will be used to recover previous cached results and speed up query. Defaults to None. |
{- "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
], - "tns_submissions": [
- 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 or null 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 |
tns_submissions | Array of any |
id required | string Name of the object. |
ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
dec_dis | number or null J2000 Declination at discovery time [deg]. |
ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
offset | number or null Offset from nearest static object [arcsec]. |
redshift | number or null Redshift. |
redshift_error | number or null Redshift error. |
redshift_origin | string or null Redshift source. |
host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
summary | string or null Summary of the obj. |
summary_history | any or null Record of the summaries generated and written about this obj |
altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
varstar | boolean or null Boolean indicating whether the object is a variable star. |
is_roid | boolean or null Boolean indicating whether the object is a moving object. |
mpc_name | string or null Minor planet center name. |
gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
tns_name | string or null Transient Name Server name. |
tns_info | any or null TNS info in JSON format |
score | number or null Machine learning score. |
origin | string or null Origin of the object. |
alias | any or null Alternative names for this object. |
healpix | integer or null |
detect_photometry_count | integer or null How many times the object was detected above :math: |
ra | number or null |
dec | number or null |
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
], - "tns_submissions": [
- 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"
}
}
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 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",
- "message": "string",
- "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
}
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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",
- "message": "string",
- "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
}
}
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",
- "message": "string",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
}
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",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}
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:
|
sortBy | string The column to order the spectra by. Defaults to observed_at. Options are: observed_at, created_at |
sortOrder | string The order to sort the spectra by. Defaults to asc. Options are: asc, desc |
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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
}
}
Update spectrum
spectrum_id required | integer |
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
obj_id required | string ID of this Spectrum's Obj. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
external_pi | string or null Default: null Free text provided as an external PI |
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. |
external_reducer | string or null Default: null Free text provided as 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. |
external_observer | string or null Default: null Free text provided as an external observer |
origin | string Origin of the spectrum. |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
instrument_id required | integer ID of the Instrument that acquired the 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. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
altdata | any Miscellaneous alternative metadata. |
{- "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "pi": [ ],
- "external_pi": null,
- "reduced_by": [ ],
- "external_reducer": null,
- "observed_by": [ ],
- "external_observer": null,
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "group_ids": [ ],
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null
}
{- "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
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
obj_id required | string ID of this Spectrum's Obj. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
external_pi | string or null Default: null Free text provided as an external PI |
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. |
external_reducer | string or null Default: null Free text provided as 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. |
external_observer | string or null Default: null Free text provided as an external observer |
origin | string Origin of the spectrum. |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
instrument_id required | integer ID of the Instrument that acquired the 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. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
altdata | any Miscellaneous alternative metadata. |
{- "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "pi": [ ],
- "external_pi": null,
- "reduced_by": [ ],
- "external_reducer": null,
- "observed_by": [ ],
- "external_observer": null,
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "group_ids": [ ],
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null
}
{- "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). |
fluxerr_column | integer or null 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. |
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:
|
{- "wave_column": 0,
- "flux_column": 1,
- "fluxerr_column": null,
- "ascii": "string"
}
{- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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
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). |
fluxerr_column | integer or null 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. |
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:
|
obj_id required | string The ID of the object that the spectrum is of. |
instrument_id required | integer The ID of the instrument that took the spectrum. |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source', 'host', 'host_center'. Defaults to 'fsource'. |
label | string User defined label to be placed in plot legends, instead of the default |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
group_ids | Array of integers The IDs of the groups to share this spectrum with. |
filename required | string The original filename (for bookkeeping purposes). |
pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
external_pi | string or null Default: null Free text provided as an external PI |
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. |
external_reducer | string or null Default: null Free text provided as 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. |
external_observer | string or null Default: null Free text provided as an external observer |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
{- "wave_column": 0,
- "flux_column": 1,
- "fluxerr_column": null,
- "ascii": "string",
- "obj_id": "string",
- "instrument_id": 0,
- "type": "source",
- "label": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "group_ids": [
- 0
], - "filename": "string",
- "pi": [ ],
- "external_pi": null,
- "reduced_by": [ ],
- "external_reducer": null,
- "observed_by": [ ],
- "external_observer": null,
- "followup_request_id": 0,
- "assignment_id": 0
}
{- "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",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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 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
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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
}
]
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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
}
}
Update spectrum
spectrum_id required | integer |
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
obj_id required | string ID of this Spectrum's Obj. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
external_pi | string or null Default: null Free text provided as an external PI |
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. |
external_reducer | string or null Default: null Free text provided as 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. |
external_observer | string or null Default: null Free text provided as an external observer |
origin | string Origin of the spectrum. |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
instrument_id required | integer ID of the Instrument that acquired the 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. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
altdata | any Miscellaneous alternative metadata. |
{- "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "pi": [ ],
- "external_pi": null,
- "reduced_by": [ ],
- "external_reducer": null,
- "observed_by": [ ],
- "external_observer": null,
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "group_ids": [ ],
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null
}
{- "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
wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
obj_id required | string ID of this Spectrum's Obj. |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
external_pi | string or null Default: null Free text provided as an external PI |
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. |
external_reducer | string or null Default: null Free text provided as 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. |
external_observer | string or null Default: null Free text provided as an external observer |
origin | string Origin of the spectrum. |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
instrument_id required | integer ID of the Instrument that acquired the 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. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
altdata | any Miscellaneous alternative metadata. |
{- "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "pi": [ ],
- "external_pi": null,
- "reduced_by": [ ],
- "external_reducer": null,
- "observed_by": [ ],
- "external_observer": null,
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "group_ids": [ ],
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null
}
{- "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). |
fluxerr_column | integer or null 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. |
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:
|
{- "wave_column": 0,
- "flux_column": 1,
- "fluxerr_column": null,
- "ascii": "string"
}
{- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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
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). |
fluxerr_column | integer or null 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. |
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:
|
obj_id required | string The ID of the object that the spectrum is of. |
instrument_id required | integer The ID of the instrument that took the spectrum. |
type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source', 'host', 'host_center'. Defaults to 'fsource'. |
label | string User defined label to be placed in plot legends, instead of the default |
observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
group_ids | Array of integers The IDs of the groups to share this spectrum with. |
filename required | string The original filename (for bookkeeping purposes). |
pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
external_pi | string or null Default: null Free text provided as an external PI |
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. |
external_reducer | string or null Default: null Free text provided as 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. |
external_observer | string or null Default: null Free text provided as an external observer |
followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
{- "wave_column": 0,
- "flux_column": 1,
- "fluxerr_column": null,
- "ascii": "string",
- "obj_id": "string",
- "instrument_id": 0,
- "type": "source",
- "label": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "group_ids": [
- 0
], - "filename": "string",
- "pi": [ ],
- "external_pi": null,
- "reduced_by": [ ],
- "external_reducer": null,
- "observed_by": [ ],
- "external_observer": null,
- "followup_request_id": 0,
- "assignment_id": 0
}
{- "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
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- 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": "2019-08-24T14:15:22Z",
- "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 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",
- "message": "string",
- "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
}
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "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
}
}
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",
- "message": "string",
- "data": [
- {
- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "required_users_number": 0,
- "id": 0,
- "shift_users_ids": null
}
]
}
Update a shift
shift_id required | integer |
group | any or null The Shift's Group. |
users | Array of any |
shift_users | Array of any |
comments | Array of any |
reminders | Array of any |
name | string or null Name of the shift. |
description | string or null 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 or null 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": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "required_users_number": 0
}
{- "status": "success",
- "message": "string"
}
Add a new shift
group | any or null The Shift's Group. |
users | Array of any |
shift_users | Array of any |
comments | Array of any |
reminders | Array of any |
name | string or null Name of the shift. |
description | string or null 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 or null 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": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "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
}
}
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 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",
- "message": "string",
- "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
}
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "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
}
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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. |
text | string Filter comments by partial text match. |
{- "status": "success",
- "message": "string",
- "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
}
]
}
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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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 or null Annotation's author. |
obj | any or null 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",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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 or null Annotation's author. |
obj | any or null 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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}
retrieve the PhotStat associated with the obj_id.
obj_id required | string object ID to get statistics on |
{- "obj": null,
- "last_update": "2019-08-24T14:15:22Z",
- "last_full_update": "2019-08-24T14:15:22Z",
- "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
}
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",
- "message": "string",
- "data": {
- "mjd": 0,
- "magsys": "jla1",
- "filter": "bessellux",
- "obj_id": "string",
- "instrument_id": 0,
- "assignment_id": null,
- "origin": null,
- "ra": null,
- "dec": null,
- "ra_unc": null,
- "dec_unc": null,
- "alert_id": null,
- "altdata": null,
- "flux": null,
- "fluxerr": 0,
- "zp": 0,
- "ref_flux": null,
- "ref_fluxerr": null,
- "ref_zp": null
}
}
Update photometry
photometry_id required | integer |
mjd required | number MJD of the observation. |
magsys required | any Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude system to which the flux and the zeropoint are tied. |
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. |
obj_id required | string ID of the Object to which the photometry will be attached. |
instrument_id required | integer ID of the instrument with which the observation was carried out. |
assignment_id | integer or null Default: null ID of the classical assignment which generated the photometry |
origin | any or null 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. |
ra | number or null Default: null ICRS Right Ascension of the centroid of the photometric aperture [deg]. |
dec | number or null Default: null ICRS Declination of the centroid of the photometric aperture [deg]. |
ra_unc | number or null Default: null Uncertainty on RA [arcsec]. |
dec_unc | number or null Default: null Uncertainty on dec [arcsec]. |
alert_id | integer or null 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. |
altdata | object or null Default: null Misc. alternative metadata stored in JSON format, e.g. |
mag | number or null Default: null Magnitude of the observation in the magnitude system |
magerr | number or null Default: null Magnitude error of the observation in the magnitude system |
limiting_mag required | number Limiting magnitude of the image in the magnitude system |
magref | any or null Default: null Magnitude of the reference image. in the magnitude system |
e_magref | any or null 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. |
{- "mjd": 0,
- "magsys": "jla1",
- "filter": "bessellux",
- "obj_id": "string",
- "instrument_id": 0,
- "assignment_id": null,
- "origin": null,
- "ra": null,
- "dec": null,
- "ra_unc": null,
- "dec_unc": null,
- "alert_id": null,
- "altdata": null,
- "mag": null,
- "magerr": null,
- "limiting_mag": 0,
- "magref": null,
- "e_magref": null
}
{- "status": "success",
- "message": "string"
}
Update and/or upload photometry, resolving potential duplicates
refresh required | boolean If true, triggers a refresh of the object's photometry on the web page, only for the users that have the object's source page open. |
duplicate_ignore_flux required | boolean If true, will not use the flux/fluxerr of existing rows when looking for duplicates but only mjd, instrument_id, filter, and origin. Reserved to super admin users only, to avoid misuse and permanent data loss. |
overwrite_flux required | boolean If true and duplicate_ignore_flux is also true, will update the flux/fluxerr of existing rows (duplicates) with the new values. Applies only to rows with an origin already specified. If existing duplicates have no origin, the update will be skipped. |
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. |
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: |
obj_id required | any ID of the |
instrument_id required | any ID of the |
assignment_id | integer or null Default: null ID of the classical assignment which generated the photometry |
ra | any or null 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. |
dec | any or null 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. |
ra_unc | any or null 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. |
dec_unc | any or null 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. |
origin | any or null 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. |
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). |
stream_ids | any Default: [] List of stream IDs to which photometry points will be visible. |
altdata | any or null Default: null Misc. alternative metadata stored in JSON format, e.g. |
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: |
mag | any or null Default: null Magnitude of the observation in the magnitude system |
magerr | any or null Default: null Error on the magnitude in the magnitude system |
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. |
magref | any or null Default: null Magnitude of the reference image. in the magnitude system |
e_magref | any or null 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. |
{- "mjd": null,
- "filter": null,
- "obj_id": null,
- "instrument_id": null,
- "assignment_id": null,
- "ra": null,
- "dec": null,
- "ra_unc": null,
- "dec_unc": null,
- "origin": null,
- "group_ids": [ ],
- "stream_ids": [ ],
- "altdata": null,
- "magsys": null,
- "mag": null,
- "magerr": null,
- "limiting_mag": null,
- "limiting_mag_nsigma": 3,
- "magref": null,
- "e_magref": 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",
- "message": "string",
- "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
}
}
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 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) |
instrument_ids | Array of integers or null Default: null IDs of the instruments to query for photometry from. If |
min_date | string or null <date-time> Default: null Query for photometry taken after this UT |
max_date | string or null <date-time> Default: null Query for photometry taken before this UT |
{- "instrument_ids": null,
- "min_date": null,
- "max_date": null
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "mjd": 0,
- "magsys": "jla1",
- "filter": "bessellux",
- "obj_id": "string",
- "instrument_id": 0,
- "assignment_id": null,
- "origin": null,
- "ra": null,
- "dec": null,
- "ra_unc": null,
- "dec_unc": null,
- "alert_id": null,
- "altdata": null,
- "flux": null,
- "fluxerr": 0,
- "zp": 0,
- "ref_flux": null,
- "ref_fluxerr": null,
- "ref_zp": null
}
]
}
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. |
deduplicatePhotometry | boolean Boolean indicating whether to deduplicate photometry. Defaults to false. |
includeOwnerInfo | boolean Boolean indicating whether to include photometry owner. Defaults to false. |
includeStreamInfo | boolean Boolean indicating whether to include photometry stream information. Defaults to false. |
includeValidationInfo | boolean Boolean indicating whether to include photometry validation information. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "mjd": 0,
- "magsys": "jla1",
- "filter": "bessellux",
- "obj_id": "string",
- "instrument_id": 0,
- "assignment_id": null,
- "origin": null,
- "ra": null,
- "dec": null,
- "ra_unc": null,
- "dec_unc": null,
- "alert_id": null,
- "altdata": null,
- "flux": null,
- "fluxerr": 0,
- "zp": 0,
- "ref_flux": null,
- "ref_fluxerr": null,
- "ref_zp": null
}
]
}
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",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "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",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}
Get observation plan requests of the GcnEvent.
gcnevent_id required | string |
{- "status": "success",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
]
}
Get survey efficiency analyses of the GcnEvent.
gcnevent_id required | string |
{- "status": "success",
- "message": "string",
- "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
}
]
}
Get catalog queries of the GcnEvent.
gcnevent_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "id": 0
}
]
}
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
dateobs | any UTC event timestamp |
xml | string VOEvent XML content. |
json | string JSON notice content. |
{- "dateobs": null,
- "xml": "string",
- "json": "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",
- "message": "string",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
}
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 or null The Reminder's Obj. |
user | any or null Reminder's user. |
groups | Array of any |
obj_id required | string ID of the Reminder's Obj. |
text required | string Reminder body. |
origin | string or null 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": "2019-08-24T14:15:22Z",
- "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",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}
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",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}
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",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}
Ingest EarthquakeEvent
sent_by | any or null 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 or null |
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 report
dateobs required | string |
summary_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "sent_by": null,
- "group": null,
- "sent_by_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "data": null,
- "report_name": "string",
- "published": true,
- "id": 0
}
}
Retrieve a GCN summary
dateobs required | string |
summary_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "sent_by": null,
- "group": null,
- "sent_by_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "title": "string",
- "text": "string",
- "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"
}
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
dateobs | any UTC event timestamp |
xml | string VOEvent XML content. |
json | string JSON notice content. |
{- "dateobs": null,
- "xml": "string",
- "json": "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"
}
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",
- "dateobs": "string",
- "flat_2d": [
- 0
], - "contour": null
}
A fits file corresponding to the intersection of the input fits files.
dateobs required | dateobs |
localization_name required | localization_name |
{- "status": "error",
- "message": "string",
- "data": { }
}
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"
}
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"
}
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",
- "message": "string",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
}
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",
- "message": "string",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
]
}
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
}
}
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
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "bio": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "is_bot": true,
- "expiration_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "gcnevents": [
- 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
], - "gcnnotices": [
- null
], - "gcnreports": [
- 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
], - "photometryvalidations": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "tns_submissions": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}
}
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",
- "bio": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "is_bot": true,
- "expiration_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "gcnevents": [
- 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
], - "gcnnotices": [
- null
], - "gcnreports": [
- 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
], - "photometryvalidations": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "tns_submissions": [
- 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
}
}
Ingest GCN xml file
dateobs | any UTC event timestamp |
xml | string VOEvent XML content. |
json | string JSON notice content. |
{- "dateobs": null,
- "xml": "string",
- "json": "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.
gcnevent_id required | integer ID of the GcnEvent. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Observation plan request allocation ID. |
localization_id required | integer Localization ID. |
target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
observation_plan_data | any Observation plan data json |
{- "gcnevent_id": 0,
- "status": "pending submission",
- "allocation_id": 0,
- "localization_id": 0,
- "target_group_ids": [
- 0
], - "observation_plan_data": null
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Submit observation plan request.
gcnevent_id required | integer ID of the GcnEvent. |
payload | any Content of the observation plan request. |
status | string Default: "pending submission" The status of the request. |
allocation_id required | integer Observation plan request allocation ID. |
localization_id required | integer Localization ID. |
target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
{- "gcnevent_id": 0,
- "payload": null,
- "status": "pending submission",
- "allocation_id": 0,
- "localization_id": 0,
- "target_group_ids": [
- 0
]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Get a GCN-izable summary of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}
Submit an observation plan.
observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}
Get a movie summary of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}
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",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}
Get survey efficiency analyses of the observation plan.
observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
]
}
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",
- "message": "string",
- "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,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}
{- "status": "success",
- "message": "string",
- "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
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
}
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
}
}
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"
}
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",
- "bio": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "is_bot": true,
- "expiration_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "gcnevents": [
- 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
], - "gcnnotices": [
- null
], - "gcnreports": [
- 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
], - "photometryvalidations": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "tns_submissions": [
- 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
], - "gcnreports": [
- 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 |
gcnreports | Array of any |
gcnsummaries | Array of any |
name required | string Name of the group. |
nickname | string or null Short group nickname. |
description | string or null Longer description of the group. |
private | boolean Boolean indicating whether group is invisible to non-members. |
single_user_group | boolean or null 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
], - "gcnreports": [
- 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
], - "gcnreports": [
- 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
], - "gcnreports": [
- 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
], - "gcnreports": [
- 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 |
gcnreports | Array of any |
gcnsummaries | Array of any |
name required | string Name of the group. |
nickname | string or null Short group nickname. |
description | string or null Longer description of the group. |
private | boolean Boolean indicating whether group is invisible to non-members. |
single_user_group | boolean or null 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
], - "gcnreports": [
- 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",
- "message": "string",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
}
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",
- "message": "string",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
]
}
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",
- "message": "string",
- "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
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
]
}
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
}
}
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
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "groups": [
- null
], - "users": [
- null
], - "filters": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "altdata": null,
- "id": 0
}
}
Update a stream
stream_id required | integer |
name | string |
altdata | object |
{- "name": "string",
- "altdata": { }
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "groups": [
- null
], - "users": [
- null
], - "filters": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "altdata": null,
- "id": 0
}
]
}
POST a new stream.
name required | string |
altdata | object |
{- "name": "string",
- "altdata": { }
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve a Multimessenger Astronomical Detector (MMADetector)
mmadetector_id required | integer |
{- "status": "success",
- "message": "string",
- "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
}
}
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 or null Latitude in deg. |
lon | number or null Longitude in deg. |
elevation | number or null 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",
- "message": "string",
- "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
}
]
}
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 or null Latitude in deg. |
lon | number or null Longitude in deg. |
elevation | number or null 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",
- "message": "string",
- "data": {
- "detector": null,
- "groups": [
- null
], - "owner": null,
- "frequencies": [
- 0
], - "amplitudes": [
- 0
], - "start_time": "2019-08-24T14:15:22Z",
- "end_time": "2019-08-24T14:15:22Z",
- "detector_id": 0,
- "owner_id": 0,
- "original_file_string": "string",
- "original_file_filename": "string",
- "id": 0
}
}
Update mmadetector spectrum
spectrum_id required | integer |
frequencies required | Array of numbers Frequencies of the spectrum [Hz]. |
amplitudes required | Array of numbers Amplitude of the Spectrum [1/sqrt(Hz). |
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. |
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
{- "frequencies": [
- 0
], - "amplitudes": [
- 0
], - "start_time": "2019-08-24T14:15:22Z",
- "end_time": "2019-08-24T14:15:22Z",
- "detector_id": 0,
- "group_ids": [ ]
}
{- "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
frequencies required | Array of numbers Frequencies of the spectrum [Hz]. |
amplitudes required | Array of numbers Amplitude of the Spectrum [1/sqrt(Hz). |
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. |
group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
{- "frequencies": [
- 0
], - "amplitudes": [
- 0
], - "start_time": "2019-08-24T14:15:22Z",
- "end_time": "2019-08-24T14:15:22Z",
- "detector_id": 0,
- "group_ids": [ ]
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve an mmadetector time_interval
time_interval_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0,
- "owner_id": 0,
- "id": 0
}
}
Update mmadetector time_interval
time_interval_id required | integer |
detector | any or null The MMADetector that acquired the Time Interval. |
groups | Array of any |
owner | any or null 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 or null The MMADetector that acquired the Time Interval. |
groups | Array of any |
owner | any or null 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",
- "message": "string",
- "data": [
- {
- "user": null,
- "obj": null,
- "user_id": 0,
- "obj_id": "string",
- "list_name": "string",
- "params": null,
- "id": 0
}
]
}
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",
- "message": "string",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
}
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",
- "message": "string",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
]
}
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",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2019-08-24T14:15:22Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
]
}
Ingest a set of ExecutedObservations
telescopeName required | string The telescope name associated with the fields |
instrumentName required | string The instrument name associated with the fields |
observationData | any Observation data dictionary list |
{- "telescopeName": "string",
- "instrumentName": "string",
- "observationData": null
}
{- "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",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2019-08-24T14:15:22Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
]
}
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",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "instrument": null,
- "field": null,
- "observation_plan_id": 0,
- "instrument_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "field_id": 0,
- "exposure_time": 0,
- "weight": 0,
- "filt": "string",
- "obstime": "2019-08-24T14:15:22Z",
- "overhead_per_exposure": 0,
- "planned_observation_id": 0,
- "id": 0
}
]
}
Delete 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
start_date required | any start date of the request. |
end_date required | any end date of the request. |
allocation_id required | integer Followup request allocation ID. |
{- "start_date": null,
- "end_date": null,
- "allocation_id": 0
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2019-08-24T14:15:22Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
]
}
Retrieve skymap-based trigger from external API
allocation_id required | string ID for the allocation to retrieve |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "instrument": null,
- "field": null,
- "observation_plan_id": 0,
- "instrument_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "field_id": 0,
- "exposure_time": 0,
- "weight": 0,
- "filt": "string",
- "obstime": "2019-08-24T14:15:22Z",
- "overhead_per_exposure": 0,
- "planned_observation_id": 0,
- "id": 0
}
]
}
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": "2019-08-24T14:15:22Z",
- "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"
}
}
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"
}
Retrieve an observation efficiency analysis
survey_efficiency_analysis_id required | integer |
{- "status": "success",
- "message": "string",
- "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
}
}
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"
}
{- "status": "success",
- "message": "string",
- "data": {
- "instrument_id": 0,
- "pi": "string",
- "observers": "string",
- "duration": 0,
- "group_id": 0,
- "calendar_date": "2019-08-24",
- "owner_id": 0,
- "ephemeris": null,
- "id": 0,
- "assignments": [
- null
], - "instrument": null
}
}
Update observing run
run_id required | integer |
instrument_id required | integer The ID of the instrument to be used in this run. |
pi | string The PI of the observing run. |
observers | string The names of the observers |
duration | integer Number of nights in the observing run |
group_id | integer The ID of the group this run is associated with. |
calendar_date required | string <date> The local calendar date of the run. |
{- "instrument_id": 0,
- "pi": "string",
- "observers": "string",
- "duration": 0,
- "group_id": 0,
- "calendar_date": "2019-08-24"
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "sources": [
- null
], - "group": null,
- "owner": null,
- "assignments": [
- null
], - "instrument_id": 0,
- "pi": "string",
- "observers": "string",
- "duration": 0,
- "group_id": 0,
- "owner_id": 0,
- "calendar_date": "2019-08-24",
- "run_end_utc": "2019-08-24T14:15:22Z",
- "id": 0
}
]
}
Add a new observing run
instrument_id required | integer The ID of the instrument to be used in this run. |
pi | string The PI of the observing run. |
observers | string The names of the observers |
duration | integer Number of nights in the observing run |
group_id | integer The ID of the group this run is associated with. |
calendar_date required | string <date> The local calendar date of the run. |
{- "instrument_id": 0,
- "pi": "string",
- "observers": "string",
- "duration": 0,
- "group_id": 0,
- "calendar_date": "2019-08-24"
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}
Retrieve an observation plan efficiency analysis
survey_efficiency_analysis_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_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"
}
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"
}
Validate or reject a photometric point based on data quality (e.g. examining quality of the image and/or reduction)
photometry_id required | int Photometry ID |
validated required | boolean Whether the source is validated (True) or rejected (False) |
{- "validated": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Deletes the validated or rejected status of a photometric point. Its status can be considered as 'undefined'.
photometric_id required | int |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Update the validated or rejected status of a source in a GCN
photometry_id required | int |
validated required | boolean Whether the photometry is validated (True) or rejected (False) |
{- "validated": true
}
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}
Retrieve a photometric series
photometric_series_id required | integer |
dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
{- "status": "success",
- "message": "string",
- "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
}
}
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
], - "tns_submissions": [
- 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",
- "message": "string",
- "data": {
- "owner": null,
- "owner_id": 0,
- "endpoint": "string",
- "payload": null,
- "method": "string",
- "next_call": "2019-08-24T14:15:22Z",
- "call_delay": 0,
- "number_of_retries": 0,
- "active": true,
- "id": 0
}
}
{- "status": "success",
- "message": "string",
- "data": [
- {
- "owner": null,
- "owner_id": 0,
- "endpoint": "string",
- "payload": null,
- "method": "string",
- "next_call": "2019-08-24T14:15:22Z",
- "call_delay": 0,
- "number_of_retries": 0,
- "active": true,
- "id": 0
}
]
}
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
}
}
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"
}
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 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": { }
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true,
- "id": 0
}
}
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 or null 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",
- "message": "string",
- "data": [
- {
- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true,
- "id": 0
}
]
}
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
}
}
{- "status": "success",
- "message": "string",
- "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
}
}
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 or null Latitude in deg. |
lon | number or null Longitude in deg. |
elevation | number or null Elevation in meters. |
diameter required | number Diameter in meters. |
skycam_link | string or null Link to the telescope's sky camera. |
weather_link | string or null 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"
}
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",
- "message": "string",
- "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
}
]
}
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 or null Latitude in deg. |
lon | number or null Longitude in deg. |
elevation | number or null Elevation in meters. |
diameter required | number Diameter in meters. |
skycam_link | string or null Link to the telescope's sky camera. |
weather_link | string or null 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"
}
}
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "type": "new",
- "file_uri": "string",
- "public_url": "string",
- "origin": "string",
- "obj_id": "string",
- "is_grayscale": true,
- "id": 0
}
}
Update thumbnail
thumbnail_id required | integer |
obj | any or null The Thumbnail's Obj. |
type | string or null <= 6 characters 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 or null Path of the Thumbnail on the machine running SkyPortal. |
public_url | string or null Publically accessible URL of the thumbnail. |
origin | string or null 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"
}
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
}
}
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
}
}
Delete an autoreporter from a TNSRobotGroup
tnsrobot_id required | integer The ID of the TNSRobot |
group_id required | integer The ID of the Group |
user_id required | integer The ID of the User to remove as an autoreporter. If not provided, the user_id will be taken from the request body. |
user_id | integer The ID of the User to remove as an autoreporter |
user_ids | Array of integers The IDs of the Users to remove as autoreporters, overrides user_id |
{- "user_id": 0,
- "user_ids": [
- 0
]
}
{- "status": "success",
- "message": "string"
}
Add or edit a group for a TNS robot
tnsrobot_id required | integer ID of the TNS robot |
group_id required | integer ID of the group to edit |
group_id | integer ID of the group to add |
auto_report | boolean Whether to automatically report to this group |
owner | boolean Whether this group is the owner of the TNS robot |
{- "group_id": 0,
- "auto_report": true,
- "owner": true
}
{- "status": "success",
- "message": "string"
}
{- "status": "success",
- "message": "string",
- "data": {
- "instruments": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "coauthors": [
- null
], - "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "acknowledgments": "string",
- "report_existing": true,
- "testing": true,
- "photometry_options": null,
- "id": 0,
- "submissions": [
- null
]
}
}
Post or update a TNS robot
instruments | Array of any |
streams | Array of any |
groups | Array of any |
coauthors | Array of any |
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 or null |
acknowledgments | string Acknowledgments to use for this robot. |
report_existing | boolean Whether to still report objects that are already in the TNS, but not reported with this object internal name (i.e., reported by another survey). |
testing | boolean If true, robot will not report to TNS and only store the request's payload. |
photometry_options | any or null Photometry options to use for this robot, to make some data optional or mandatory for manual and auto-reporting. |
submissions | Array of any |
{- "instruments": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "coauthors": [
- null
], - "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "acknowledgments": "string",
- "report_existing": true,
- "testing": true,
- "photometry_options": null,
- "submissions": [
- null
]
}
{- "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"
}
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 all public pages for a given source from the most recent to the oldest
source_id required | string The ID of the source for which to retrieve the public page |
{- "status": "success",
- "message": "string"
}
Create a public page for a source, with given options, only if this page does not already exist
source_id required | string The ID of the source from which to create a public page |
options | object Options to manage data to display publicly |
release_id | integer The ID of the public release where the public source page belongs |
{- "options": { },
- "release_id": 0
}
{- "status": "success",
- "message": "string"
}
Create a new public release
name | string |
link_name | string |
group_ids | integer |
description | string |
options | object |
is_visible | boolean |
{- "name": "string",
- "link_name": "string",
- "group_ids": 0,
- "description": "string",
- "options": { },
- "is_visible": true
}
{- "status": "success",
- "message": "string"
}
Update a public release
release_id required | integer |
name | string |
group_ids | Array of integers |
description | string |
options | object |
is_visible | boolean |
{- "name": "string",
- "group_ids": [
- 0
], - "description": "string",
- "options": { },
- "is_visible": true
}
{- "status": "success",
- "message": "string"
}
Display the public page for a given source and version
source_id required | string The ID of the source for which to display the public page |
version_hash required | string The hash of the source data used to identify the version |
{- "status": "error",
- "message": "string",
- "data": { }
}
Display the public page for a given source and version in a specific release
release_name required | string The link name of the public release to display |
source_id required | string The ID of the source for which to display the public page |
version_hash required | string The hash of the source data used to identify the version |
{- "status": "error",
- "message": "string",
- "data": { }
}
Display the page with all sources and descriptions for a given public release
link_name required | string The link name of the public release to display |
{- "status": "error",
- "message": "string",
- "data": { }
}
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 |
{- "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 |
{- "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 |
{- "status": "error",
- "message": "string",
- "data": { }
}
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 |
{- "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 |
{- "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 |
{- "status": "error",
- "message": "string",
- "data": { }
}
lc_id required | string |
catalog required | str |
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") |
{- "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"
}
}
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") |
{- "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"
}
POST a new filter version.
stream | any or null The Filter's Stream. |
group | any or null 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": [
- { }
]
}
}
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 | dict automatically save passing candidates to filter's group |
update_annotations | boolean update annotations for existing candidates |
auto_followup | boolean | dict automatically create follow-up requests for passing and autosaved candidates |
{- "filter_id": 1,
- "active": true,
- "active_fid": "string",
- "autosave": null,
- "update_annotations": true,
- "auto_followup": null
}
{- "status": "success",
- "message": "string"
}
lc_id required | string |
catalog required | str |
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") |
{- "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"
}
}
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") |
{- "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"
}