Access & authentication.

Get an API key

Ask your deployment administrator for an API key, the service URL, and the permissions and limits assigned to your account. Send the key as X-API-Key on each request. Keep keys out of source code and shared notebooks.

Service addresses

REST base: https://www.giuliaAPI.com/api
MCP endpoint: https://www.giuliaAPI.com/mcp

In the Python quickstart, set base to the service origin and replace your-api-key in the X-API-Key header.

Choose a workspace

Start by creating a simulation. The service creates or reuses a workspace automatically. Keep the returned sim_id and pass it explicitly on later calls.

If your administrator provides an existing workspace, select it with the X-Workspace-ID header. Workspace management endpoints may require operator permissions; they are not required for the quickstart.

Make your first request

Run the Python quickstart or connect an MCP client. For rejected credentials or permissions, see troubleshooting.