PATCH
/
v1
/
organizations
/
{id}
package main

import(
	"context"
	"os"
	polargo "github.com/polarsource/polar-go"
	"github.com/polarsource/polar-go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := polargo.New(
        polargo.WithSecurity(os.Getenv("POLAR_ACCESS_TOKEN")),
    )

    res, err := s.Organizations.Update(ctx, "1dbfc517-0bbf-4301-9ba8-555ca42b9737", components.OrganizationUpdate{})
    if err != nil {
        log.Fatal(err)
    }
    if res.Organization != nil {
        // handle response
    }
}
{
  "created_at": "2023-11-07T05:31:56Z",
  "modified_at": "2023-11-07T05:31:56Z",
  "id": "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
  "name": "<string>",
  "slug": "<string>",
  "avatar_url": "<string>",
  "email": "<string>",
  "website": "<string>",
  "socials": [
    {
      "platform": "x",
      "url": "<string>"
    }
  ],
  "details_submitted_at": "2023-11-07T05:31:56Z",
  "feature_settings": {
    "issue_funding_enabled": false
  },
  "subscription_settings": {
    "allow_multiple_subscriptions": true,
    "allow_customer_updates": true,
    "proration_behavior": "invoice"
  },
  "bio": "<string>",
  "company": "<string>",
  "blog": "<string>",
  "location": "<string>",
  "twitter_username": "<string>",
  "pledge_minimum_amount": 123,
  "pledge_badge_show_amount": true,
  "default_upfront_split_to_contributors": 123,
  "profile_settings": {
    "enabled": true,
    "description": "<string>",
    "featured_projects": [
      "<string>"
    ],
    "featured_organizations": [
      "<string>"
    ],
    "links": [
      "<string>"
    ],
    "subscribe": {
      "promote": true,
      "show_count": true,
      "count_free": true
    },
    "accent_color": "<string>"
  }
}

Authorizations

Authorization
string
header
required

You can generate an Organization Access Token from your organization's settings.

Path Parameters

id
string
required

The organization ID.

Example:

"1dbfc517-0bbf-4301-9ba8-555ca42b9737"

Body

application/json
name
string | null
Minimum length: 3
avatar_url
string | null
Required string length: 1 - 2083
email
string | null

Public support email.

website
string | null

Official website of the organization.

socials
object[] | null

Links to social profiles.

details
object | null

Additional, private, business details Polar needs about active organizations for compliance (KYC).

feature_settings
object | null
subscription_settings
object | null
default_upfront_split_to_contributors
integer | null
deprecated
Required range: 0 <= x <= 100
pledge_badge_show_amount
boolean
default:false
deprecated
billing_email
string | null
deprecated
default_badge_custom_content
string | null
deprecated
pledge_minimum_amount
integer
default:2000
deprecated
total_monthly_spending_limit
integer | null
deprecated
per_user_monthly_spending_limit
integer | null
deprecated
profile_settings
object | null
deprecated

Response

200
application/json
Organization updated.
created_at
string
required

Creation timestamp of the object.

modified_at
string | null
required

Last modification timestamp of the object.

id
string
required

The organization ID.

Example:

"1dbfc517-0bbf-4301-9ba8-555ca42b9737"

name
string
required

Organization name shown in checkout, customer portal, emails etc.

slug
string
required

Unique organization slug in checkout, customer portal and credit card statements.

avatar_url
string | null
required

Avatar URL shown in checkout, customer portal, emails etc.

email
string | null
required

Public support email.

website
string | null
required

Official website of the organization.

socials
object[]
required

Links to social profiles.

details_submitted_at
string | null
required

When the business details were submitted.

feature_settings
object | null
required

Organization feature settings

subscription_settings
object
required

Settings related to subscriptions management

bio
string | null
required
deprecated
company
string | null
required
deprecated
blog
string | null
required
deprecated
location
string | null
required
deprecated
twitter_username
string | null
required
deprecated
pledge_minimum_amount
integer
required
deprecated
pledge_badge_show_amount
boolean
required
deprecated
default_upfront_split_to_contributors
integer | null
required
deprecated
profile_settings
object | null
required
deprecated

Settings for the organization profile