# 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 > 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\ > \ > \`\`\`bash\ > curl \\\ > -H "Authorization: Bearer YOUR\_API\_KEY"\ > \`\`\`
````json {"openapi":"3.0.3","info":{"title":"Saber Platform API","version":"1.0.0"},"tags":[{"name":"Organisation","description":"## Organisation\n\nRead and update your organisation's profile data: name, website, and description fields\n(general overview, products, use cases, value proposition).\n\nThis endpoint is designed for use with the Saber CLI and MCP server so that tools like\nClaude Code can automatically pull in your organisation context and use it when generating\noutreach, research summaries, or signal queries — without requiring manual copy-paste.\n"}],"servers":[{"url":"https://api.saber.app","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication using Bearer token. Format: sk_live_ followed by a secure random string."}},"schemas":{"Organisation":{"type":"object","description":"Organisation profile","required":["name","website","description"],"properties":{"name":{"type":"string","description":"Display name of the organisation"},"website":{"type":"string","description":"Organisation website domain"},"description":{"$ref":"#/components/schemas/OrganisationDescription"}}},"OrganisationDescription":{"type":"object","description":"Descriptive text fields for the organisation","properties":{"general":{"type":"string","description":"General overview of the organisation"},"products":{"type":"string","description":"Description of the organisation's products or services"},"useCases":{"type":"string","description":"Key use cases the organisation addresses"},"valueProp":{"type":"string","description":"The organisation's core value proposition"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"array","description":"Additional error details (optional)","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"required":["error","message"]}}},"paths":{"/v1/organisation":{"get":{"summary":"Get your organisation profile","description":"Returns the authenticated organisation's profile data: name, website, and description fields.\n\nThis endpoint is primarily intended for use with the Saber CLI and MCP server — allowing\ntools like Claude Code to automatically pull in your organisation context (products, use cases,\nvalue proposition) without manual copy-paste.\n\n---\n\n## Example\n\n```bash\ncurl https://api.saber.app/v1/organisation \\\n -H \"Authorization: Bearer YOUR_API_KEY\"\n```\n","operationId":"getOrganisation","tags":["Organisation"],"responses":{"200":{"description":"Organisation profile retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organisation"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ```` ## 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\ > \ > \`\`\`bash\ > curl -X PUT \\\ > -H "Authorization: Bearer YOUR\_API\_KEY" \\\ > -H "Content-Type: application/json" \\\ > -d '{"description": {"general": "Updated company overview."}}'\ > \`\`\`
````json {"openapi":"3.0.3","info":{"title":"Saber Platform API","version":"1.0.0"},"tags":[{"name":"Organisation","description":"## Organisation\n\nRead and update your organisation's profile data: name, website, and description fields\n(general overview, products, use cases, value proposition).\n\nThis endpoint is designed for use with the Saber CLI and MCP server so that tools like\nClaude Code can automatically pull in your organisation context and use it when generating\noutreach, research summaries, or signal queries — without requiring manual copy-paste.\n"}],"servers":[{"url":"https://api.saber.app","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication using Bearer token. Format: sk_live_ followed by a secure random string."}},"schemas":{"UpdateOrganisationRequest":{"type":"object","description":"Fields to update on the organisation profile. All fields are optional.","properties":{"name":{"type":"string","description":"New display name for the organisation"},"website":{"type":"string","description":"New website domain for the organisation"},"description":{"$ref":"#/components/schemas/OrganisationDescription"}}},"OrganisationDescription":{"type":"object","description":"Descriptive text fields for the organisation","properties":{"general":{"type":"string","description":"General overview of the organisation"},"products":{"type":"string","description":"Description of the organisation's products or services"},"useCases":{"type":"string","description":"Key use cases the organisation addresses"},"valueProp":{"type":"string","description":"The organisation's core value proposition"}}},"Organisation":{"type":"object","description":"Organisation profile","required":["name","website","description"],"properties":{"name":{"type":"string","description":"Display name of the organisation"},"website":{"type":"string","description":"Organisation website domain"},"description":{"$ref":"#/components/schemas/OrganisationDescription"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"array","description":"Additional error details (optional)","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"required":["error","message"]}}},"paths":{"/v1/organisation":{"put":{"summary":"Update your organisation profile","description":"Partially updates the authenticated organisation's profile. All fields are optional — only\nthe fields you include will be updated. Omitted fields are left unchanged.\n\nDescription sub-fields (`general`, `products`, `useCases`, `valueProp`) can also be updated\nindividually — sending only `description.general` will not affect the other description fields.\n\n---\n\n## Example\n\n```bash\ncurl -X PUT https://api.saber.app/v1/organisation \\\n -H \"Authorization: Bearer YOUR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"description\": {\"general\": \"Updated company overview.\"}}'\n```\n","operationId":"updateOrganisation","tags":["Organisation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrganisationRequest"}}}},"responses":{"200":{"description":"Organisation profile updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organisation"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable Entity - Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ````