Create a Document
POST/documents
Creates a Datasphere Document
Request
- application/json
Body
required
- Sentence strategy
- Sliding strategy
- Page strategy
- Paragraph strategy
oneOf
Default value: 50
Maximum number of sentences per chunk.
Possible values: [sentence
]
Strategy for chunking the document
Whether to split chunks on new lines.
Default value: false
URL of the document.
Document tags.
Default value: 50
Number of words per chunk.
Possible values: [sliding
]
Strategy for chunking the document
Default value: 10
Amount of overlap between chunks, in number of words.
URL of the document.
Document tags.
Possible values: [page
]
Strategy for chunking the document
URL of the document.
Document tags.
Possible values: [paragraph
]
Strategy for chunking the document
URL of the document.
Document tags.
Responses
- 201
- 401
- 404
- 422
The request has succeeded and a new resource has been created as a result.
- application/json
- Schema
- Example (from schema)
Schema
Unique ID of a Document.
Name of the Document.
Possible values: [submitted
, in_progress
, completed
, failed
]
The current Status of the Document.
Document tags.
Possible values: [sentence
, paragraph
, page
, sliding
]
Strategy to use when chunking the document.
Max Sentences per Chunk (only used for chunking type 'sentence')
Split on Newlines (only used for chunking type 'sentence')
Overlap Size (only used for chunking type 'sliding')
Chunk Size (only used for chunking type 'sliding')
Number of Chunks in the Document.
Document Creation Date.
Document Update Date.
{
"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"
}
Access is unauthorized.
- application/json
- Schema
Schema
string
Possible values: [Unauthorized
]
The server cannot find the requested resource.
- application/json
- Schema
Schema
string
Possible values: [Not Found
]
Client error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
required
Error type.
Error code.
Error details.
Request parameter associated with this error.
Link to developer resource for this error.
{
"errors": [
{
"type": "validation_error",
"code": "invalid_parameter",
"message": "Invalid chunking_strategy",
"attribute": "chunking_strategy",
"url": "https://developer.signalwire.com/rest/overview/error-codes#{code}"
}
]
}