Organization
Get your organisation profile
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 AI coding assistants 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"Authorization
ApiKeyAuth API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/organisation"{ "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." }}{ "error": { "type": "VALIDATION", "code": "VALIDATION_ERROR", "message": "validation failed for 'departments': invalid value: Engineering Ops", "errorCode": "string", "errorAction": "string", "details": {}, "requestId": "e69ed773-2674-4dca-be61-886d6698f360", "fields": [ { "field": "domain", "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path" } ], "debug": { "cause": "string" } }}{ "error": { "type": "VALIDATION", "code": "VALIDATION_ERROR", "message": "validation failed for 'departments': invalid value: Engineering Ops", "errorCode": "string", "errorAction": "string", "details": {}, "requestId": "e69ed773-2674-4dca-be61-886d6698f360", "fields": [ { "field": "domain", "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path" } ], "debug": { "cause": "string" } }}Update your organisation profile
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."}}'Authorization
ApiKeyAuth API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
New display name for the organisation
New website domain for the organisation
Descriptive text fields for the organisation
Response Body
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/organisation" \ -H "Content-Type: application/json" \ -d '{ "name": "New Company Name" }'{ "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." }}{ "error": { "type": "VALIDATION", "code": "VALIDATION_ERROR", "message": "validation failed for 'departments': invalid value: Engineering Ops", "errorCode": "string", "errorAction": "string", "details": {}, "requestId": "e69ed773-2674-4dca-be61-886d6698f360", "fields": [ { "field": "domain", "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path" } ], "debug": { "cause": "string" } }}{ "error": { "type": "VALIDATION", "code": "VALIDATION_ERROR", "message": "validation failed for 'departments': invalid value: Engineering Ops", "errorCode": "string", "errorAction": "string", "details": {}, "requestId": "e69ed773-2674-4dca-be61-886d6698f360", "fields": [ { "field": "domain", "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path" } ], "debug": { "cause": "string" } }}{ "error": { "type": "VALIDATION", "code": "VALIDATION_ERROR", "message": "validation failed for 'departments': invalid value: Engineering Ops", "errorCode": "string", "errorAction": "string", "details": {}, "requestId": "e69ed773-2674-4dca-be61-886d6698f360", "fields": [ { "field": "domain", "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path" } ], "debug": { "cause": "string" } }}