Prepare for the PgBouncer and IPv4 deprecations on 26th January 2024

Supabase Storage API

API documentation for Supabase Storage

Object

Handle POST request for TUS Resumable uploads

postapiv0/upload/resumable/

Responses

Default Response

Handle OPTIONS request for TUS Resumable uploads

optionsapiv0/upload/resumable/

Responses

Default Response

Handle POST request for TUS Resumable uploads

postapiv0/upload/resumable/{wildcard}

Responses

Default Response

Handle PUT request for TUS Resumable uploads

putapiv0/upload/resumable/{wildcard}

Responses

Default Response

Handle PATCH request for TUS Resumable uploads

patchapiv0/upload/resumable/{wildcard}

Responses

Default Response

Handle OPTIONS request for TUS Resumable uploads

optionsapiv0/upload/resumable/{wildcard}

Responses

Default Response

Delete an object

deleteapiv0/object/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "examples": [
          "Successfully deleted"
        ]
      }
    }
  }
}

Update the object at an existing key

putapiv0/object/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "Id": {
        "type": "string"
      },
      "Key": {
        "type": "string",
        "examples": [
          "avatars/folder/cat.png"
        ]
      }
    },
    "required": [
      "Key"
    ]
  }
}

Upload a new object

postapiv0/object/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "Id": {
        "type": "string"
      },
      "Key": {
        "type": "string",
        "examples": [
          "avatars/folder/cat.png"
        ]
      }
    },
    "required": [
      "Key"
    ]
  }
}

Delete multiple objects

deleteapiv0/object/{bucketName}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "bucket_id": {
          "type": "string"
        },
        "owner": {
          "type": "string"
        },
        "owner_id": {
          "type": "string"
        },
        "version": {
          "type": "string"
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_accessed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "metadata": {
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": true
            },
            {
              "type": "null"
            }
          ]
        },
        "buckets": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "owner": {
              "type": "string"
            },
            "public": {
              "type": "boolean"
            },
            "file_size_limit": {
              "type": [
                "null",
                "integer"
              ]
            },
            "allowed_mime_types": {
              "type": [
                "null",
                "array"
              ],
              "items": {
                "type": "string"
              }
            },
            "created_at": {
              "type": "string"
            },
            "updated_at": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "name"
          ],
          "additionalProperties": false,
          "examples": [
            {
              "id": "bucket2",
              "name": "bucket2",
              "public": false,
              "file_size_limit": 1000000,
              "allowed_mime_types": [
                "image/png",
                "image/jpeg"
              ],
              "owner": "4d56e902-f0a0-4662-8448-a4d9e643c142",
              "created_at": "2021-02-17T04:43:32.770206+00:00",
              "updated_at": "2021-02-17T04:43:32.770206+00:00"
            }
          ]
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": false,
      "examples": [
        {
          "name": "folder/cat.png",
          "bucket_id": "avatars",
          "owner": "317eadce-631a-4429-a0bb-f19a7a517b4a",
          "id": "eaa8bdb5-2e00-4767-b5a9-d2502efe2196",
          "updated_at": "2021-04-06T16:30:35.394674+00:00",
          "created_at": "2021-04-06T16:30:35.394674+00:00",
          "last_accessed_at": "2021-04-06T16:30:35.394674+00:00",
          "metadata": {
            "size": 1234
          }
        }
      ],
      "title": "objectSchema"
    }
  }
}

Retrieve an object

getapiv0/object/authenticated/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Generate a presigned url to upload an object

postapiv0/object/upload/sign/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "examples": [
          "/object/sign/upload/avatars/folder/cat.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJhdmF0YXJzL2ZvbGRlci9jYXQucG5nIiwiaWF0IjoxNjE3NzI2MjczLCJleHAiOjE2MTc3MjcyNzN9.s7Gt8ME80iREVxPhH01ZNv8oUn4XtaWsmiQ5csiUHn4"
        ]
      }
    },
    "required": [
      "url"
    ]
  }
}

Uploads an object via a presigned URL

putapiv0/object/upload/sign/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "Key": {
        "type": "string",
        "examples": [
          "avatars/folder/cat.png"
        ]
      }
    },
    "required": [
      "Key"
    ]
  }
}

Generate a presigned url to retrieve an object

postapiv0/object/sign/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "signedURL": {
        "type": "string",
        "examples": [
          "/object/sign/avatars/folder/cat.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJhdmF0YXJzL2ZvbGRlci9jYXQucG5nIiwiaWF0IjoxNjE3NzI2MjczLCJleHAiOjE2MTc3MjcyNzN9.s7Gt8ME80iREVxPhH01ZNv8oUn4XtaWsmiQ5csiUHn4"
        ]
      }
    },
    "required": [
      "signedURL"
    ]
  }
}

Retrieve an object via a presigned URL

getapiv0/object/sign/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Generate presigned urls to retrieve objects

postapiv0/object/sign/{bucketName}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "error": {
          "error": [
            "string",
            "null"
          ],
          "examples": [
            "Either the object does not exist or you do not have access to it"
          ]
        },
        "path": {
          "type": "string",
          "examples": [
            "folder/cat.png"
          ]
        },
        "signedURL": {
          "type": [
            "null",
            "string"
          ],
          "examples": [
            "/object/sign/avatars/folder/cat.png?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cmwiOiJhdmF0YXJzL2ZvbGRlci9jYXQucG5nIiwiaWF0IjoxNjE3NzI2MjczLCJleHAiOjE2MTc3MjcyNzN9.s7Gt8ME80iREVxPhH01ZNv8oUn4XtaWsmiQ5csiUHn4"
          ]
        }
      },
      "required": [
        "error",
        "path",
        "signedURL"
      ]
    }
  }
}

Moves an object

postapiv0/object/move

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "examples": [
          "Successfully moved"
        ]
      }
    },
    "required": [
      "message"
    ]
  }
}

Search for objects under a prefix

postapiv0/object/list/{bucketName}

Path parameters

  • bucketName
    REQUIRED
    Example:

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "bucket_id": {
          "type": "string"
        },
        "owner": {
          "type": "string"
        },
        "owner_id": {
          "type": "string"
        },
        "version": {
          "type": "string"
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_accessed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "metadata": {
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": true
            },
            {
              "type": "null"
            }
          ]
        },
        "buckets": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "owner": {
              "type": "string"
            },
            "public": {
              "type": "boolean"
            },
            "file_size_limit": {
              "type": [
                "null",
                "integer"
              ]
            },
            "allowed_mime_types": {
              "type": [
                "null",
                "array"
              ],
              "items": {
                "type": "string"
              }
            },
            "created_at": {
              "type": "string"
            },
            "updated_at": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "name"
          ],
          "additionalProperties": false,
          "examples": [
            {
              "id": "bucket2",
              "name": "bucket2",
              "public": false,
              "file_size_limit": 1000000,
              "allowed_mime_types": [
                "image/png",
                "image/jpeg"
              ],
              "owner": "4d56e902-f0a0-4662-8448-a4d9e643c142",
              "created_at": "2021-02-17T04:43:32.770206+00:00",
              "updated_at": "2021-02-17T04:43:32.770206+00:00"
            }
          ]
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": false,
      "examples": [
        {
          "name": "folder/cat.png",
          "bucket_id": "avatars",
          "owner": "317eadce-631a-4429-a0bb-f19a7a517b4a",
          "id": "eaa8bdb5-2e00-4767-b5a9-d2502efe2196",
          "updated_at": "2021-04-06T16:30:35.394674+00:00",
          "created_at": "2021-04-06T16:30:35.394674+00:00",
          "last_accessed_at": "2021-04-06T16:30:35.394674+00:00",
          "metadata": {
            "size": 1234
          }
        }
      ]
    }
  }
}

Retrieve object info

getapiv0/object/info/authenticated/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Copies an object

postapiv0/object/copy

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "Key": {
        "type": "string",
        "examples": [
          "folder/destination.png"
        ]
      }
    },
    "required": [
      "Key"
    ]
  }
}

Retrieve an object from a public bucket

getapiv0/object/public/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Get object info

getapiv0/object/info/public/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Default Response

{
  "schema": {
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Render an authenticated image with the given transformations

getapiv0/render/image/authenticated/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Render an authenticated image with the given transformations

getapiv0/render/image/sign/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Render a public image with the given transformations

getapiv0/render/image/public/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Responses

Error response

{
  "schema": {
    "description": "Error response",
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Bucket

Create a bucket

postapiv0/bucket/

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "examples": [
          "avatars"
        ]
      }
    },
    "required": [
      "name"
    ]
  }
}

Gets all buckets

getapiv0/bucket/

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "owner": {
          "type": "string"
        },
        "public": {
          "type": "boolean"
        },
        "file_size_limit": {
          "type": [
            "null",
            "integer"
          ]
        },
        "allowed_mime_types": {
          "type": [
            "null",
            "array"
          ],
          "items": {
            "type": "string"
          }
        },
        "created_at": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name"
      ],
      "additionalProperties": false,
      "examples": [
        {
          "id": "bucket2",
          "name": "bucket2",
          "public": false,
          "file_size_limit": 1000000,
          "allowed_mime_types": [
            "image/png",
            "image/jpeg"
          ],
          "owner": "4d56e902-f0a0-4662-8448-a4d9e643c142",
          "created_at": "2021-02-17T04:43:32.770206+00:00",
          "updated_at": "2021-02-17T04:43:32.770206+00:00"
        }
      ],
      "title": "bucketSchema"
    }
  },
  "example": [
    {
      "id": "avatars",
      "name": "avatars",
      "owner": "4d56e902-f0a0-4662-8448-a4d9e643c142",
      "public": false,
      "file_size_limit": 1000000,
      "allowed_mime_types": [
        "image/png",
        "image/jpeg"
      ],
      "created_at": "2021-02-17T04:43:32.770206+00:00",
      "updated_at": "2021-02-17T04:43:32.770206+00:00"
    }
  ]
}

Empty a bucket

postapiv0/bucket/{bucketId}/empty

Path parameters

  • bucketId
    REQUIRED
    Example:avatars

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "examples": [
          "Successfully emptied"
        ]
      }
    }
  }
}

Get details of a bucket

getapiv0/bucket/{bucketId}

Path parameters

  • bucketId
    REQUIRED
    Example:avatars

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "name": {
        "type": "string"
      },
      "owner": {
        "type": "string"
      },
      "public": {
        "type": "boolean"
      },
      "file_size_limit": {
        "type": [
          "null",
          "integer"
        ]
      },
      "allowed_mime_types": {
        "type": [
          "null",
          "array"
        ],
        "items": {
          "type": "string"
        }
      },
      "created_at": {
        "type": "string"
      },
      "updated_at": {
        "type": "string"
      }
    },
    "required": [
      "id",
      "name"
    ],
    "additionalProperties": false
  },
  "example": {
    "id": "bucket2",
    "name": "bucket2",
    "public": false,
    "file_size_limit": 1000000,
    "allowed_mime_types": [
      "image/png",
      "image/jpeg"
    ],
    "owner": "4d56e902-f0a0-4662-8448-a4d9e643c142",
    "created_at": "2021-02-17T04:43:32.770206+00:00",
    "updated_at": "2021-02-17T04:43:32.770206+00:00"
  }
}

Update properties of a bucket

putapiv0/bucket/{bucketId}

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "examples": [
          "Successfully updated"
        ]
      }
    },
    "required": [
      "message"
    ]
  }
}

Delete a bucket

deleteapiv0/bucket/{bucketId}

Path parameters

  • bucketId
    REQUIRED
    Example:avatars

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Successful response

{
  "schema": {
    "description": "Successful response",
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "examples": [
          "Successfully deleted"
        ]
      }
    }
  }
}

Deprecated

Get object

getapiv0/object/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Default Response

{
  "schema": {
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}

Retrieve object info

getapiv0/object/info/{bucketName}/{wildcard}

Path parameters

  • bucketName
    REQUIRED
    Example:avatars
  • *
    REQUIRED
    Example:folder/cat.png

Header parameters

  • authorizationrequired
    Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24ifQ.625_WdcF3KHqz5amU0x2X5WWHP-OEs_4qj0ssLNHzTs

Responses

Default Response

{
  "schema": {
    "type": "object",
    "properties": {
      "statusCode": {
        "type": "string"
      },
      "error": {
        "type": "string"
      },
      "message": {
        "type": "string"
      }
    },
    "required": [
      "statusCode",
      "error",
      "message"
    ],
    "title": "errorSchema"
  }
}