Files

Details of a single file in a model

Changed on
get/models/{model_id}/model_files/{id}

Request

  • Base URL
    https://try.manyfold.app
  • Auth
    OAuth 2
    Client credentials
    Token URL: /oauth/token scopes: public, read

Response

Success

@idstring required
@typestring required
namestring
encodingFormatstring required
contentUrlstring
updateContentUrlstring

A signed URL that can be used to save back edited file contents via a PUT request. Signature is valid for 1 hour. Only included if user has write permissions to the file.

contentSizeinteger
filenamestring
descriptionstring
captionstring
presupportedboolean
up'+y' | '+z'
previewableboolean

Example response

{
  "@id": "https://example.com/models/abc123/model_files/def456",
  "@type": "3DModel",
  "name": "Benchy",
  "encodingFormat": "model/stl",
  "contentUrl": "https://example.com/models/abc123/model_files/def456.stl",
  "updateContentUrl": "https://example.com/models/abc123/model_files/def456.stl?sig=fdsklfjdksl",
  "contentSize": 12345,
  "isPartOf": {
    "@id": "https://example.com/models/abc123",
    "@type": "3DModel"
  },
  "spdx:license": {
    "@type": "spdx:License",
    "@id": "http://spdx.org/licenses/MIT",
    "licenseId": "MIT"
  },
  "creator": {
    "@id": "https://example.com/creators/abc123",
    "@type": "Organization"
  },
  "filename": "model.stl",
  "description": "Lorem ipsum dolor sit amet...",
  "caption": "A short caption describing the file",
  "presupported": true,
  "up": "+y",
  "related": [
    {
      "@id": "https://example.com/models/abc123/model_files/def456",
      "@type": "3DModel",
      "relationship": "presupported_version"
    }
  ]
}

Changes