Files

Get file metadata

Changed on

Retrieves metadata information for a specific file including size, type, and custom metadata

get/v1/files/{fileId}/metadata

Request

  • Base URL: https://api.printhiv3d.com
  • URL: https://api.printhiv3d.com/v1/files/{fileId}/metadata
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

fileIdstring required

The unique identifier of the file

Query parameters

print_job_idstring
printer_task_idstring uuid
claim_generationstring uuid
printer_task_access_tokenstring uuid

Response

File metadata object

organization_idstring
lifecycle_status'queued' | 'processing' | 'ready' | 'failed'
is_printableboolean nullable
content_hashstring nullable
revnumber
idstring required

Unique identifier for the file

created_atstring date-time nullable

When the file was created

created_bystring nullable

User ID who created the file

filenamestring required

Original name of the file

file_pathstring required

Storage path of the file

file_typestring required

MIME type of the file

file_sizenumber required

Size of the file in bytes

model_idstring required

Associated 3D model ID

metadataobject required

Additional metadata associated with the file

activePlateNumbernumber

Active plate number

Changes

  • 1d5d439c2b20Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 85dda1277de0Revision changes
    • info

      added the new optional query request parameter claim_generation

    • info

      added the new optional query request parameter print_job_id

    • info

      added the new optional query request parameter printer_task_access_token

    • info

      added the new optional query request parameter printer_task_id