Organizations

Organizations are the top-level ownership boundary in CodePushGo. They group React Native apps, API keys, team members, billing settings, and plan intent under one account.

Admin API requests use:

Authorization: Bearer <CODEPUSHGO_API_KEY>

Base URL:

https://api.codepushgo.com

GET /organization/

Retrieve organizations available to the API key. Pass orgId to fetch one organization.

curl -H "Authorization: Bearer $CODEPUSHGO_API_KEY" \
  https://api.codepushgo.com/organization/

curl -H "Authorization: Bearer $CODEPUSHGO_API_KEY" \
  "https://api.codepushgo.com/organization/?orgId=org_123"

Response shape:

interface Organization {
  id: string
  created_by: string
  created_at: string
  updated_at: string
  logo: string | null
  name: string
  management_email: string | null
  customer_id: string | null
}

POST /organization/

Create a new organization.

curl -X POST \
  -H "Authorization: Bearer $CODEPUSHGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Mobile Team" }' \
  https://api.codepushgo.com/organization/

PUT /organization/

Update organization metadata. Requires an admin API key for the organization.

curl -X PUT \
  -H "Authorization: Bearer $CODEPUSHGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "name": "Mobile Platform",
    "management_email": "mobile@example.com"
  }' \
  https://api.codepushgo.com/organization/

DELETE /organization/

Delete an organization. This is destructive and removes associated app ownership data.

curl -X DELETE \
  -H "Authorization: Bearer $CODEPUSHGO_API_KEY" \
  "https://api.codepushgo.com/organization/?orgId=org_123"

Best Practices

• Use one organization for each billing and team ownership boundary.
• Use a group email for management_email so access is not tied to one person.
• Create scoped API keys for CI instead of sharing personal keys.
• Keep app ids as the native React Native bundle ids, for example com.company.app.