> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fastino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use https://docs.fastino.ai/llms.txt to discover and navigate pages. Use https://docs.fastino.ai/llms-full.txt when you need the complete documentation corpus. Use https://docs.fastino.ai/openapi.json as the source of truth for customer-facing routes. For GLiDE decision inference, call POST https://api.fastino.ai/v1/systemone with model fastino/GLiDE. Start managed training (config job) with POST /v1/training/jobs using base_model. For interactive training, native JSON clients use the public operations under /v1/training/jobs and /v1/training/usage. Existing Tinker clients use tinker==0.32.0 with TINKER_BASE_URL=https://api.fastino.ai/v1/training/compat/tinker and TINKER_CREDENTIAL_CMD. Compatibility child routes are private and absent from OpenAPI. Auto Train is private access and has no public route; direct interested users to sales@fastino.ai. Do not infer undocumented routes. Read API keys from FASTINO_API_KEY and never embed credentials in code, logs, or reports.

# Create a dataset upload URL

> Create a presigned upload URL with POST /v1/datasets/upload/url, upload the file as application/octet-stream, then process it with the returned dataset_id.

`POST /v1/datasets/upload/url`

Create a presigned upload URL for a new dataset file.

## Bind the URL to the file

Optionally send `content_length` (the exact byte count, up to 5 GiB) and
`sha256` (a 64-character hexadecimal digest). Storage then rejects a PUT whose
size or digest differs, which catches truncated and corrupted uploads before
processing.

```bash theme={null}
CONTENT_LENGTH="$(wc -c < training.jsonl | tr -d ' ')"
SHA256="$(shasum -a 256 training.jsonl | awk '{print $1}')"

curl --fail-with-body -sS https://api.fastino.ai/v1/datasets/upload/url \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(jq -n \
    --argjson content_length "$CONTENT_LENGTH" \
    --arg sha256 "$SHA256" \
    '{
      dataset_name: "docs-example-ner",
      filename: "training.jsonl",
      dataset_type: "ner",
      content_length: $content_length,
      sha256: $sha256
    }')" > dataset-upload.json
```

## Upload the file

Upload the exact file bytes to `presigned_url` before it expires. Copy every
entry in the response's `upload_headers` object exactly. The object always
contains `Content-Type: application/octet-stream`; when you declared
`content_length` and `sha256`, it also contains the signed `Content-Length` and
`x-amz-checksum-sha256` values. A missing or changed signed header returns
`403`.

```bash theme={null}
PRESIGNED_URL="$(jq -r '.presigned_url' dataset-upload.json)"

curl --fail-with-body -X PUT \
  -H "Content-Type: $(jq -r '.upload_headers["Content-Type"]' dataset-upload.json)" \
  -H "Content-Length: $(jq -r '.upload_headers["Content-Length"]' dataset-upload.json)" \
  -H "x-amz-checksum-sha256: $(jq -r '.upload_headers["x-amz-checksum-sha256"]' dataset-upload.json)" \
  --upload-file training.jsonl "$PRESIGNED_URL"
```

Most HTTP clients calculate `Content-Length` from the body, but it must still
match the signed value.

After the upload succeeds, pass the returned `dataset_id` to
[`POST /v1/datasets/upload/process`](https://docs.fastino.ai/api-reference/datasets/process-upload).

## Authorization

Requires the Owner, Admin, or Editor team role. Other roles receive `403 Forbidden`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.