REST API

The service has two HTTP POST endpoints - Request and Handle.

Request

Use this endpoint to send requests to the service.

Property	Type	Description
`source_url`	`string`	The USD stage to process, or a folder containing usd files.
`destination_url`	`string`	Destination url in case of modifications.
`recurse`	`boolean`	If a folder is provided as a source, process all files in the folder.

Response

Property	Type	Description
`status`	`string`	Response message. Whether the request was computed successfully.

Handle

Handle for events from the Nucleus Transport service.

Property	Type	Description
`status`	`str`	Status, OK if this is a specific event, otherwise an indicator of the state of the connection or interaction
`ts`	`dict`	A dictionary of timestamps
`event`	`str`	Event type, e.g. full, create, delete, rename, copy, etc.
`entry`	`dict`	Data about the event including path, branch, timestamps, etc (see below).

Example of “entry” dict as provided by Nucleus transport service.

{
  "status": "OK",
  "ts": {
    "omni_server_out_ts": 1669143047098863
  },
  "entries": [
    {
      "path": "/example.usda",
      "branch": "default",
      "etag": "80673",
      "acl": [
        "read"
      ],
      "created_timestamp": 1661213560,
      "modified_timestamp": 1661213560,
      "path_type": "asset",
      "size": 2383,
      "empty": true,
      "mounted": false,
      "created_by": "user",
      "modified_by": "user",
      "hash_type": "sha-256-flat",
      "hash_value": "939af80fb68fff443d4270c481b2d58578a4ccc211e137e675b5e174f86e76dd",
      "hash_bsize": 1048576,
      "checkpointed": true,
      "transaction_id": 68808,
      "checkpoint_count": 1
    }
  ]
}