OpenapiCaptable
Removes one of the caller org's share certificates, taking its shares out of…
Removes one of the caller org's share certificates, taking its shares out of the cap table's outstanding and fully-diluted counts.
DELETE /v1/captable/shares/{id}
| Address | https://api.hanzo.ai/v1/captable/shares/{id} |
| Method | DELETE |
| Operation | delete_captable_shares_by_id |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Removes one of the caller org's share certificates, taking its shares out of the cap table's outstanding and fully-diluted counts. An id this org does not hold is not found.
Request
1 field.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | ID is the share certificate to delete. |
Response
| Status | Body | Meaning |
|---|---|---|
200 | captableDeleted | ok |
200 body — 1 field.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
success | body | boolean | — | Success is true when the row was removed. |
Failure carries the platform error shape — see Errors.
Examples
hanzo captable shares rm <id>import { Configuration, CaptableApi } from 'hanzoai';
const api = new CaptableApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.deleteCaptableSharesById({ id: 'id' });from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import CaptableApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = CaptableApi(client).delete_captable_shares_by_id(id='id')cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.CaptableAPI.DeleteCaptableSharesById(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::apis::{configuration::Configuration, captable_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = captable_api::delete_captable_shares_by_id(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.CaptableApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new CaptableApi(client).deleteCaptableSharesById();curl -X DELETE https://api.hanzo.ai/v1/captable/shares/<id> \
-H "Authorization: Bearer $HANZO_API_KEY"The door reaches captable through the captable tool, which names its 31 operations with its own verbs — this one among them, under a name only the door declares. describe explains any of them:
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "describe",
"arguments": {
"op": "list_captable_classes"
}
}
}'How is this guide?