Update a Document

PATCH 
/documents/:id

Updates a Datasphere Document by ID

Request

Path Parameters

id uuidrequired

Unique ID of a Document.

application/json

Body

required

tagsstring[]
Document tags.
Example: ["sports","football","game"]

Responses

200

The request has succeeded.

application/json

Schema

Schema

iduuidrequired

Unique ID of a Document.

filenamestringrequired
Name of the Document.
Example: player_list.pdf
statusDocumentStatus (string)required

The current Status of the Document.

Possible values: [submitted, in_progress, completed, failed]

tagsstring[]required
Document tags.
Example: ["sports","football","game"]
chunking_strategyChunkingStrategy (string)required

Strategy to use when chunking the document.

Possible values: [sentence, paragraph, page, sliding]

max_sentences_per_chunkstringrequired
Max Sentences per Chunk (only used for chunking type 'sentence')
Example: 80
split_newlinesbooleanrequired
Split on Newlines (only used for chunking type 'sentence')
Example: true
overlap_sizestringrequired
Overlap Size (only used for chunking type 'sliding')
Example: 10
chunk_sizestringrequired
Chunk Size (only used for chunking type 'sliding')
Example: 50
number_of_chunksintegerrequired
Number of Chunks in the Document.
Example: 2345
created_atdate-timerequired
Document Creation Date.
Example: 2024-05-06T12:20-12Z
updated_atdate-timerequired
Document Update Date.
Example: 2024-05-06T12:20-12Z

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "filename": "player_list.pdf",
  "status": "submitted",
  "tags": [
    "sports",
    "football",
    "game"
  ],
  "chunking_strategy": "sentence",
  "max_sentences_per_chunk": "80",
  "split_newlines": true,
  "overlap_size": "10",
  "chunk_size": "50",
  "number_of_chunks": 2345,
  "created_at": "2024-05-06T12:20-12Z",
  "updated_at": "2024-05-06T12:20-12Z"
}

401

Access is unauthorized.

application/json

Schema

Schema

string

Possible values: [Unauthorized]

404

The server cannot find the requested resource.

application/json

Schema

Schema

string

Possible values: [Not Found]

422

Client error

application/json

Schema

Schema

errors

object[]

required

Array [

typestringrequired

Error type.

codestringrequired

Error code.

messagestringrequired

Error details.

attributestringrequired

Request parameter associated with this error.

urlstringrequired

Link to developer resource for this error.

]

Example (from schema)

{
  "errors": [
    {
      "type": "validation_error",
      "code": "invalid_parameter",
      "message": "Invalid tags",
      "attribute": "tags",
      "url": "https://developer.signalwire.com/rest/overview/error-codes#{code}"
    }
  ]
}