Populating the System Metagraph

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://nokia.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://nokia.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://nokia.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://nokia.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://nokia.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.

Introduction

Getting Started

Guides

Populating the System Metagraph

1. Upload documents to the system

2. Create a metagraph update job

3. Start the job run

4. Poll for completion

5. Inspect the metagraph

​1. Upload documents to the system

​2. Create a metagraph update job

​3. Start the job run

​4. Poll for completion

​5. Inspect the metagraph

1. Upload documents to the system

2. Create a metagraph update job

3. Start the job run

4. Poll for completion

5. Inspect the metagraph