Skip to main content
System metagraph view

​
1. Upload documents to the system

Upload PDFs, schematics, specs, or any reference files that describe your system. Atlas will use these to build the metagraph. 
curl -X POST "https://spacex.atlas.arenaphysica.com/api/v1/systems/upload_document?system_id=$SYSTEM_ID" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -F "file=@system_spec.pdf" \
  -F 'metadata={"file_name": "system_spec.pdf", "file_type": "pdf"}'
You can upload multiple documents in separate requests. Each becomes part of the system’s document store.

​
2. Create a metagraph update job

Create a job that instructs Atlas to read the uploaded documents and update the metagraph. 
curl -X POST "https://spacex.atlas.arenaphysica.com/api/v1/jobs" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "job_type": "metagraph_update",
    "config": {
      "job_type": "metagraph_update",
      "system_id_or_name": "<system_id>",
      "additional_context": "Focus on the power distribution subsystem and its interfaces."
    }
  }'
Save the uuid from the response: 
export JOB_ID="<uuid from response>"
additional_context is optional. Use it to scope or guide the analysis when you have a specific part of the system you want Atlas to model.

​
3. Start the job run

curl -X POST "https://spacex.atlas.arenaphysica.com/api/v1/job-runs" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"job_id\": \"$JOB_ID\"}"
Save the uuid from the response: 
export JOB_RUN_ID="<uuid from response>"

​
4. Poll for completion

curl "https://spacex.atlas.arenaphysica.com/api/v1/job-runs/$JOB_RUN_ID" \
  -H "Authorization: Bearer $ATLAS_TOKEN"
The status field will transition through pending → running → completed (or failed). Poll until you see a terminal state.

​
5. Inspect the metagraph

Once the job completes, fetch the result: 
curl "https://spacex.atlas.arenaphysica.com/api/v1/systems/$SYSTEM_ID/metagraph" \
  -H "Authorization: Bearer $ATLAS_TOKEN"
The response includes the full graph of entities and relationships Atlas has built from your documents.