Organisation

Organisation

Read and update your organisation's profile data: name, website, and description fields (general overview, products, use cases, value proposition).

This endpoint is designed for use with the Saber CLI and MCP server so that tools like Claude Code can automatically pull in your organisation context and use it when generating outreach, research summaries, or signal queries — without requiring manual copy-paste.

Get your organisation profile

get

Returns the authenticated organisation's profile data: name, website, and description fields.

This endpoint is primarily intended for use with the Saber CLI and MCP server — allowing tools like Claude Code to automatically pull in your organisation context (products, use cases, value proposition) without manual copy-paste.

---

Example

curl https://api.saber.app/v1/organisation \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Responses

200

Organisation profile retrieved successfully

application/json

Organisation profile

namestringRequired

Display name of the organisation

Example: Acme Corp

websitestringRequired

Organisation website domain

Example: acme.com

401

Unauthorized - Invalid or missing API key

application/json

500

Internal Server Error

application/json

get

/v1/organisation

HTTPcURLJavaScriptPython

GET /v1/organisation HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "name": "Acme Corp",
  "website": "acme.com",
  "description": {
    "general": "Acme Corp builds enterprise software for logistics teams.",
    "products": "Route optimisation platform and real-time freight tracking.",
    "useCases": "Reducing delivery costs for 3PL operators and e-commerce brands.",
    "valueProp": "Cut logistics costs by 20% with AI-powered route optimisation."
  }
}

Update your organisation profile

put

Partially updates the authenticated organisation's profile. All fields are optional — only the fields you include will be updated. Omitted fields are left unchanged.

Description sub-fields (general, products, useCases, valueProp) can also be updated individually — sending only description.general will not affect the other description fields.

---

Example

curl -X PUT https://api.saber.app/v1/organisation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": {"general": "Updated company overview."}}'

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Body

application/json

Fields to update on the organisation profile. All fields are optional.

namestringOptional

New display name for the organisation

Example: Acme Corp

websitestringOptional

New website domain for the organisation

Example: acme.com

Responses

200

Organisation profile updated successfully

application/json

Organisation profile

namestringRequired

Display name of the organisation

Example: Acme Corp

websitestringRequired

Organisation website domain

Example: acme.com

401

Unauthorized - Invalid or missing API key

application/json

422

Unprocessable Entity - Validation error

application/json

500

Internal Server Error

application/json

put

/v1/organisation

HTTPcURLJavaScriptPython

PUT /v1/organisation HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "name": "New Company Name"
}

Update only the organisation nameUpdate a single description sub-fieldUpdate multiple fields at once

{
  "name": "Acme Corp",
  "website": "acme.com",
  "description": {
    "general": "Acme Corp builds enterprise software for logistics teams.",
    "products": "Route optimisation platform and real-time freight tracking.",
    "useCases": "Reducing delivery costs for 3PL operators and e-commerce brands.",
    "valueProp": "Cut logistics costs by 20% with AI-powered route optimisation."
  }
}