v3

latestOpenAPI 3.1.02026-08-0797185285.8 KB

Post Source

Creates a source in the Isometric system. The client is provided with a presigned upload URL which must be used to upload the document associated with this source. Source documents are private, but other fields will be visible publicly once credits are issued for an associated removal, moving it to the public registry.

post/sources

Headers

x-client-secretstring required

A secret token identifying the client connecting to the API

Example:Syou3EZiO5vuMEgNyBeA8cjEMYOnQDwP

A secret token identifying the client connecting to the API

Request body

supplier_reference_idstring required

A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.

__typename'CreateDocumentSourceRequest' required

Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.

display_namestring required

published_atstring date required

Date in ISO format (YYYY-MM-DD)

descriptionstring nullable

A description of the source document. Must be at most 2000 characters long.

is_publicboolean

If the source document should be publicly available on the Registry once credits are issued.

file_namestring required

The full name of the file that will be uploaded, including its file extension

content_typestring required

The content type of the file that will be uploaded. This must also be passed as a Content-Type header during the upload. The pre-signed URL will only accept a file of this content-type. See the list of supported filetypes.

content_lengthinteger required

The size (in bytes) of the file that will be uploaded. The pre-signed URL will only accept a file of this size.

project_idstring required

The ID of the project that the source is associated with.

Example request

{
  "project_id": "prj_1CTWZQGKE1S0VAXA"
}

Response

Successful Response

signed_upload_urlstring required

A presigned upload URL, which must be used to upload the document associated with this source.

Example response

{
  "source": {
    "id": "src_1EBBF4M7X1S06G1Y",
    "project_id": "prj_1CTWZQGKE1S0VAXA"
  }
}