Storage

Upload and store files directly within your GitBook organization.

Whether you're hosting images, documents, or other assets, Storage endpoints allow you to integrate those files into your documentation and spaces seamlessly.

Create a signed URL to upload a file

post

Generate a pre-signed URL that can be used to upload a file to storage

Authorizations

Path parameters

organizationIdstringRequired

The unique id of the organization

Body

kindstring · enumRequiredPossible values:

Responses

201

Successfully generated signed URL for file upload

application/json

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

POST /v1/orgs/{organizationId}/storage/upload HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "file": {
    "name": "text",
    "type": "text",
    "size": 1
  },
  "kind": "customization_font"
}

{
  "object": "storage-signed-url",
  "url": "https://example.com",
  "key": "text"
}