---
title: "Create an organization."
method: POST
path: "/organizations"
tags: ["organizations"]
---

# Create an organization.

`POST /organizations`

Create an organization. Organization requires approval by an admin before being made public.

## Request body

- Organization
  - `aliases` object
  - `avatarUrl` string
  - `categorizer` boolean
  - `collectionsLength` integer
  - `dbCreateDate` integer
  - `dbUpdateDate` integer
  - `description` string
  - `displayName` string
  - `email` string
  - `id` integer
  - `link` string
  - `location` string
  - `name` string
  - `starredUsers` User[]
    - `avatarUrl` string
    - `curator` boolean — Indicates whether this user is a curator. The value is always false unless requested for oneself or by an admin
    - `id` integer
    - `isAdmin` boolean — Indicates whether the user is an admin. The value is always false unless requested for oneself or by an admin
    - `metricsRobot` boolean
    - `metricsRobotPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this user is a robot that submits metrics
    - `name` string
    - `orcid` string
    - `platformPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this account corresponds to a platform partner
    - `privacyPolicyVersion` 'NONE' | 'PRIVACY_POLICY_VERSION_2_5'
    - `privacyPolicyVersionAcceptanceDate` integer
    - `setupComplete` boolean
    - `tosacceptanceDate` integer
    - `tosversion` 'NONE' | 'TOS_VERSION_1' | 'TOS_VERSION_2'
    - `tosversionAcceptanceDate` integer
    - `userProfiles` object
    - `username` string
    - `usernameChangeRequired` boolean — Indicates whether the user is required to change their username before being allowed to do various operations on Dockstore.
  - `status` 'PENDING' | 'REJECTED' | 'APPROVED' | 'HIDDEN'
  - `topic` string
  - `users` OrganizationUser[]
    - `dbCreateDate` integer
    - `dbUpdateDate` integer
    - `id` OrganizationUserId
      - `organizationId` integer
      - `userId` integer
    - `organization` Organization — recursive
    - `role` 'ADMIN' | 'MAINTAINER' | 'MEMBER'
    - `status` 'PENDING' | 'REJECTED' | 'ACCEPTED', required — The status of the organization invitation
    - `user` User
      - `avatarUrl` string
      - `curator` boolean — Indicates whether this user is a curator. The value is always false unless requested for oneself or by an admin
      - `id` integer
      - `isAdmin` boolean — Indicates whether the user is an admin. The value is always false unless requested for oneself or by an admin
      - `metricsRobot` boolean
      - `metricsRobotPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this user is a robot that submits metrics
      - `name` string
      - `orcid` string
      - `platformPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this account corresponds to a platform partner
      - `privacyPolicyVersion` 'NONE' | 'PRIVACY_POLICY_VERSION_2_5'
      - `privacyPolicyVersionAcceptanceDate` integer
      - `setupComplete` boolean
      - `tosacceptanceDate` integer
      - `tosversion` 'NONE' | 'TOS_VERSION_1' | 'TOS_VERSION_2'
      - `tosversionAcceptanceDate` integer
      - `userProfiles` object
      - `username` string
      - `usernameChangeRequired` boolean — Indicates whether the user is required to change their username before being allowed to do various operations on Dockstore.

## Response `default`

default response

- Organization
  - `aliases` object
  - `avatarUrl` string
  - `categorizer` boolean
  - `collectionsLength` integer
  - `dbCreateDate` integer
  - `dbUpdateDate` integer
  - `description` string
  - `displayName` string
  - `email` string
  - `id` integer
  - `link` string
  - `location` string
  - `name` string
  - `starredUsers` User[]
    - `avatarUrl` string
    - `curator` boolean — Indicates whether this user is a curator. The value is always false unless requested for oneself or by an admin
    - `id` integer
    - `isAdmin` boolean — Indicates whether the user is an admin. The value is always false unless requested for oneself or by an admin
    - `metricsRobot` boolean
    - `metricsRobotPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this user is a robot that submits metrics
    - `name` string
    - `orcid` string
    - `platformPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this account corresponds to a platform partner
    - `privacyPolicyVersion` 'NONE' | 'PRIVACY_POLICY_VERSION_2_5'
    - `privacyPolicyVersionAcceptanceDate` integer
    - `setupComplete` boolean
    - `tosacceptanceDate` integer
    - `tosversion` 'NONE' | 'TOS_VERSION_1' | 'TOS_VERSION_2'
    - `tosversionAcceptanceDate` integer
    - `userProfiles` object
    - `username` string
    - `usernameChangeRequired` boolean — Indicates whether the user is required to change their username before being allowed to do various operations on Dockstore.
  - `status` 'PENDING' | 'REJECTED' | 'APPROVED' | 'HIDDEN'
  - `topic` string
  - `users` OrganizationUser[]
    - `dbCreateDate` integer
    - `dbUpdateDate` integer
    - `id` OrganizationUserId
      - `organizationId` integer
      - `userId` integer
    - `organization` Organization — recursive
    - `role` 'ADMIN' | 'MAINTAINER' | 'MEMBER'
    - `status` 'PENDING' | 'REJECTED' | 'ACCEPTED', required — The status of the organization invitation
    - `user` User
      - `avatarUrl` string
      - `curator` boolean — Indicates whether this user is a curator. The value is always false unless requested for oneself or by an admin
      - `id` integer
      - `isAdmin` boolean — Indicates whether the user is an admin. The value is always false unless requested for oneself or by an admin
      - `metricsRobot` boolean
      - `metricsRobotPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this user is a robot that submits metrics
      - `name` string
      - `orcid` string
      - `platformPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this account corresponds to a platform partner
      - `privacyPolicyVersion` 'NONE' | 'PRIVACY_POLICY_VERSION_2_5'
      - `privacyPolicyVersionAcceptanceDate` integer
      - `setupComplete` boolean
      - `tosacceptanceDate` integer
      - `tosversion` 'NONE' | 'TOS_VERSION_1' | 'TOS_VERSION_2'
      - `tosversionAcceptanceDate` integer
      - `userProfiles` object
      - `username` string
      - `usernameChangeRequired` boolean — Indicates whether the user is required to change their username before being allowed to do various operations on Dockstore.

## Changes

- **2026-04-02** `8f48f927f91e` — 1 warning
  - the `topic` request property's maxLength was set to `255`
- **2025-05-05** `7a89c3c933f1` — 1 breaking
  - the `topic` response property's maxLength was unset from `255` for the response status `default`

[Change history](https://skmtc.dev/dockstore/apis/dockstore-api/changes/organizations/post.md)

---

[API](https://skmtc.dev/dockstore/apis/dockstore-api.md) · [All operations](https://skmtc.dev/dockstore/apis/dockstore-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dockstore/dockstore-api/revisions/9d82a4e96aa7/schema)