curl --request PATCH \
--url https://app.orgo.space/api/v1/drives/{id}/share \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/merge-patch+json' \
--data '
{
"title": "Volunteer Coordinator",
"owner": "/api/v1/users/1",
"unit": "/api/v1/units/1",
"isTenantFeatured": true,
"parent": "/api/v1/drives/1",
"type": "MEMBER",
"docContent": "string",
"wordCount": 12,
"personalUser": "/api/v1/users/1"
}
'import requests
url = "https://app.orgo.space/api/v1/drives/{id}/share"
payload = {
"title": "Volunteer Coordinator",
"owner": "/api/v1/users/1",
"unit": "/api/v1/units/1",
"isTenantFeatured": True,
"parent": "/api/v1/drives/1",
"type": "MEMBER",
"docContent": "string",
"wordCount": 12,
"personalUser": "/api/v1/users/1"
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/merge-patch+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/merge-patch+json'},
body: JSON.stringify({
title: 'Volunteer Coordinator',
owner: '/api/v1/users/1',
unit: '/api/v1/units/1',
isTenantFeatured: true,
parent: '/api/v1/drives/1',
type: 'MEMBER',
docContent: 'string',
wordCount: 12,
personalUser: '/api/v1/users/1'
})
};
fetch('https://app.orgo.space/api/v1/drives/{id}/share', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/drives/{id}/share",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Volunteer Coordinator',
'owner' => '/api/v1/users/1',
'unit' => '/api/v1/units/1',
'isTenantFeatured' => true,
'parent' => '/api/v1/drives/1',
'type' => 'MEMBER',
'docContent' => 'string',
'wordCount' => 12,
'personalUser' => '/api/v1/users/1'
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/merge-patch+json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/drives/{id}/share"
payload := strings.NewReader("{\n \"title\": \"Volunteer Coordinator\",\n \"owner\": \"/api/v1/users/1\",\n \"unit\": \"/api/v1/units/1\",\n \"isTenantFeatured\": true,\n \"parent\": \"/api/v1/drives/1\",\n \"type\": \"MEMBER\",\n \"docContent\": \"string\",\n \"wordCount\": 12,\n \"personalUser\": \"/api/v1/users/1\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/merge-patch+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://app.orgo.space/api/v1/drives/{id}/share")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/merge-patch+json")
.body("{\n \"title\": \"Volunteer Coordinator\",\n \"owner\": \"/api/v1/users/1\",\n \"unit\": \"/api/v1/units/1\",\n \"isTenantFeatured\": true,\n \"parent\": \"/api/v1/drives/1\",\n \"type\": \"MEMBER\",\n \"docContent\": \"string\",\n \"wordCount\": 12,\n \"personalUser\": \"/api/v1/users/1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/drives/{id}/share")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/merge-patch+json'
request.body = "{\n \"title\": \"Volunteer Coordinator\",\n \"owner\": \"/api/v1/users/1\",\n \"unit\": \"/api/v1/units/1\",\n \"isTenantFeatured\": true,\n \"parent\": \"/api/v1/drives/1\",\n \"type\": \"MEMBER\",\n \"docContent\": \"string\",\n \"wordCount\": 12,\n \"personalUser\": \"/api/v1/users/1\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"title": "Volunteer Coordinator",
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"owner": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"media": {
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
},
"unit": {
"id": 42,
"name": "Boston Chapter"
},
"isTenantFeatured": true,
"parent": "/api/v1/drives/1",
"type": "MEMBER",
"docContent": "string",
"wordCount": 12,
"personalUser": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"slugGo": "agm26",
"publicShareExpiresAt": "2026-01-15T10:30:00+00:00"
}Publish a public share link for a drive file
Generates a unique short slug, creates a 1-year pre-signed S3 URL for the underlying media, and publishes an HTML redirect page to the go.orgo.space bucket. Returns the drive with slugGo and publicShareExpiresAt populated. Only the file owner can share, and only files with attached media are shareable.
curl --request PATCH \
--url https://app.orgo.space/api/v1/drives/{id}/share \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/merge-patch+json' \
--data '
{
"title": "Volunteer Coordinator",
"owner": "/api/v1/users/1",
"unit": "/api/v1/units/1",
"isTenantFeatured": true,
"parent": "/api/v1/drives/1",
"type": "MEMBER",
"docContent": "string",
"wordCount": 12,
"personalUser": "/api/v1/users/1"
}
'import requests
url = "https://app.orgo.space/api/v1/drives/{id}/share"
payload = {
"title": "Volunteer Coordinator",
"owner": "/api/v1/users/1",
"unit": "/api/v1/units/1",
"isTenantFeatured": True,
"parent": "/api/v1/drives/1",
"type": "MEMBER",
"docContent": "string",
"wordCount": 12,
"personalUser": "/api/v1/users/1"
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/merge-patch+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/merge-patch+json'},
body: JSON.stringify({
title: 'Volunteer Coordinator',
owner: '/api/v1/users/1',
unit: '/api/v1/units/1',
isTenantFeatured: true,
parent: '/api/v1/drives/1',
type: 'MEMBER',
docContent: 'string',
wordCount: 12,
personalUser: '/api/v1/users/1'
})
};
fetch('https://app.orgo.space/api/v1/drives/{id}/share', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/drives/{id}/share",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Volunteer Coordinator',
'owner' => '/api/v1/users/1',
'unit' => '/api/v1/units/1',
'isTenantFeatured' => true,
'parent' => '/api/v1/drives/1',
'type' => 'MEMBER',
'docContent' => 'string',
'wordCount' => 12,
'personalUser' => '/api/v1/users/1'
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/merge-patch+json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/drives/{id}/share"
payload := strings.NewReader("{\n \"title\": \"Volunteer Coordinator\",\n \"owner\": \"/api/v1/users/1\",\n \"unit\": \"/api/v1/units/1\",\n \"isTenantFeatured\": true,\n \"parent\": \"/api/v1/drives/1\",\n \"type\": \"MEMBER\",\n \"docContent\": \"string\",\n \"wordCount\": 12,\n \"personalUser\": \"/api/v1/users/1\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/merge-patch+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://app.orgo.space/api/v1/drives/{id}/share")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/merge-patch+json")
.body("{\n \"title\": \"Volunteer Coordinator\",\n \"owner\": \"/api/v1/users/1\",\n \"unit\": \"/api/v1/units/1\",\n \"isTenantFeatured\": true,\n \"parent\": \"/api/v1/drives/1\",\n \"type\": \"MEMBER\",\n \"docContent\": \"string\",\n \"wordCount\": 12,\n \"personalUser\": \"/api/v1/users/1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/drives/{id}/share")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/merge-patch+json'
request.body = "{\n \"title\": \"Volunteer Coordinator\",\n \"owner\": \"/api/v1/users/1\",\n \"unit\": \"/api/v1/units/1\",\n \"isTenantFeatured\": true,\n \"parent\": \"/api/v1/drives/1\",\n \"type\": \"MEMBER\",\n \"docContent\": \"string\",\n \"wordCount\": 12,\n \"personalUser\": \"/api/v1/users/1\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"title": "Volunteer Coordinator",
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"owner": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"media": {
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
},
"unit": {
"id": 42,
"name": "Boston Chapter"
},
"isTenantFeatured": true,
"parent": "/api/v1/drives/1",
"type": "MEMBER",
"docContent": "string",
"wordCount": 12,
"personalUser": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"slugGo": "agm26",
"publicShareExpiresAt": "2026-01-15T10:30:00+00:00"
}Authorizations
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Path Parameters
Drive identifier
Body
The updated Drive resource
"/api/v1/users/1"
"/api/v1/units/1"
"/api/v1/users/1"
Response
Drive resource updated
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

