PostHog Organizations API
The organizations API from PostHog — 5 operation(s) for organizations.
The organizations API from PostHog — 5 operation(s) for organizations.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/posthog-organizations-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: PostHog Organizations API
version: 1.0.0
description: ''
tags:
- name: Organizations
paths:
/api/organizations/{organization_id}/integrations/:
get:
operationId: org_organizations_integrations_list
description: 'ViewSet for organization-level integrations.
Provides access to integrations that are scoped to the entire organization
(vs. project-level integrations). Examples include Vercel, AWS Marketplace, etc.
Creation is handled by the integration installation flows
(e.g., Vercel marketplace installation). Users can disconnect integrations
via the DELETE endpoint.'
parameters:
- name: limit
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- name: offset
required: false
in: query
description: The initial index from which to return the results.
schema:
type: integer
- $ref: '#/components/parameters/OrganizationIdPath'
tags:
- Organizations
security:
- PersonalAPIKeyAuth:
- organization_integration:read
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedOrganizationIntegrationList'
description: ''
x-explicit-tags:
- organizations
deprecated: true
summary: Org organizations integrations list
x-summary-source: derived
/api/organizations/{organization_id}/integrations/{id}/:
get:
operationId: org_organizations_integrations_retrieve
description: 'ViewSet for organization-level integrations.
Provides access to integrations that are scoped to the entire organization
(vs. project-level integrations). Examples include Vercel, AWS Marketplace, etc.
Creation is handled by the integration installation flows
(e.g., Vercel marketplace installation). Users can disconnect integrations
via the DELETE endpoint.'
parameters:
- in: path
name: id
schema:
type: string
format: uuid
description: A UUID string identifying this organization integration.
required: true
- $ref: '#/components/parameters/OrganizationIdPath'
tags:
- Organizations
security:
- PersonalAPIKeyAuth:
- organization_integration:read
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/OrganizationIntegration'
description: ''
x-explicit-tags:
- organizations
deprecated: true
summary: Org organizations integrations retrieve
x-summary-source: derived
delete:
operationId: org_organization_integrations_destroy
description: 'ViewSet for organization-level integrations.
Provides access to integrations that are scoped to the entire organization
(vs. project-level integrations). Examples include Vercel, AWS Marketplace, etc.
Creation is handled by the integration installation flows
(e.g., Vercel marketplace installation). Users can disconnect integrations
via the DELETE endpoint.'
parameters:
- in: path
name: id
schema:
type: string
format: uuid
description: A UUID string identifying this organization integration.
required: true
- $ref: '#/components/parameters/OrganizationIdPath'
tags:
- Organizations
security:
- PersonalAPIKeyAuth:
- organization_integration:write
responses:
'204':
description: No response body
x-explicit-tags:
- organizations
deprecated: true
summary: Org organization integrations destroy
x-summary-source: derived
/api/organizations/{organization_id}/integrations/{id}/environment-mapping/:
patch:
operationId: integrations_environment_mapping_partial_update
description: 'ViewSet for organization-level integrations.
Provides access to integrations that are scoped to the entire organization
(vs. project-level integrations). Examples include Vercel, AWS Marketplace, etc.
Creation is handled by the integration installation flows
(e.g., Vercel marketplace installation). Users can disconnect integrations
via the DELETE endpoint.'
parameters:
- in: path
name: id
schema:
type: string
format: uuid
description: A UUID string identifying this organization integration.
required: true
- $ref: '#/components/parameters/OrganizationIdPath'
tags:
- Organizations
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PatchedOrganizationIntegration'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/PatchedOrganizationIntegration'
multipart/form-data:
schema:
$ref: '#/components/schemas/PatchedOrganizationIntegration'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/OrganizationIntegration'
description: ''
x-explicit-tags:
- organizations
summary: Integrations environment mapping partial update
x-summary-source: derived
components:
schemas:
OrganizationIntegration:
type: object
description: Serializer for organization-level integrations.
properties:
id:
type: string
format: uuid
readOnly: true
kind:
allOf:
- $ref: '#/components/schemas/OrganizationIntegrationKindEnum'
readOnly: true
integration_id:
type:
- string
- 'null'
readOnly: true
config:
readOnly: true
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: true
created_by:
allOf:
- $ref: '#/components/schemas/UserBasic'
readOnly: true
required:
- config
- created_at
- created_by
- id
- integration_id
- kind
- updated_at
NullEnum:
enum:
- null
UserBasic:
type: object
properties:
id:
type: integer
readOnly: true
uuid:
type: string
format: uuid
readOnly: true
distinct_id:
type:
- string
- 'null'
maxLength: 200
first_name:
type: string
maxLength: 150
last_name:
type: string
maxLength: 150
email:
type: string
format: email
title: Email address
maxLength: 254
is_email_verified:
type:
- boolean
- 'null'
hedgehog_config:
type:
- object
- 'null'
additionalProperties: true
readOnly: true
role_at_organization:
oneOf:
- $ref: '#/components/schemas/RoleAtOrganizationEnum'
- $ref: '#/components/schemas/BlankEnum'
- $ref: '#/components/schemas/NullEnum'
required:
- email
- hedgehog_config
- id
- uuid
OrganizationIntegrationKindEnum:
enum:
- vercel
type: string
description: '* `vercel` - Vercel'
BlankEnum:
enum:
- ''
PaginatedOrganizationIntegrationList:
type: object
required:
- count
- results
properties:
count:
type: integer
example: 123
next:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?offset=400&limit=100
previous:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?offset=200&limit=100
results:
type: array
items:
$ref: '#/components/schemas/OrganizationIntegration'
PatchedOrganizationIntegration:
type: object
description: Serializer for organization-level integrations.
properties:
id:
type: string
format: uuid
readOnly: true
kind:
allOf:
- $ref: '#/components/schemas/OrganizationIntegrationKindEnum'
readOnly: true
integration_id:
type:
- string
- 'null'
readOnly: true
config:
readOnly: true
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: true
created_by:
allOf:
- $ref: '#/components/schemas/UserBasic'
readOnly: true
RoleAtOrganizationEnum:
enum:
- engineering
- data
- product
- founder
- leadership
- marketing
- sales
- other
type: string
description: '* `engineering` - Engineering
* `data` - Data
* `product` - Product Management
* `founder` - Founder
* `leadership` - Leadership
* `marketing` - Marketing
* `sales` - Sales / Success
* `other` - Other'
parameters:
OrganizationIdPath:
in: path
name: organization_id
required: true
schema:
type: string
description: ID of the organization you're trying to access. To find the ID of the organization, make a call to /api/organizations/.
securitySchemes:
PersonalAPIKeyAuth:
type: http
scheme: bearer
x-tagGroups:
- name: All endpoints
tags:
- LLM Analytics
- actions
- activity_log
- activity_logs
- advanced_activity_logs
- alerts
- annotations
- approval_policies
- batch_exports
- cdp
- change_requests
- code
- code-invites
- cohorts
- comments
- conversations
- core
- customer_analytics
- customer_journeys
- customer_profile_configs
- dashboard_templates
- dashboards
- data_color_themes
- data_modeling_jobs
- data_warehouse
- dataset_items
- datasets
- desktop_recordings
- domains
- early_access_feature
- early_access_features
- elements
- endpoints
- environments
- error_tracking
- evaluation_runs
- evaluations
- event_definitions
- event_filter
- event_schemas
- events
- experiment_holdouts
- experiment_saved_metrics
- experiments
- exports
- external_data_schemas
- external_data_sources
- feature_flags
- file_system
- file_system_shortcut
- flag_value
- groups
- groups_types
- health_issues
- heatmap_screenshots
- heatmaps
- hog_flows
- hog_function_templates
- hog_functions
- insight_variables
- insights
- integrations
- invites
- js-snippet
- legal_documents
- lineage
- live_debugger_breakpoints
- llm_analytics
- llm_prompts
- llm_skills
- logs
- managed_viewsets
- max
- max_tools
- mcp_server_installations
- mcp_servers
- mcp_store
- mcp_tools
- members
- notebooks
- oauth_applications
- object_media_previews
- organizations
- persisted_folder
- persons
- platform_features
- plugin_configs
- product_analytics
- product_tours
- project_secret_api_keys
- projects
- property_definitions
- proxy_records
- public_hog_function_templates
- query
- replay
- reverse_proxy
- role_external_references
- roles
- sandbox-environments
- sandbox_environments
- saved
- schema_property_groups
- sdk_doctor
- session_group_summaries
- session_recording_playlists
- session_recordings
- session_summaries
- sessions
- signals
- subscriptions
- surveys
- taggers
- task-automations
- task-runs
- task_automations
- tasks
- uploaded_media
- user_home_settings
- user_interviews
- users
- visual_review
- warehouse_dag
- warehouse_model_paths
- warehouse_saved_queries
- warehouse_saved_query_folders
- warehouse_tables
- warehouse_view_link
- warehouse_view_links
- web_analytics
- web_experiments
- web_vitals
- welcome
- workflows