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

fileobjectrequired

kindstring · enumrequiredAvailable options:

Responses

application/json

objectoptional

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"
}